Dan, Lex, Thanks much for the confirmation that this is evidently an issue with Asciidoc itself. It sounds like the only current workaround is to install and use Asciidoctor instead.
Is there any possibility that Asciidoc itself might be updated with the "preface-title" approach Dan mentions, in the near future? Regards, Kurt Callaway Houston, Texas On Friday, May 22, 2015 at 7:38:38 PM UTC-5, Lex Trotman wrote: > > > > On 23 May 2015 at 08:49, Dan Allen <[email protected] <javascript:>> > 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.
