The DocBook Project wishes to announce that version 1.72.0 of the
DocBook XSL Stylesheets is now available for download from the
project website:
http://docbook.sf.net/files/xsl/latest http://sourceforge.net/projects/docbookThe reference docs are packaged separately and downloadable from:
http://docbook.sf.net/files/xsl-doc/latestThe docs are also available online:
http://docbook.sf.net/release/xsl/current/doc/reference.html http://docbook.sf.net/release/xsl/current/doc/reference.pdf http://docbook.sf.net/release/xsl/current/doc/reference.txtThe release notes are included below. HTML and PDF versions of the
release notes are also available:
http://docbook.sf.net/release/xsl/current/RELEASE-NOTES.html http://docbook.sf.net/release/xsl/current/RELEASE-NOTES.pdf------------------------------------------------------------------------------
This release includes important bug fixes and adds the following significant
feature changes:
Automatic sorting of glossary entries
The HTML and FO stylesheets now support automatic sorting of glossary
entries. To enable glossary sorting, set the value of the glossary.sort
parameter to 1 (by default, its value is 0). When you enable glossary
sorting, glossentry elements within a glossary, glossdiv, or glosslist are
sorted on the glossterm, using the current language setting. If you dont
enable glossary sorting, then the order of glossentry elements is left as
is that is, they are not sorted but are instead just displayed in
document order.
WordML renamed to Roundtrip, OpenOffice support added
Stylesheets for roundtrip conversion between documents in OpenOffice
format (ODF) and DocBook XML have been added to the set of stylesheets
that formerly had the collective title WordML, and that set of stylesheets
has been renamed to Roundtrip to better reflect the actual scope and
purpose of its contents.
So the DocBook XSL Stylesheets now support roundtrip conversion (with
certain limitations) of WordML, OpenOffice, and Apple Pages documents to
and from DocBook XML.
Including QandASet questions in TOCs
The HTML stylesheet now provides support for including QandASet questions
in the document TOC. To enable display of questions in the document TOC,
set the value of the qanda.in.toc to 1 (by default, its 0). When you
enable qanda.in.toc, then the generated table of contents for a document
will include qandaset titles, qandadiv titles, and question elements. The
default value of zero excludes them from the TOC.
Note
The qanda.in.toc parameter does not affect any tables of contents that may
be generated within a qandaset or qandadiv (only in the document TOC).
Language identifier in man-page filenames and pathnames
Added new parameter man.output.lang.in.name.enabled, which controls
whether a language identifier is included in man-page filenames and
pathnames. It works like this:
If the value of man.output.lang.in.name.enabled is non-zero, man-page
files are output with a language identifier included in their filenames or
pathnames as follows:
* if man.output.subdirs.enabled is non-zero, each file is output to,
e.g., a /$lang/man8/foo.8 pathname
* if man.output.subdirs.enabled is zero, each file is output with a
foo.$lang.8 filename
index.page.number.properties property set
For FO output, use the index.page.number.properties to control formatting
of page numbers in index output to (for example) to display page numbers
in index output in a different color (to indicate that they are links).
Crop marks in output from Antenna House XSL Formatter
Support has been added for generating crop marks in print/PDF output
generated using Antenna House XSL Formatter
More string-substitution hooks in manpages output
The man.string.subst.map.local.pre and man.string.subst.map.local.post
parameters have been added to enable easier control over custom string
substitutions.
Moved verbatim properties to attribute-set
The hardcoded properties used in verbatim elements (literallayout,
programlisting, screen) were moved to the verbatim.properties
attribute-set so they can be more easily customized.
enhanced simple.xlink template
Now the simple.xlink template in inline.xsl works with cross reference
elements xref and link as well. Also, more elements call simple.xlink,
which enables DB5 xlink functionality.
DocBook 5 compatibility
Stylesheets now consistently support DocBook 5 attributes (such as
xml:id). Also, DocBook 5 info elements are now checked along with other
*info elements, and the use of name() function was replaced by
local-name() so it also matches on DocBook 5 elements. These changes
enable reusing the stylesheets with DocBook 5 documents with minimal
fixup.
HTML class attributes now handled in class.attribute mode
The HTML class attributes were formerly hardcoded to the element name. Now
the class attribute is generated by applying templates in class.attribute
mode so class attribute names can be customized. The default is still the
element name.
arabic-indic numbering enabled in autolabels
Numbering of chapter, sections, and pages can now use arabic-indic
numbering when number format is set to 'arabicindic' or to .
The following is a detailed list of changes (not including bug fixes) that
have been made since the 1.71.1 release.
Common
The following changes have been made to the common code since the 1.71.1
release.
* Add support for arabicindic numbering to autolabel.format template.
* Finish support for @xml:id everywhere @id is used.
* replace name() with local-name() in most cases.
* Add support for info.
* Add utility template tabstyle to return the tabstyle from
any table element.
FO
The following changes have been made to the fo code since the 1.71.1 release.
* Add support for sorting glossary entries
* Add table.row.properties template to customize table rows.
* Moved all properties to attribute-sets so can be customized more easily.
* Add index.page.number.properties attribute-set to format page numbers.
* xref now supports xlink:href, using simple.xlink template.
* Rewrote simple.xlink, and call it with all charseq templates.
* Add simple.xlink processing to term and member elements.
* Add support for crop marks in Antenna House.
HTML
The following changes have been made to the html code since the 1.71.1
release.
* Add support for sorting glossary entries
* Add support for qanda.in.toc to add qandaentry questions to document TOC.
* add simple.xlink support to variablelist term and simplelist member.
* *.propagates.style now handled in class.attribute mode.
* add class parameter to class.attribute mode to set default class.
* Convert all class attributes to use the class.attribute mode
so class names can be customized more easily.
* Add class.attribute mode to generate class attributes.
* Added simple.xlink to most remaining inlines.
Changed class attributes to applying class.attributes mode.
* Changed xref template to use simple.xlink tempalte.
* Improve generate.html.title to work with link targets too.
* Improved simple.xlink to support link and xref.
* Use new link.title.attribute now.
* Rewrote simple.xlink to handle linkend also.
Better computation of title attribute on link too.
* Handle Xalan quirk as special case.
* Add support for info.
* Fixed imagemaps so they work properly going from calspair coords
to HTML area coords.
Manpages
The following changes have been made to the manpages code since the 1.71.1
release.
* Added doc for man.output.lang.in.name.enabled parameter. This
checkin completes support for writing file/pathnames for man-pages
with $lang include in the names. Closes #1585967. knightly
accolades to Daniel Leidert for providing the feature request.
* Added new param man.output.lang.in.name.enabled, which
controls whether $LANG value is included in manpages
filenames and pathnames. It works like this:
If the value of man.output.lang.in.name.enabled is non-zero,
man-page files are output with the $lang value included in
their filenames or pathnames as follows;
- if man.output.subdirs.enabled is non-zero, each file is
output to, e.g., a /$lang/man8/foo.8 pathname
- if man.output.subdirs.enabled is zero, each file is output
with a foo.$lang.8 filename
* Use "\e" instead of "\\" for backslash output, because the
groff docs say that's the correct thing to do; also because
testing (thanks, Paul Dubois) shows that "\\" doesn't always
work as expected; for example, "\\" within a table seems to
mess things up.
* Added the man.string.subst.map.local.pre and
man.string.subst.map.local.post parameters. Those parameters
enable local additions and changes to string-substitution mappings
without the need to change the value of man.string.subst.map
parameter (which is for standard system mappings). Closes
#1456738. Thanks to Sam Steingold for constructing a true
stylesheet torture test (the clisp docs) that exposed the need for
these params.
* Added the Markup element to the list of elements that get output
in bold. Thanks to Eric S. Raymond.
* Replaced all dots in roff requests with U+2302 ("house"
character), and added escaping in output for all instances of dot
that are not in roff requests. This fixes the problem case where a
string beginning with a dot (for example, the string ".bashrc")
might occur at the beginning of a line in output, in which case
would mistakenly get interpreted as a roff request. Thanks to Eric
S. Raymond for pushing to fix this.
* Made change to ensure that list content nested in
itemizedlist and orderedlist instances is properly indented. This
is a switch from using .TP to format those lists to using .RS/.RE
to format them instead (because .TP does not allow nesting). Closes bug #1602616.
Thanks to Daniel Leidert.
Params
The following changes have been made to the params code since the 1.71.1
release.
* Added doc for man.output.lang.in.name.enabled parameter. This
checkin completes support for writing file/pathnames for man-pages
with $lang include in the names. Closes #1585967. knightly
accolades to Daniel Leidert for providing the feature request.
* Added new param man.output.lang.in.name.enabled, which
controls whether $LANG value is included in manpages
filenames and pathnames. It works like this:
If the value of man.output.lang.in.name.enabled is non-zero,
man-page files are output with the $lang value included in
their filenames or pathnames as follows;
- if man.output.subdirs.enabled is non-zero, each file is
output to, e.g., a /$lang/man8/foo.8 pathname
- if man.output.subdirs.enabled is zero, each file is output
with a foo.$lang.8 filename
* Added the man.string.subst.map.local.pre and
man.string.subst.map.local.post parameters. Those parameters
enable local additions and changes to string-substitution mappings
without the need to change the value of man.string.subst.map
parameter (which is for standard system mappings). Closes
#1456738. Thanks to Sam Steingold for constructing a true
stylesheet torture test (the clisp docs) that exposed the need for
these params.
* Add index.page.number.properties by default.
* Added index.page.number.properties
to allow customizations of page numbers in indexes.
* Move show-destination="replace" property from template to attribute-set
so it can be customized.
* Add support for sorting glossary entries
* Add option to include qanda in tables of contents.
* Moved all properties to attribute-sets so can be customized more easily.
Template
The following changes have been made to the template code since the 1.71.1
release.
* Added workaround for Xalan bug: use for-each and copy instead of copy-of (#1604770).
Roundtrip
The following changes have been made to the roundtrip code since the 1.71.1
release.
* rename to roundtrip, add OpenOffice support