Difference between revisions of "Docbook Processing"
From GnuCash
(→Examples: yelp 3.36.0 can not handle inline tags in link labels) |
(→Examples: Verbatim Output) |
||
| Line 62: | Line 62: | ||
==Examples== | ==Examples== | ||
Examples, which need caution: | Examples, which need caution: | ||
| + | ===Links=== | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| Line 91: | Line 92: | ||
|} | |} | ||
| + | ===Verbatim Output=== | ||
| + | ;literallayout: same font as text; | ||
| + | ;Screen and ProgramListing: usually Monospaced | ||
| + | :;Screen: | ||
| + | ::;Yelp: page wide framed, but without respecting <tt>width</tt> attribute. | ||
| + | ::;html: without frame. | ||
[[Category:Documentation Development]] | [[Category:Documentation Development]] | ||
Revision as of 09:56, 19 May 2021
The Docbook sources are processed into several output format:
- - : Yelp
- HTML: several Browsers on several OSes
- FOP: PDF, epub, mobi
They interpret some Docbook elements different - the reason could be outdated XSLTs in the repo. The purpose of this page is to collect them to know what to watch in test builds.
Contents
Table
| Docbook | Yelp | HTML | PDF (other FOP need verification) | Notes |
|---|---|---|---|---|
<bookinfo>
|
-
|
-
|
-
|
Examples
Examples, which need caution:
Links
| Docbook | Yelp | HTML | PDF (other FOP need verification) | Notes |
|---|---|---|---|---|
| in <ulink type="http" url="&url-selinger;accounting/tutorial.html"> &tit-sel-tut;</ulink> by Peter Selinger | in Tutorial on multiple currency accounting by Peter Selinger | in Tutorial on multiple currency accounting by Peter Selinger | in Tutorial on multiple currency accounting [https://www.mathstat.dal.ca/~selinger/accounting/tutorial.html] by Peter Selinger | links, OK |
| in <ulink type="http" url="&url-selinger;accounting/tutorial.html"><foreignphrase>&tit-sel-tut;</foreignphrase> by Peter Selinger</ulink>. | in https://www.mathstat.dal.ca/~selinger/accounting/tutorial.html. | in Tutorial on multiple currency accounting by Peter Selinger. | in Tutorial on multiple currency accounting by Peter Selinger [https://www.mathstat.dal.ca/~selinger/accounting/tutorial.html]. | yelp 3.36.0 can not handle inline tags in link labels and eats the label. |
Verbatim Output
- literallayout
- same font as text;
- Screen and ProgramListing
- usually Monospaced
- Screen
-
- Yelp
- page wide framed, but without respecting width attribute.
- html
- without frame.
