On 30 May 2015 at 10:12, Kurt Callaway <[email protected]> wrote: > 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?
If somebody does it sure :) Cheers Lex > > 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]> 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. -- 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.
