blob: 8cc905909f146dee30bbbafe159670807a40e7ee (
plain)
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
|
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 nested
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`) but there is a remaining
problem: blank lines are replaced by a single space.
- 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.
|