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

[mojavelinux]

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.

https://github.com/asciidoctor/asciidoctor/issues/1090

-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

... [show rest of quote]

--

Dan Allen | http://google.com/profiles/dan.j.allen