preamble in TOC

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|

preamble in TOC

malan
Hi all,

Per http://www.methods.co.nz/asciidoc/userguide.html#X86, I see that the Preamble is "an optional untitled section body between the document Header and the first Section title." And so it's not surprising that Asciidoc like

= document title

preamble

= section title

yields DocBook (with an untitled preface) like:

<title>document title</title>
<preface>
<title></title>
<simpara>preamble</simpara>
</preface>
<chapter>
<title>section title</title>
...

However, when rendering that DocBook as a PDF in `book` format with a TOC with asciidoctor-fopub, the result is a TOC with an untitled TOC entry (i.e., an entry of just dots):



Is that intended behavior? Is there perhaps an elegant way to avoid that symptom (short of editing the XSL)?

Many thanks!

David
Reply | Threaded
Open this post in threaded view
|

Re: preamble in TOC

mojavelinux
Administrator
This is a bug that was inherited from faithfully implementing the DocBook output in Asciidoc Python. It has long annoyed me too, so I've filed an issue to get it fixed.


-Dan

On Fri, Aug 1, 2014 at 10:59 PM, malan [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hi all,

Per http://www.methods.co.nz/asciidoc/userguide.html#X86, I see that the Preamble is "an optional untitled section body between the document Header and the first Section title." And so it's not surprising that Asciidoc like

= document title

preamble

= section title

yields DocBook (with an untitled preface) like:

<title>document title</title>
<preface>
<title></title>
<simpara>preamble</simpara>
</preface>
<chapter>
<title>section title</title>
...

However, when rendering that DocBook as a PDF in `book` format with a TOC with asciidoctor-fopub, the result is a TOC with an untitled TOC entry (i.e., an entry of just dots):



Is that intended behavior? Is there perhaps an elegant way to avoid that symptom (short of editing the XSL)?

Many thanks!

David


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/preamble-in-TOC-tp1951.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--