docbook-apps

Hello world,

I've released a new version of my (developing) XSLT 2.0 stylesheets
for DocBook.

See http://norman.walsh.name/2011/12/01/docbook-xslt2-2-0-3

DocBook Stylesheets 2.0.3 released

Volume 14, Issue 49; 01 Dec 2011

Another snapshot of the continuing improvements to the XSLT 2.0
stylesheets for DocBook.

Yesterday, I quietly [7]published the 2.0.3 release of the DocBook XSLT
2.0 stylesheets.

The big change in this release is the move towards HTML5. The stylesheets
now produce

elements for major units,

elements for
sections,

elements, etc. In order to retain compatibility with
older browsers, I've updated the CSS and JavaScript. I'm employing a
customized version of [8]Modernizr for backwards compatibility.

I've updated the stylesheets used for this weblog to the latest release
and flushed all the cached HTML, so those changes appear here now as well.
If you see any weirdness, please report it.

Other changes worth noting: table columns now have a class attribute for
better CSS access and tables of contents are always (and only) produced
with

's. The alternative presentation with

produced invalid
markup because there were never any

s.

The other changes are summarized in the [9]release notes:

* [10]Converted a number of div elements into more semantic HTML5
elements (

,

, etc.).

* [11]Fixed <lineannotation> formatting.

* [12]Added localization template for annotation titles. [13]Fixed bugs
in annotation support.

* [14]Added a default.table.column.widths parameter to allow a user to
suppress default column widths when none are specified in the DocBook
(CALS) table. In an effort to make it easier to control table style
with CSS, added a "tcoln" class to each table column.

* [15]Added support for plugins (and other mechanisms) to load
localization data in MarkLogic server.

* [16]Fiddled with nesting of divs in chunks to better support CSS
styling of the footer.

* Greatly [17]improved chunking performance.

* [18]Fixed bug where sections would sometimes be labelled even if they
didn't appear in autolabel.elements.

* [19]Removed massive i18n.xml and i18ndata.xsl files; dynamically load
individual locales when needed.

* [20]Removed about:legacy-compat doctype as it borks XML parsers.

* [21]Fixed github [22]issue 2, empty title causes infinite loop.

* [23]Fixed processing.

* [24]Rearranged the way chunks are handled so that the whole document
is available for cross references even when only the selected chunk
(rootid) is processed

* [25]Changed condition for title foil slides to accomodate new content
model in slides: (foil|foilgroup)+.

* Always [26]use

for tables of contents,

s without any

are
not valid in HTML5

* [27]Treat HTML table caption as title for the purposes of cross
references.

References

Visible links
1. http://norman.walsh.name/2011/12/01/docbook-xslt2-2-0-3.rdf
2. http://norman.walsh.name/2011/12/01/docbook-xslt2-2-0-3.xml
3. http://norman.walsh.name/
4. http://norman.walsh.name/dates.html
5. http://norman.walsh.name/subjects.html
6. http://norman.walsh.name/
7. http://docbook.github.com/
8. http://www.modernizr.com/
9. http://docbook.github.com/release/2.0.3/RELEASENOTES.html
10. https://github.com/docbook/xslt20-stylesheets/commit/872c7d5759c00426bac4823af02c684c9e9102d2
11. https://github.com/docbook/xslt20-stylesheets/commit/efe2d0d00869897c912f5c1ab0a1051483201654
12. https://github.com/docbook/xslt20-stylesheets/commit/dfb8e5e73f8c3aee8a9e915971368dc723ef6908
13. https://github.com/docbook/xslt20-stylesheets/commit/9bdbef3a045136eb24b02acb21482642bf516c70
14. https://github.com/docbook/xslt20-stylesheets/commit/8cb7c7d35defa38b01018ed2a408b4b5311efbe8
15. https://github.com/docbook/xslt20-stylesheets/commit/3597d4debb738ac412d13304b4c25780f033feea
16. https://github.com/docbook/xslt20-stylesheets/commit/9bad461dab742ae1182f098f8922399bdf03d4c4
17. https://github.com/docbook/xslt20-stylesheets/commit/133c77e8446dc22f2b03aacb40cd57f9ad69aa6b
18. https://github.com/docbook/xslt20-stylesheets/commit/fad3697720071e9b1eaf682440ab2c0ac6b6eed9
19. https://github.com/docbook/xslt20-stylesheets/commit/c06af84537a96d9b67cdbe5ef8e54449e93bae04
20. https://github.com/docbook/xslt20-stylesheets/commit/4bd9aa609b5b7aa5adc75de599bca390a5c1f7fa
21. https://github.com/docbook/xslt20-stylesheets/commit/3ef5877b2c91961d79ca20ab2a292c8374920fb4
22. https://github.com/docbook/xslt20-stylesheets/issues/2
23. https://github.com/docbook/xslt20-stylesheets/commit/e638282a449229dba107df64a90fc5df3aeb08b7
24. https://github.com/docbook/xslt20-stylesheets/commit/de529aede9289b8e2b1931abeaad1299956d5f1e
25. https://github.com/docbook/xslt20-stylesheets/commit/30cd17ed3ce36fd9e824d553ef8c0c578514ed31
26. https://github.com/docbook/xslt20-stylesheets/commit/85d74a9e37f5197374692f3b0d7502366bbfd69f
27. https://github.com/docbook/xslt20-stylesheets/commit/2e22775ef4ad6e6a5c0fb082a10b3190dcca302f

Be seeing you,
norm

--
Norman Walsh <ndw@nwalsh.com> | The fact of having been born is
http://www.oasis-open.org/docbook/ | bad augury for immortality.--
Chair, DocBook Technical Committee | Santayana

On Thu, Dec 01, 2011 at 01:57:53PM -0500, Norman Walsh wrote:
> Hello world,
>
> I've released a new version of my (developing) XSLT 2.0 stylesheets
> for DocBook.

Are these intended to act as a replacement for the usual docbook ->
html XSLT that xmlto uses? Can xsltproc run them? (the github,
https://github.com/docbook/docbook.github.com , doesn't seem to have
a howto at all)

-Robin


--
http://singinst.org/ : Our last, best hope for a fantastic future.
Lojban (http://www.lojban.org/): The language in which "this parrot
is dead" is "ti poi spitaki cu morsi", but "this sentence is false"
is "na nei". My personal page: http://www.digitalkingdom.org/rlp/

Hi Norman,

Am Donnerstag, 1. Dezember 2011, 13:57:53 schrieb Norman Walsh:
>
> I've released a new version of my (developing) XSLT 2.0 stylesheets
> for DocBook.
>
> See http://norman.walsh.name/2011/12/01/docbook-xslt2-2-0-3
>
> DocBook Stylesheets 2.0.3 released
>
> Volume 14, Issue 49; 01 Dec 2011
>
> Another snapshot of the continuing improvements to the XSLT 2.0
> stylesheets for DocBook.
>
> Yesterday, I quietly [7]published the 2.0.3 release of the DocBook XSLT
> 2.0 stylesheets.
> [...]

Awesome! Thanks for all your efforts, greatly appreciated! :)

I played with one of my book files (DocBook 5), but it seems I did something
wrong. The single HTML output with docbook.xsl works quite well. The HTML5
code is really nice, I love it. Well done! :)

Unfortunately, I have some problems with the chunking. Used the following
commandline:

$ saxon9 -xi -s:book.xml \
-xsl:/tmp/dbxslt2/xslt/base/html/chunk.xsl \
base.dir="build/html/" use.id.as.filename=1

I observed the following issues:

* Although the parameter use.id.as.filename is enabled, I got some "strange"
chunk*.html files:

chunk-appendix-d62e4779.html chunk-book-d62e2.html
chunk-chapter-d62e1857.html [...]

* The parameter base.dir seems to be ignored completey. The files are saved
in the current directory and the index.html file is missing.

* Headers and footers in chunk-chapter*.html files are not there.

Probably I miss some (important) parameter to set. Do you have a tip for me
what did I wrong?

Thanks, Norman! :-)


--
Gruß/Regards
Thomas Schraitle