diff options
author | Chris Johns <chrisj@rtems.org> | 2018-02-02 10:59:21 +1100 |
---|---|---|
committer | Chris Johns <chrisj@rtems.org> | 2018-02-05 14:22:27 +1100 |
commit | 652a90f0a8613ee3bc4112a69137730b5abd9938 (patch) | |
tree | f462f74e3e2ce3758a1ae4d2cce87aee54429a78 /source-builder/sb/asciidoc/dblatex/dblatex-readme.txt | |
parent | sb: Backport from 4.11 the --rsb-file with releases fixes. (diff) | |
download | rtems-source-builder-652a90f0a8613ee3bc4112a69137730b5abd9938.tar.bz2 |
sb: Back port changes to support mailing list posting.
Close #3287
Diffstat (limited to 'source-builder/sb/asciidoc/dblatex/dblatex-readme.txt')
-rw-r--r-- | source-builder/sb/asciidoc/dblatex/dblatex-readme.txt | 39 |
1 files changed, 0 insertions, 39 deletions
diff --git a/source-builder/sb/asciidoc/dblatex/dblatex-readme.txt b/source-builder/sb/asciidoc/dblatex/dblatex-readme.txt deleted file mode 100644 index 39bb437..0000000 --- a/source-builder/sb/asciidoc/dblatex/dblatex-readme.txt +++ /dev/null @@ -1,39 +0,0 @@ -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. |