Re: [Rest2web-develop] disabling promotion of top-level section to title

[Michael F. <fuz...@vo...>]

Steven Bethard wrote:
> How can I disable the promotion of the top-level section to a title?
> That is, I'm giving rest2html a file like::
>
>   
Currently there is no way to pass options to docutils from individual pages.

At some point I would like to add this.

However... how about this :

If you set an explicit page title, then rest2web will switch off 
promotion to title ?

This sounds fairly logical and should be easy for me to implement.

Fuzzyman


>     restindex
>         crumb: Crumb
>         page-title: My Page Title
>     /restindex
>
>     Header
>     ======
>
>     Sub-section
>     -----------
>
> and rest2html is outputting a document structure like::
>
>     <h1 class="title">Header</h1>
>     <div class="section">
>         <h1>
>             <a id="sub-section" name="sub-section">Sub-section</a>
>         </h1>
>     </div>
>
> Note that the "Header" got interpreted as a "title" and therefore the
> "Sub-section" is still given "h1" instead of "h2".
>
> I gather this is because of docutils, but I couldn't figure out how to
> make rest2html use the appropriate "doctitle_xform" from the Docutils
> Configuration:
>
>     http://docutils.sourceforge.net/docs/user/config.html#configuration-files
>
> I tried putting the following docutils.conf in the directory from
> which I'm running r2w.py and setting the DOCUTILSCONFIG environment
> variable to the same directory, but with no luck::
>
>     [standalone reader]
>     doctitle_xform = 0
>
> Steve
>