Hi Stuart, Attached is two short faqs (or maybe faq-lettes :-).
One is inspired by recent queries on this ML and the other by an answer I gave on another ML to a query on configuration when advocating Asciidoc. Cheers Lex -- 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.
== How do I number all paragraphs Some documents such as specifications and legalese require all paragraphs to be sequentially numbered through the document, and to be able to reference these numbers. This can be achieved by using the docbook toolchain but numbering the paragraphs with AsciiDoc using a custom config file containing the following (see http://www.methods.co.nz/asciidoc/userguide.html#X27 for ways to include such a file) ---- [paragraph] <formalpara{id? id="{id}"}{role? role="{role}"}{id? xreflabel="{paracounter}"}><title>{title}</title><para> {title%}<simpara{id? id="{id}"}{role? role="{role}"}{id? xreflabel="{paracounter}"}> {paracounter} | {title%}</simpara> {title#}</para></formalpara> {counter2:paracounter} {empty} ---- References to the paragraphs operate in the normal way, you label the paragraph: ---- [[some_label_you_understand]] paragraph contents ---- and reference it in the normal manner: ---- <<some_label_you_understand>> ---- and the text of the reference will be the paragraph number. For this to work with HTML you have to generate it via the docbook toolchain. == Sources of information on configuring docbook toolchains As Docbook is a content and structure markup language, AsciiDoc is also limited to content and structure. Layout and formatting definition is specific to the Docbook toolchain. The dbLatex toolchain can be configured by setting parameters defined at http://dblatex.sourceforge.net/doc/manual/sec-params.html or for more complex styling by custom Latex stylesheets described at http://dblatex.sourceforge.net/doc/manual/sec-custom-latex.html. Similarly FOP can be configured by parameters described at http://sagehill.net/docbookxsl/OptionsPart.html and with custom xsl stylesheets generating formatting objects as described at http://sagehill.net/docbookxsl/CustomizingPart.html.
