* minute suggestion for documentation, chapter 12.5 (export to html)
@ 2013-09-16 11:54 Gijs Hillenius
2013-09-16 12:11 ` Suvayu Ali
0 siblings, 1 reply; 4+ messages in thread
From: Gijs Hillenius @ 2013-09-16 11:54 UTC (permalink / raw)
To: emacs-orgmode
I have a really wee suggestion for a change in the documentation that
comes with Org-mode version 7.9.3f and in Org 8.1 (on the web)
In chapter 12.5 on Html export there is this section
,----
| 12.5.9 CSS support
|
| You can also give style information for the exported file.
`----
To my non-English eyes the word "also" is ambigous. Earlier this month
it made me look all over that chapter for /other/ ways to give style
information.
I think that "also" refers to "12.5.3 Quoting HTML tags" but I am not
sure.
So, maybe the above quoted text for 12.5.9 could be improved by writing:
Next to including simple HTML tags (see 12.5.3), style information can
be added to the exported file.
Feel free to use this, or not.
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: minute suggestion for documentation, chapter 12.5 (export to html)
2013-09-16 11:54 minute suggestion for documentation, chapter 12.5 (export to html) Gijs Hillenius
@ 2013-09-16 12:11 ` Suvayu Ali
2013-09-16 17:50 ` David Rogers
0 siblings, 1 reply; 4+ messages in thread
From: Suvayu Ali @ 2013-09-16 12:11 UTC (permalink / raw)
To: emacs-orgmode
Hello Gijs,
On Mon, Sep 16, 2013 at 01:54:40PM +0200, Gijs Hillenius wrote:
> I have a really wee suggestion for a change in the documentation that
> comes with Org-mode version 7.9.3f and in Org 8.1 (on the web)
>
> In chapter 12.5 on Html export there is this section
>
> ,----
> | 12.5.9 CSS support
> |
> | You can also give style information for the exported file.
> `----
>
> To my non-English eyes the word "also" is ambigous. Earlier this month
> it made me look all over that chapter for /other/ ways to give style
> information.
>
> I think that "also" refers to "12.5.3 Quoting HTML tags" but I am not
> sure.
>
> So, maybe the above quoted text for 12.5.9 could be improved by writing:
>
> Next to including simple HTML tags (see 12.5.3), style information can
> be added to the exported file.
I think also here suggests style information is optional; as in, you may
or may not include it.
Maybe others can chime in with their opinion?
--
Suvayu
Open source is the future. It sets us free.
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: minute suggestion for documentation, chapter 12.5 (export to html)
2013-09-16 12:11 ` Suvayu Ali
@ 2013-09-16 17:50 ` David Rogers
2013-09-17 5:19 ` Carsten Dominik
0 siblings, 1 reply; 4+ messages in thread
From: David Rogers @ 2013-09-16 17:50 UTC (permalink / raw)
To: Suvayu Ali; +Cc: emacs-orgmode
Suvayu Ali <fatkasuvayu+linux@gmail.com> writes:
> Hello Gijs,
>
> On Mon, Sep 16, 2013 at 01:54:40PM +0200, Gijs Hillenius wrote:
>> I have a really wee suggestion for a change in the documentation that
>> comes with Org-mode version 7.9.3f and in Org 8.1 (on the web)
>>
>> In chapter 12.5 on Html export there is this section
>>
>> ,----
>> | 12.5.9 CSS support
>> |
>> | You can also give style information for the exported file.
>> `----
>>
>> To my non-English eyes the word "also" is ambigous. Earlier this month
>> it made me look all over that chapter for /other/ ways to give style
>> information.
>>
>> I think that "also" refers to "12.5.3 Quoting HTML tags" but I am not
>> sure.
>>
>> So, maybe the above quoted text for 12.5.9 could be improved by writing:
>>
>> Next to including simple HTML tags (see 12.5.3), style information can
>> be added to the exported file.
>
> I think also here suggests style information is optional; as in, you may
> or may not include it.
>
> Maybe others can chime in with their opinion?
I think the "also" is not meant to be about "other ways to give style
information", but about "other things you could do that are not the same
as the immediately-preceding item".
Gijs - would it be clearer, in your opinion, to replace the word "also"
with "optionally"?
--
David R
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: minute suggestion for documentation, chapter 12.5 (export to html)
2013-09-16 17:50 ` David Rogers
@ 2013-09-17 5:19 ` Carsten Dominik
0 siblings, 0 replies; 4+ messages in thread
From: Carsten Dominik @ 2013-09-17 5:19 UTC (permalink / raw)
To: David Rogers; +Cc: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 1751 bytes --]
On 16.9.2013, at 19:50, David Rogers <davidandrewrogers@gmail.com> wrote:
> Suvayu Ali <fatkasuvayu+linux@gmail.com> writes:
>
>> Hello Gijs,
>>
>> On Mon, Sep 16, 2013 at 01:54:40PM +0200, Gijs Hillenius wrote:
>>> I have a really wee suggestion for a change in the documentation that
>>> comes with Org-mode version 7.9.3f and in Org 8.1 (on the web)
>>>
>>> In chapter 12.5 on Html export there is this section
>>>
>>> ,----
>>> | 12.5.9 CSS support
>>> |
>>> | You can also give style information for the exported file.
>>> `----
>>>
>>> To my non-English eyes the word "also" is ambigous. Earlier this month
>>> it made me look all over that chapter for /other/ ways to give style
>>> information.
>>>
>>> I think that "also" refers to "12.5.3 Quoting HTML tags" but I am not
>>> sure.
>>>
>>> So, maybe the above quoted text for 12.5.9 could be improved by writing:
>>>
>>> Next to including simple HTML tags (see 12.5.3), style information can
>>> be added to the exported file.
>>
>> I think also here suggests style information is optional; as in, you may
>> or may not include it.
>>
>> Maybe others can chime in with their opinion?
>
> I think the "also" is not meant to be about "other ways to give style
> information", but about "other things you could do that are not the same
> as the immediately-preceding item".
Yes, it was meant to mean something like this. In addition to all the other stuff mentioned before.
I have changed it to
You can modify the CSS style definitions for the exported file.
Hope this is clearer.
- Carsten
>
> Gijs - would it be clearer, in your opinion, to replace the word "also"
> with "optionally"?
>
> --
> David R
>
[-- Attachment #2: Message signed with OpenPGP using GPGMail --]
[-- Type: application/pgp-signature, Size: 455 bytes --]
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2013-09-17 5:19 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-09-16 11:54 minute suggestion for documentation, chapter 12.5 (export to html) Gijs Hillenius
2013-09-16 12:11 ` Suvayu Ali
2013-09-16 17:50 ` David Rogers
2013-09-17 5:19 ` Carsten Dominik
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.