On 01/03/12 11:57, Andrew Beekhof wrote:
A user has reported the following error with my asciidoc text:
https://github.com/ClusterLabs/pacemaker/pull/33
Essentially he is getting:
|bash-3.2$ asciidoc -b docbook -d book -o Ap-Corosync-Conf.docbook
Ap-Corosync-Conf.txt
asciidoc: WARNING: Ap-Corosync-Conf.txt: line 5: missing style:
[blockdef-literal]: appendix|
and suggesting:
[appendix]
-= Configuration Recap =
+Configuration Recap
+-------------------
as a fix (citing http://www.methods.co.nz/asciidoc/userguide.html#X93 ).
However http://www.methods.co.nz/asciidoc/userguide.html#X46 seems to suggest
the existing syntax is allowed.
Personally I prefer the inline syntax and so I would like to know if this is a
regression (the same text works fine with asciidoc-8.4.5-6.fc15) or a loophole
that was closed before I apply the patch.
What's happening here is that AsciiDoc does not process and consume attribute
lists ([appendix)) that precede the top level title in the header (it probably
should). This means that the attribute list is applied to the next block element
(the literal block) hence the confusing message.
Lex is correct in that your patch solves the problem by because it pushes the
appendix down one level.
So your patch will work, alternatively you could push all subsequent section
levels down one by inserting this attribute setting at the start of the document:
:leveloffset: 1
See:
http://www.methods.co.nz/asciidoc/userguide.html#X90
Looks like you're compiling the appendices separately to DocBook, editing them
with sed and then combining them using XML xi:include tag (instead of combining
the .txt files and compiling to a single DocBook file).
Cheers, Stuart
-- Andrew
--
You received this message because you are subscribed to the Google Groups
"asciidoc" group.
To view this discussion on the web visit
https://groups.google.com/d/msg/asciidoc/-/6DDNZpwFsKsJ.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/asciidoc?hl=en.
--
You received this message because you are subscribed to the Google Groups
"asciidoc" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/asciidoc?hl=en.
