/etc/asciidoc/dblatex/dblatex-readme.txt is in asciidoc 8.6.9-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 | AsciiDoc dblatex README
=======================
Customization
-------------
The `./dblatex` directory contains:
`./dblatex/asciidoc-dblatex.xsl`:: Optional dblatex XSL parameter
customization.
`./dblatex/asciidoc-dblatex.sty`:: Optional customized LaTeX styles.
Use these files with dblatex(1) `-p` and `-s` options, for example:
dblatex -p ../dblatex/asciidoc-dblatex.xsl \
-s ../dblatex/asciidoc-dblatex.sty article.xml
Limitations
-----------
Observed in dblatex 0.2.8.
- dblatex doesn't seem to process the DocBook 'literallayout' element
correctly: it is rendered in a monospaced font and no inline
elements are processed. By default the normal font should be used
and almost all DocBook inline elements should be processed
(http://www.docbook.org/tdg/en/html/literallayout.html). I almost
fixed this by overriding the default dblatex literallayout template
(in `./dblatex/asciidoc-dblatex.xsl`) and using the LaTeX 'alltt'
package, but there are remaining problems:
* Blank lines are replaced by a single space.
* The 'literallayout' element incorrectly wraps text when rendered
inside a table.
- Callouts do not work inside DocBook 'literallayout' elements which
means callouts are not displayed inside AsciiDoc literal blocks. A
workaround is to change the AsciiDoc literal block to a listing
block.
|