On 23 May 2015 at 08:49, Dan Allen <[email protected]> wrote: > Kurt, > > The blank entry is a reference to the preface (as defined by DocBook; > AsciiDoc calls it the preamble). It's absence is long-standing issue in the > AsciiDoc syntax. Because of the way the processor parses this section of > the document, the preface title never makes it to the right spot. >
I think the problem is that the syntax for the header including preamble is a single entity and so if the usual rules for titles applied an untitled preamble paragraph would get the document title as its title, so asciidoc.py as a special case deletes the title on the preamble, so of course manually applied titles don't get through either. > I addressed this problem in Asciidoctor 1.5.2 by introducing the document > attribute preface-title. The value of this attribute is used to fill in > that empty element. > Sounds like a reasonable pragmatic solution. > > See https://github.com/asciidoctor/asciidoctor/issues/1090 > > We could make the same fix in AsciiDoc Python. > > See the following lines: > > * https://github.com/asciidoc/asciidoc/blob/master/docbook45.conf#L505 > * https://github.com/asciidoc/asciidoc/blob/master/docbook45.conf#L703 > > -Dan > > -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/d/optout.
