... > I'll address a few items I see in comments: > >> Line with unknown attribute must be removed, but it's not. > > This is controlled by a document-level setting in Asciidoctor. We consider > it dangerous to drop lines by default, so we've made the default to show the > missing attribute instead. If you want to restore the old behavior, you set: > > :attribute-undefined: drop-line > > You can also set a value of "skip", "warn" or "drop". For more info, see > http://asciidoctor.org/docs/user-manual/#catch-a-missing-or-undefined-attribute
The behaviour in Asciidoc Python is really an implementation detail of the config files that has leaked into documents and been made official. I think Asciidoctor has the right approach, give the document writer the option to get noisy messages if an attribute is missing rather than silent lossage. The document writer should be explicit that a missing attribute means leave out content using conditional attribute references. ... > Caption isn't used unless the block has a title. I don't know why this works > in AsciiDoc Python, but I consider it to be unspecified behavior. The Asciidoc User guide 15.4.1 implies that you can expect output if you only set a custom caption, but that isn't written specifically anywhere and there is no explicit code to make it work, so its probably as you say a side effect of implementation and so undefined. > >> include\:\: is replaced with link: > > This enables navigation to files on GitHub as a concession for includes not > being allowed. I'm still pushing to get includes enabled, but it requires a > lot of sweet talking. At least they should allow including files on github that you can link to. ... Cheers Lex -- 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.
