Re: [Docutils-users] [brain dump] * * * Unnamed Sections

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

On Sun, 21 Jan 2007, Felix Wiemann wrote:

> David Goodger wrote:
>> [Felix Wiemann]
>>
>>>      \
>>>      =
>>
>> It may not be explicitly defined, but it's a natural consequence of the reST
>> syntax definition.
>
> At some point we might want to throw warnings when backslashes occur at
> the end of parsing blocks for the inline writer [1]_, and then it would
> no longer be supported.
>
> .. [1] Light this.\
>
>> I see no need to go out of our way to remove it.
>
> Agreed.

this input ::

   ===================
    table of contents
   ===================

   .. contents::

   Quick-Start
   ===========

   Test latex table of contents usage.

   Sub section
   -----------

   Needs some content

   \
   =

   empty section title.

   A section
   =========

   Subsection again
   ----------------

   This should do it.

rst2pseudoxml.py ::

   <document ids="table-of-contents" names="table\ of\ contents" 
source="test/toc.txt" title="table of contents">
       <title>
           table of contents
       <topic classes="contents" ids="contents" names="contents">
           <title>
               Contents
           <bullet_list>
               <list_item>
                   <paragraph>
                       <reference ids="id2" refid="id1">
               <list_item>
                   <paragraph>
                       <reference ids="id3" refid="a-section">
                           A section
                   <bullet_list>
                       <list_item>
                           <paragraph>
                               <reference ids="id4" 
refid="subsection-again">
                                   Subsection again
       <section ids="quick-start" names="quick-start">
           <title>
               Quick-Start
           <paragraph>
               Test latex table of contents usage.
           <section ids="sub-section" names="sub\ section">
               <title>
                   Sub section
               <paragraph>
                   Needs some content
       <section ids="id1" names="">
           <title refid="id2">
           <paragraph>
               empty section title.
       <section ids="a-section" names="a\ section">
           <title refid="id3">
               A section
           <section ids="subsection-again" names="subsection\ again">
               <title refid="id4">
                   Subsection again
               <paragraph>
                   This should do it.


section title "Quick-Start" and "Sub section" are missing from the toc

looks like the blank title clears the table of contents ?

cheers

--