Docbook Processing

From GnuCash
Revision as of 03:18, 17 May 2020 by Fell (talk | contribs) (Examples: yelp 3.36.0 can not handle inline tags in link labels)
Jump to: navigation, search

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.

Table

Docbook Yelp HTML PDF (other FOP need verification) Notes
<bookinfo>
<title>
<edition>
<authorgroup>
<publisher>
<releaseinfo>
<copyright>
<revhistory>
<legalnotice>
-
dispayed + window title
ignored
displayed in About page
displayed in About page
ignored
displayed in About page
ignored
displayed in About page
-
dispayed + window title
ignored
displayed in About page
ignored
displayed in About page
displayed in About page
displayed in About page
displayed in About page
-
displayed on Title & About page + window title
ignored
displayed on Title & About page
ignored
displayed in About page
displayed in About page
ignored
displayed in About page

Examples

Examples, which need caution:

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.