Re: [Docutils-users] section numbering: clarification, documentation suggestion

[<gr...@us...>]

On Fri, 13 Oct 2006, David Goodger wrote:

> On 10/12/06, Alan G Isaac <ai...@am...> wrote:
>> This is just a request for clarification and a suggestion.
>> (My memory must be failing me ... )
>>
>> If I include a section-numbering directive,
>> I get section numbering unless I disable it at the command
>> line.  If I do not include it, I do not get it.
>
> That's an over-simplification.
>
>> Clarification: Is that how things always worked?
>
> "Always": no, because the option/setting is more recent than the
> directive, and because you can get section numbering for LaTeX without
> using a directive.
>
> There is a sectnum/section-numbering directive in reST for Docutils to
> generate section numbers. There is an option/setting to disable the
> Docutils-generated section numbering, because LaTeX can generate its
> own section numbering, which would conflict with the Docutils
> numbering (you'll get the numbers twice).
>
>> (It has been a while since I needed section numbers,
>> and I recalled being able to enable them at the command line
>> *without* the directive.)
>
> For LaTeX, perhaps. Not for HTML output or for anything else though.
>
> I don't use LaTeX, and I find the LaTeX writer options/settings
> confusing. I couldn't find a "number the sections please" option for
> rst2latex.py.

it is named --use-latex-toc,

--section-numbering isnt available for writers

this 
http://docutils.sourceforge.net/docs/user/latex.html#section-numbering 
might aid a little too.

cheers

--