Difference between revisions of "Docbook Processing"

From GnuCash
Jump to: navigation, search
(Category:Documentation Development)
(Examples: yelp 3.36.0 can not handle inline tags in link labels)
Line 7: Line 7:
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! scope="col"|
+
! scope="col"| Docbook
 
! scope="col"| Yelp
 
! scope="col"| Yelp
 
! scope="col"| HTML
 
! scope="col"| HTML
Line 51: Line 51:
 
:displayed in About page
 
:displayed in About page
 
|
 
|
 +
<!--
 +
|- style="vertical-align:top;"
 +
! scope="row"|Row Heading 2
 +
| col 1, row 2
 +
| col 2, row 2
 +
| col 3, row 2
 +
| -->
 +
|}
 +
 +
==Examples==
 +
Examples, which need caution:
 +
{| class="wikitable"
 +
|-
 +
! scope="col"| Docbook
 +
! scope="col"| Yelp
 +
! scope="col"| HTML
 +
! scope="col"| PDF (other FOP need verification)
 +
! scope="col"| Notes
 +
 +
|- style="vertical-align:top;"
 +
! scope="row"| in <ulink type="http" url="&url-selinger;accounting/tutorial.html"> &tit-sel-tut;</ulink> by Peter Selinger
 +
| in <u>Tutorial on multiple currency accounting</u> by Peter Selinger
 +
| in <u>Tutorial on multiple currency accounting</u> by Peter Selinger
 +
| in <u>Tutorial on multiple currency accounting <nowiki>[https://www.mathstat.dal.ca/~selinger/accounting/tutorial.html]</nowiki></u> by Peter Selinger
 +
| <u>links</u>, OK
 +
|- style="vertical-align:top;"
 +
! scope="row"| in <ulink type="http" url="&url-selinger;accounting/tutorial.html"><foreignphrase>&tit-sel-tut;</foreignphrase> by Peter Selinger</ulink>.
 +
| in <u><nowiki>https://www.mathstat.dal.ca/~selinger/accounting/tutorial.html</nowiki></u>.
 +
| in <u>''Tutorial on multiple currency accounting'' by Peter Selinger</u>.
 +
| in <u>''Tutorial on multiple currency accounting'' by Peter Selinger <nowiki>[https://www.mathstat.dal.ca/~selinger/accounting/tutorial.html]</nowiki></u>.
 +
| yelp 3.36.0 can not handle inline tags in link labels and eats the label.
 
<!--
 
<!--
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"

Revision as of 03:18, 17 May 2020

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.