Difference between revisions of "Docbook Processing"
From GnuCash
(First sketch) |
(→Verbatim Output: https://github.com/GNOME/yelp-xsl) |
||
| (7 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
:HTML: several Browsers on several OSes | :HTML: several Browsers on several OSes | ||
:FOP: PDF, epub, mobi | :FOP: PDF, epub, mobi | ||
| − | They interpret some Docbook elements different. The purpose of this page is to collect them to know what to watch in test builds. | + | 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. |
| + | [[Category:Documentation Development]] | ||
==Table== | ==Table== | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| − | ! scope="col"| | + | ! scope="col"| Docbook |
! scope="col"| Yelp | ! scope="col"| Yelp | ||
! scope="col"| HTML | ! scope="col"| HTML | ||
| Line 43: | Line 44: | ||
| - | | - | ||
:displayed on Title & About page + window title | :displayed on Title & About page + window title | ||
| − | : | + | :ignored |
:displayed on Title & About page | :displayed on Title & About page | ||
:ignored | :ignored | ||
| Line 60: | Line 61: | ||
|} | |} | ||
| − | [ | + | ==Examples== |
| − | [ | + | Examples, which need caution: |
| + | ===Links=== | ||
| + | {| 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;" | ||
| + | ! scope="row"|Row Heading 2 | ||
| + | | col 1, row 2 | ||
| + | | col 2, row 2 | ||
| + | | col 3, row 2 | ||
| + | | --> | ||
| + | |} | ||
| + | |||
| + | ===Verbatim Output=== | ||
| + | Put the closing tag on the last line of the output to avoid an empty bottom line. | ||
| + | ;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. | ||
| + | :;Programlisting: * | ||
| + | * attribute <tt>language</tt> produces syntaxhighlighting – at least in yelp, html probably needs configuration. | ||
| + | ::: See {{URL:GH}}GNOME/yelp-xsl/tree/master/js for yelp's usage of highlight.js. | ||
| + | |||
| + | ===Gui elements=== | ||
| + | ;Accel: not displayed in HTML, but in Yelp. | ||
Latest revision as of 17:40, 30 July 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.
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
Put the closing tag on the last line of the output to avoid an empty bottom line.
- literallayout
- same font as text;
- Screen and Programlisting
- usually Monospaced
- Screen
- *
- Yelp
- page wide framed, but without respecting width attribute.
- html
- without frame.
- Programlisting
- *
- attribute language produces syntaxhighlighting – at least in yelp, html probably needs configuration.
- See https://github.com/GNOME/yelp-xsl/tree/master/js for yelp's usage of highlight.js.
Gui elements
- Accel
- not displayed in HTML, but in Yelp.
