AsciiDoc User Guide

The -e (—no-conf) option excludes the use of implicit configuration files, ensuring that only entries from the mydoc-html.conf configuration are used.

Inserting Blank Space

Adjust your style sheets to add the correct separation between block elements. Inserting blank paragraphs containing a single non-breaking space character {nbsp} works but is an ad hoc solution compared to using style sheets.

Closing Open Sections

You can close off section tags up to level N by calling the eval::[Section.setlevel(N)] system macro. This is useful if you want to include a section composed of raw markup. The following example includes a DocBook glossary division at the top section level (level 0):

ifdef::backend-docbook[]

eval::[Section.setlevel(0)]

+++++++++++++++++++++++++++++++

<glossary>

<title>Glossary</title>

<glossdiv>

...

</glossdiv>

</glossary>

+++++++++++++++++++++++++++++++

endif::backend-docbook[]

Validating Output Files

Use xmllint(1) to check the AsciiDoc generated markup is both well formed and valid. Here are some examples:

The —valid option checks the file is valid against the document type's DTD, if the DTD is not installed in your system's catalog then it will be fetched from it's Internet location. If you omit the —valid option the document will only be checked that it is well formed.

77