Version 1.71.0 of the DocBook XSL stylesheets is now available for
download from the DocBook project site.
http://docbook.sf.net/files/xsl/latest http://docbook.sf.net/files/xsl-doc/latest http://sourceforge.net/projects/docbookNote that the reference documentation is packaged separately, and
that this is the first release to include PDF and plain-text
versions of the reference documentation, along with HTML:
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------------------------------------------------------------------------------
As with all DocBook Project dot-zero releases, this is an experimental
release. It will be followed shortly by a stable release.
This is mainly a bug fix release, but it also includes two significant feature
changes:
Highlighting support added
The stylesheets now include support for source-code highlighting in output
of programlisting instances (controlled through the highlight.source
parameter). The Java-based implementation requires Saxon and makes use of
Michal Molhanecs XSLTHL. More details are available at Jirka Koseks
website:
http://xmlguru.cz/2006/07/docbook-syntax-highlighting The support is currently limited to highlighting of XML, Java, PHP,
Delphi, Modula-2 sources, and INI files.
Changes to autoindexing
The templates that handle alternative indexing methods were reworked to
avoid errors produced by certain processors not being able to tolerate the
presence of unused functions. With this release, none of the code for the
'kimber' or 'kosek' methods is included in the default stylesheets. In
order to use one of those methods, your customization layer must import
one of the optional stylesheet modules:
* html/autoidx-kosek.xsl
* html/autoidx-kimber.xsl
* fo/autoidx-kosek.xsl
* fo/autoidx-kimber.xsl
See the index.method parameter reference page for more information.
Two other changes to note:
* The default indexing method now can handle accented characters in
latin-based alphabets, not just English. This means accented latin
letters will group and sort with their unaccented counterpart.
* The default value for the index.method parameter was changed from
'english' to 'basic' because now the default method can handle
latin-based alphabets, not just English.
The following is a list of changes that have been made since the 1.70.1
release.
Common
The following changes have been made to the common code since the 1.70.1
release.
* Added reference.autolabel parameter for controlling labels on
reference output.
* Support rows that are *completely* overlapped by the preceding row
* New modules for supporting indexing extensions.
* Support startinglinenumber on orderedlist
Extensions
The following changes have been made to the extensions code since the 1.70.1
release.
* Completely reworked extensions build system; now uses NetBeans and ant
FO
The following changes have been made to the fo code since the 1.70.1 release.
* xsl:sort lang attribute now uses two-char substring of lang attribute.
* Support titlecase "Java", "Perl", and "IDL" as values for the
language attribute on classsynopsis, etc. (instead of just
lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
(instead of just "cpp").
Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
to "Brian A. Vanderburg II".
* Added support for the reference.autolabel param in (X)HTML and FO
output.
* Support rows that are *completely* overlapped by the preceding row
* Rearranged templates for the 3 indexing methods
and changed method named 'english' to 'basic'.
* New modules for supporting indexing extensions.
* Turn off blank-body for fop1.extensions too since fop 0.92
does not support it either.
* Add Xalan variant to test for exslt:node-set function.
Xalan can use function named node-set(), but doesn't
recognize it using function-available().
* Added support to FO stylesheets for handling instances of Org
where it occurs outside of *info content. In HTML stylesheets,
moved handling of Org out of info.xsl and into inline.xsl. In both
FO and HTML stylesheets, added support for correctly processing
Affiliation and Jobtitle.
* Don't output punctuation between Refname and Refpurpose if
Refpurpose is empty. Also corrected handling of Refsect2/title
instances, and removed some debugging stuff that was generated in
manpages output to mark the ends of sections.
* Added new email.delimiters.enabled param. If non-zero (the
default), delimiters are generated around e-mail addresses (output
of the email element). If zero, the delimiters are suppressed.
* Initial support of syntax highlighting of programlistings.
* Chapter after preface should restart numbering of pages.
HTML
The following changes have been made to the html code since the 1.70.1
release.
* xsl:sort lang attribute now uses two-char substring of lang attribute.
* Support titlecase "Java", "Perl", and "IDL" as values for the
language attribute on classsynopsis, etc. (instead of just
lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
(instead of just "cpp").
Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
to "Brian A. Vanderburg II".
* Added support for the reference.autolabel param in (X)HTML and FO
output.
* Support rows that are *completely* overlapped by the preceding row
* Rearranged templates for the 3 indexing methods
and changed method named 'english' to 'basic'.
* New modules for supporting indexing extensions.
* Added several new HTML parameters for controlling appearance of
content on HTML title pages:
contrib.inline.enabled:
If non-zero (the default), output of the contrib element is
displayed as inline content rather than as block content.
othercredit.like.author.enabled:
If non-zero, output of the othercredit element on titlepages is
displayed in the same style as author and editor output. If zero
(the default), othercredit output is displayed using a style
different than that of author and editor.
blurb.on.titlepage.enabled:
If non-zero, output from authorblurb and personblurb elements is
displayed on title pages. If zero (the default), output from
those elements is suppressed on title pages (unless you are
using a titlepage customization that causes them to be included).
editedby.enabled
If non-zero (the default), a localized Edited by heading is
displayed above editor names in output of the editor element.
* Add Xalan variant to test for exslt:node-set function.
Xalan can use function named node-set(), but doesn't
recognize it using function-available().
* Added support to FO stylesheets for handling instances of Org
where it occurs outside of *info content. In HTML stylesheets,
moved handling of Org out of info.xsl and into inline.xsl. In both
FO and HTML stylesheets, added support for correctly processing
Affiliation and Jobtitle.
* Don't output punctuation between Refname and Refpurpose if
Refpurpose is empty. Also corrected handling of Refsect2/title
instances, and removed some debugging stuff that was generated in
manpages output to mark the ends of sections.
* Added new email.delimiters.enabled param. If non-zero (the
default), delimiters are generated around e-mail addresses (output
of the email element). If zero, the delimiters are suppressed.
* Added qanda.nested.in.toc param. Default value is zero. If
non-zero, instances of "nested" Qandaentry (ones that are children
of Answer elements) are displayed in the TOC. Closes patch 1509018
(from Daniel Leidert). Currently on affects HTML output (no patch
for FO output provided).
* Improved handling of relative locations generated files
* Initial support of syntax highlighting of programlistings.
* Support org
* Support person
* Support $keep.relative.image.uris also when chunking
Highlighting
The following changes have been made to the highlighting code since the 1.70.1
release.
* Initial support of syntax highlighting of programlistings.
Manpages
The following changes have been made to the manpages code since the 1.70.1
release.
* Suppress footnote markers and output warning that footnotes are
not yet supported.
* Handle instances of address/otheraddr/ulink in author et al in the
same way as email instances; that is, display them on the same
linke as the author, editor, etc., name.
* Don't number or link-list any Ulink instance whose string value is
identical to the value of its url attribute. Just display it inline.
* Don't output punctuation between Refname and Refpurpose if
Refpurpose is empty. Also corrected handling of Refsect2/title
instances, and removed some debugging stuff that was generated in
manpages output to mark the ends of sections.
* Added new email.delimiters.enabled param. If non-zero (the
default), delimiters are generated around e-mail addresses (output
of the email element). If zero, the delimiters are suppressed.
* In manpages output, if the last/nearest *info element for
particular Refentry has multiple Copyright and/or Legalnotice
children, process them all (not just the first ones). Closes bug
1524576. Thanks to Sam Steingold for the report and to Daniel
Leidert for providing a patch.
Params
The following changes have been made to the params code since the 1.70.1
release.
* Added reference.autolabel parameter for controlling labels on
reference output.
* Added namespace declarations to document elements for all param files.
* Updated index.method doc to describe revised setup for importing index
extensions.
* Added several new HTML parameters for controlling appearance of
content on HTML title pages:
contrib.inline.enabled:
If non-zero (the default), output of the contrib element is
displayed as inline content rather than as block content.
othercredit.like.author.enabled:
If non-zero, output of the othercredit element on titlepages is
displayed in the same style as author and editor output. If zero
(the default), othercredit output is displayed using a style
different than that of author and editor.
blurb.on.titlepage.enabled:
If non-zero, output from authorblurb and personblurb elements is
displayed on title pages. If zero (the default), output from
those elements is suppressed on title pages (unless you are
using a titlepage customization that causes them to be included).
editedby.enabled
If non-zero (the default), a localized Edited by heading is
displayed above editor names in output of the editor element.
* Added new email.delimiters.enabled param. If non-zero (the
default), delimiters are generated around e-mail addresses (output
of the email element). If zero, the delimiters are suppressed.
* Added qanda.nested.in.toc param. Default value is zero. If
non-zero, instances of "nested" Qandaentry (ones that are children
of Answer elements) are displayed in the TOC. Closes patch 1509018
(from Daniel Leidert). Currently on affects HTML output (no patch
for FO output provided).
* Initial support of syntax highlighting of programlistings.
Tools
The following changes have been made to the tools code since the 1.70.1
release.
* Racheted down font sizes of headings in example makefile FO output.
* Added param and attribute set to example makefile, for getting
wrapping in verbatims in FO output.
* Renamed Makefile.paramDoc to Makefile.docParam.
* Added Makefile.paramDoc file, for creating versions of param.xsl
files with doc embedded.
* Added variable to example makefile for controlling whether HTML or
XHTML is generated.