The DocBook Project wishes to announce that version 1.73.0 of the
DocBook XSL-NS Stylesheets is now available for download from the
project website:
http://docbook.sf.net/files/xsl-ns/latest http://sourceforge.net/projects/docbookThe DocBook XSL-NS Stylesheets are designed for processing
namespaced (DocBook 5) documents.
The 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.pdfRelease: 1.73.0
This release includes important bug fixes and adds the following significant
feature changes:
New localizations and localization updates
We added two new localizations: Latvian and Esperanto, and made updates to
the Czech, Chinese Simplified, Mongolian, Serbian, Italian, and Ukrainian
localizations.
ISO690 citation style for bibliography output.
Set the bibliography.style parameter to iso690 to use ISO690 style.
New documentation for processing instructions (PI)
The reference documentation that ships with the release now includes
documentation on all PIs that you can use to control output from the
stylesheets.
New profiling parameters for audience and wordsize
You can now do profiling based on the values of the audience and wordsize
attributes.
Changes to man-page output
The manpages stylesheet now supports single-pass profiling and single-pass
DocBook 5 namespace stripping (just as the HTML and FO stylesheets also
do). Also, added handling for mediaobject & inlinemediaobject. (Each
imagedata, audiodata, or videodata element within a mediaobject or inline
mediaobject is now treated as a "notesource" and so handled in much the
same way as links and annotation/alt/footnote are in manpages output.) And
added the man.authors.section.enabled and man.copyright.section.enabled
parameters to enable control over whether output includes auto-generated
AUTHORS and COPYRIGHT sections.
Highlighting support for C
The highlighting mechanism for generating syntax-highlighted code snippets
in output now supports C code listings (along with Java, PHP, XSLT, and
others).
Experimental docbook-xsl-update script
We added an experimental docbook-xsl-update script, the purpose of which
is to facilitate easy sync-up to the latest docbook-xsl snapshot (by means
of rsync).
Gentext
The following changes have been made to the gentext code since the 1.72.0
release.
* Michael(tm) Smith: locale/lv.xml; Makefile
Added Latvian localization file, from Girts Ziemelis.
* Dongsheng Song: locale/zh_cn.xml
Brought up to date with en.xml in terms of items. A few strings marked for translation.
* Jirka Kosek: locale/cs.xml
Added missing translations
* Robert Stayton: locale/eo.xml
New locale for Esperanto.
* Robert Stayton: locale/mn.xml
Update from Ganbold Tsagaankhuu.
* Jirka Kosek: locale/en.xml; locale/cs.xml
Rules for normalizing glossary entries before they are sorted can be now different for each language.
* Michael(tm) Smith: locale/sr_Latn.xml; locale/sr.xml
Committed changes from Milo Komarevi to Serbian files.
* Robert Stayton: locale/ja.xml
Fix chapter in context xref-number-and-title
* Robert Stayton: locale/it.xml
Improved version from contributor.
* Mauritz Jeanson: locale/uk.xml
Applied patch 1592083.
Common
The following changes have been made to the common code since the 1.72.0
release.
* Michael(tm) Smith: labels.xsl
Changed handling of reference auto-labeling such that reference
(when it appears at the component level) is now affected by the
label.from.part param, just as preface, chapter, and appendix.
* Michael(tm) Smith: common.xsl
Added support to the HTML stylesheets for proper processing of
orgname as a child of author.
* Michael(tm) Smith: refentry.xsl
Refined logging output of refentry metadata-gathering template;
for some cases of "missing" elements (refmiscinfo stuff, etc.),
the log messages now include URL to corresponding page in the
Definitive Guide (TDG).
* Robert Stayton: titles.xsl
Add refsection/info/title support.
* Michael(tm) Smith: titles.xsl
Added support for correct handling of xref to elements that
contain info/title descendants but no title children.
This should be further refined so that it handles any *info
elements. And there are probably some other places where similar
handling for *info/title should be added.
* Mauritz Jeanson: pi.xsl
Modified <xsl:when> in datetime.format template to work
around Xalan bug.
FO
The following changes have been made to the fo code since the 1.72.0 release.
* Robert Stayton: component.xsl
Add parameters to the page.sequence utility template.
* Mauritz Jeanson: xref.xsl
Added template for xref to area/areaset.
Part of fix for bug #1675513 (xref to area broken).
* Michael(tm) Smith: inline.xsl
Added template match for person element to fo stylesheet.
* Robert Stayton: lists.xsl
Added support for spacing="compact" in variablelist, per bug report #1722540.
* Robert Stayton: table.xsl
table pgwide="1" should also use pgwide.properties attribute-set.
* Mauritz Jeanson: inline.xsl
Make citations numbered if bibliography.numbered != 0.
* Robert Stayton: param.xweb; param.ent
Add new profiling parameters for audience and wordsize.
* Robert Stayton: param.xweb; param.ent
Added callout.icon.size parameter.
* Robert Stayton: inline.xsl; xref.xsl
Add support for xlink as olink.
* Robert Stayton: autotoc.xsl; param.xweb; param.ent
Add support for qanda.in.toc to fo TOC.
* Robert Stayton: component.xsl
Improved the page.sequence utility template for use with book.
* Robert Stayton: division.xsl
Refactored the big book template into smaller pieces.
Used the "page.sequence" utility template in
component.xsl to shorten the toc piece.
Added placeholder templates for front.cover and back.cover.
* Robert Stayton: param.xweb; param.ent; sections.xsl
Add section.container.element parameter to enable
pgwide spans inside sections.
* Robert Stayton: param.xweb; param.ent; component.xsl
Add component.titlepage.properties attribute-set to
support span="all" and other properties.
* Robert Stayton: htmltbl.xsl; table.xsl
Apply table.row.properties template to html tr rows too.
Add keep-with-next to table.row.properties when row is in thead.
* Robert Stayton: table.xsl
Add support for default.table.frame parameter.
Fix bug 1575446 rowsep last check for @morerows.
* Robert Stayton: refentry.xsl
Add support for info/title in refsections.
* David Cramer: qandaset.xsl
Make fo questions and answers behave the same way as html
* Jirka Kosek: lists.xsl
Added missing attribute set for procedure
* Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
biblio-iso690.xsl
Added support for formatting biblioentries according to ISO690 citation style.
New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
The code was provided by Jana Dvorakova
* Robert Stayton: param.xweb; param.ent; pagesetup.xsl
Add header.table.properties and footer.table.properties attribute-sets.
* Robert Stayton: inline.xsl
Add fop1.extensions for menuchoice arrow handling exception.
HTML
The following changes have been made to the html code since the 1.72.0
release.
* Mauritz Jeanson: param.xweb; param.ent
Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
regular "parameter machinery".
* Michael(tm) Smith: admon.xsl
Changed handling of titles for note, warning, caution, important,
tip admonitions: We now output and HTML h3 head only if
admon.textlabel is non-zero or if the admonition actually contains
a title; otherwise, we don't output an h3 head at all.
(Previously, we were outputting an empty h3 if the admon.textlabel
was zero and if the admonition had no title.)
* Mauritz Jeanson: xref.xsl
Added template for xref to area/areaset.
Part of fix for bug #1675513 (xref to area broken).
* Mauritz Jeanson: titlepage.xsl; component.xsl; division.xsl; sections.xsl
Added fixes to avoid duplicate ids when generate.id.attributes = 1.
This (hopefully) closes bug #1671052.
* Michael(tm) Smith: formal.xsl; pi.xsl
Made the dbfunclist PI work as intended. Also added doc for
dbfunclist and dbcmdlist PIs.
* Michael(tm) Smith: pi.xsl; synop.xsl
Made the dbcmdlist work the way it appears to have been intended
to work. Restored dbhtml-dir template back to pi.xsl.
* Michael(tm) Smith: titlepage.xsl; param.xweb; param.ent
Added new param abstract.notitle.enabled.
If non-zero, in output of the abstract element on titlepages,
display of the abstract title is suppressed.
Because sometimes you really don't want or need that title
there...
* Michael(tm) Smith: chunk-code.xsl; graphics.xsl
When we are chunking long descriptions for mediaobject instances
into separate HTML output files, and use.id.as.filename is
non-zero, if a mediaobject has an ID, use that ID as the basename
for the long-description file (otherwise, we generate an ID for it
and use that ID as the basename for the file).
The parallels the recent change made to cause IDs for legalnotice
instances to be used as basenames for legalnotice chunks.
Also, made some minor refinements to the recent changes for
legalnotice chunk handling.
* Michael(tm) Smith: titlepage.xsl
Added support to the HTML stylesheets for proper processing of
orgname as a child of author.
* Michael(tm) Smith: chunk-code.xsl
When $generate.legalnotice.link is non-zero and
$use.id.as.filename is also non-zero, if a legalnotice has an ID,
then instead of assigning the "ln-<generatedID>" basename to the
output file for that legalnotice, just use its real ID as the
basename for the file -- as we do when chunking other elements
that have IDs.
* David Cramer: xref.xsl
Handle alt text on xrefs to steps when the step doesn't have a title.
* David Cramer: lists.xsl
Added
element around term in variablelist when formatted as table to avoid misalignment of term and listitem in xhtml (non-quirks mode) output
* David Cramer: qandaset.xsl
Added
element around question and answer labels to avoid misalignment of label and listitem in xhtml (non-quirks mode) output
* David Cramer: lists.xsl
Added
element around callouts to avoid misalignment of callout and listitem in xhtml (non-quirks mode) output
* Mauritz Jeanson: inline.xsl
Make citations numbered if bibliography.numbered != 0.
* Robert Stayton: param.xweb; param.ent
Add support for new profiling attributes audience and wordsize.
* Robert Stayton: inline.xsl; xref.xsl
Add support for xlink olinks.
* Jirka Kosek: glossary.xsl
Rules for normalizing glossary entries before they are sorted can be now different for each language.
* Robert Stayton: chunk-common.xsl; chunk-code.xsl; manifest.xsl; chunk.xsl
Refactored the chunking modules to move all named templates to
chunk-common.xsl and all match templates to chunk-code.xsl, in
order to enable better chunk customization.
See the comments in chunk.xsl for more details.
* Robert Stayton: lists.xsl
Add anchor for xml:id for listitem in varlistentry.
* Robert Stayton: refentry.xsl
Add support for info/title in refsections for db5.
* Jirka Kosek: param.xweb; biblio.xsl; docbook.xsl; param.ent;
biblio-iso690.xsl
Added support for formatting biblioentries according to ISO690 citation style.
New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
The code was provided by Jana Dvorakova
* Robert Stayton: inline.xsl; xref.xsl
Add call to class.attribute to output elements so they can
have a class value too.
* Mauritz Jeanson: glossary.xsl
Fixed bug #1644881:
* Added curly braces around all $language attribute values.
* Moved declaration of language variable to top level of stylesheet.
Tested with Xalan, Saxon, and xsltproc.
Manpages
The following changes have been made to the manpages code since the 1.72.0
release.
* Michael(tm) Smith: param.xweb; docbook.xsl; param.ent
Added the man.authors.section.enabled and
man.copyright.section.enabled parameters. Set those to zero when
you want to suppress display of the auto-generated AUTHORS and
COPYRIGHT sections. Closes request #1467806. Thanks to Daniel
Leidert.
* Michael(tm) Smith: docbook.xsl
Took the test that the manpages stylesheet does to see if there
are any Refentry chilren in current doc, and made it
namespace-agnostic. Reason for that is because the test otherwise
won't work when it is copied over into the generated
profile-docbook.xsl stylesheet.
* Michael(tm) Smith: Makefile
Added a manpages/profile-docbook.xsl file to enable single-pass
profiling for manpages output.
* Michael(tm) Smith: info.xsl
Output copyright and legalnotice in man-page output in whatever
place they are in in document order. Closes #1690539. Thanks to
Daniel Leidert for reporting.
* Michael(tm) Smith: docbook.xsl
Restored support for single-pass namespace stripping to manpages
stylesheet.
* Michael(tm) Smith: synop.xsl; block.xsl; info.xsl; inline.xsl; lists.xsl;
endnotes.xsl; ut
Changed handling of bold and italic/underline output in manpages
output. Should be transparent to users, but...
This touches handling of all bold and italic/underline output. The
exact change is that the mode="bold" and mode="italic" utility
templates were changed to named templates. (I think maybe I've
changed it back and forth from mode to named before, so this is
maybe re-reverting it yet again).
Anyway, the reason for the change is that the templates are
sometimes call on dynamically node-sets, and using modes to format
those doesn't allow passing info about the current/real context
node from the source (not the node-set created by the stylesheet)
to that formatting stage.
The named templates allow the context to be passed in as a
parameter, so that the bold/ital formatting template can use
context-aware condition checking.
This was basically necessary in order to suppress bold formatting
in titles, which otherwise gets screwed up because of the numbnut
way that roff handles nested bold/ital.
Closes #1674534). Much thanks to Daniel Leidert, whose in his
docbook-xsl bug-finding kung-fu has achieved Grand Master status.
* Michael(tm) Smith: block.xsl
Fixed handling of example instances by adding the example element
to the same template we use for processing figure. Closes
#1674538. Thanks to Daniel Leidert.
* Michael(tm) Smith: utility.xsl
Don't include lang in manpages filename/pathname if lang=en (that
is, only generate lang-qualified file-/pathnames for non-English).
* Michael(tm) Smith: endnotes.xsl
In manpages output, emit warnings for notesources (footnote, etc.)
that have something other than para as a child.
The numbered-with-hanging-indent formatting that's used for
rendering endnotes in the NOTES section of man pages places some
limits/assumptions on how the DocBook source is marked up; namely,
for notesources (footnote, annotation, etc.) that can contain
block-level children, if the they have a block-level child such as
a table or itemizedlist or orderedlist that is the first child of
a footnote, we have no way of rendering/indenting its content
properly in the endnotes list.
Thus, the manpages stylesheet not emits a warning message for that
case, and suggests the "fix" (which is to wrap the table or
itemizedlist or whatever in a para that has some preferatory text.
* Michael(tm) Smith: utility.xsl
Added support to mixed-block template for handling tables in
mixed-blocks (e.g., as child of para) correctly.
* Michael(tm) Smith: table.xsl; synop.xsl; block.xsl; info.xsl; lists.xsl;
refentry.xsl; end
Reverted necessary escaping of backslash, dot, and dash
out of the well-intentioned (but it now appears,
misguided) "marker" mechanism (introduced in the 1.72.0
release) -- which made use of alternative "marker"
characters as internal representations of those
characters, and then replaced them just prior to
serialization -- and back into what's basically the
system that was used prior to the 1.69.0 release; that
is, into a part of stylesheet code that gets executed
at the beginning of processing -- before any other roff
markup up is. This change obviates the need for the
marker system. It also requires a lot less RAM during
processing (for large files, the marker mechanism
ending up requiring gigabytes of memory).
Closes bug #1661177. Thanks to Scott Smedley for
providing a test case (the fvwm man page) that exposed
the problem with the marker mechanism.
Also moved the mechanism for converting non-breaking
spaces back into the same area of the stylesheet code.
* Michael(tm) Smith: lists.xsl
Fixed problem with incorrect formatting of nested variablelist.
Closes bug #1650931. Thanks to Daniel "Eagle Eye" Leidert.
* Michael(tm) Smith: lists.xsl
Make sure that all listitems in itemizedlist and orderedlist are
preceded by a blank line. This fixes a regression that occurred
when instances of the TP macro that were use in a previous
versions of the list-handling code were switched to RS/RE (because
TP doesn't support nesting). TP automatically generates a blank
line, but RS doesn't. So I added a .sp before each .RS
* Michael(tm) Smith: block.xsl; inline.xsl; param.xweb; docbook.xsl;
links.xsl; param.ent
Made a number of changes related to elements with
out-of-line content:
- Added handling for mediaobject & inlinemediaobject.
Each imagedata, audiodata, or videodata element
within a mediaobject or inline mediaobject is now
treated as a "notesource" and so handled in much the
same way as links and annotation/alt/footnotes.
That means a numbered marker is generated inline to
mark the place in the main flow where the imagedata,
audiodata, or videodata element occurs, and a
corresponding numbered endnote for it is generated in
the endnotes list at the end of the man page; the
endnote contains the URL from the fileref attribute
of the imagedata, audiodata, or videodata element.
For mediobject and inlinemediaobject instances that
have a textobject child, the textobject is displayed
within the main text flow.
- Renamed several man.link.* params to man.endnotes.*,
to reflect that fact that the endnotes list now
contains more than just links. Also did similar
renaming for a number of stylesheet-internal vars.
- Added support for xlink:href (along with existing
support for the legacy ulink element).
- Cleaned up and streamlined the endnotes-handling
code. It's still messy and klunky and the basic
mechanism it uses is very inefficent for documents
that contain a lot of notesources, but at least it's
a bit better than it was.
Eclipse
The following changes have been made to the eclipse code since the 1.72.0
release.
* Mauritz Jeanson: Makefile
Fixed bug #1715093: Makefile for creating profiled version of eclipse.xsl added.
* David Cramer: eclipse.xsl
Added normalize-space around to avoid leading whitespace from appearing in the output if there's extra leading whitespace (e.g. ) in the source
JavaHelp
The following changes have been made to the javahelp code since the 1.72.0
release.
* Mauritz Jeanson: javahelp.xsl
Implemented FR #1230233 (sorted index in javahelp).
* Mauritz Jeanson: javahelp.xsl
Added normalize-space() around titles and index entries to work around whitespace problems.
Added support for glossary and bibliography in toc and map files.
Roundtrip
The following changes have been made to the roundtrip code since the 1.72.0
release.
* Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl; normalise2sections.xsl;
sections2blocks.
new stylesheets for better word processor support and easier maintenance
* Steve Ball: template-pages.xml; dbk2wp.xsl; sections-spec.xml
fixed bugs
Params
The following changes have been made to the params code since the 1.72.0
release.
* Mauritz Jeanson: htmlhelp.button.back.xml; htmlhelp.button.forward.xml;
htmlhelp.button.zo
Modified refpurpose text.
* Mauritz Jeanson: htmlhelp.map.file.xml; htmlhelp.force.map.and.alias.xml;
htmlhelp.alias.f
Fixed typos, made some small changes.
* Mauritz Jeanson: javahelp.encoding.xml
Moved declaration and documentation of javahelp.encoding from javahelp.xsl to the
regular "parameter machinery".
* Mauritz Jeanson: generate.id.attributes.xml
Added refpurpose text.
* Mauritz Jeanson: annotation.js.xml; annotation.graphic.open.xml;
annotation.graphic.close.
Added better refpurpose texts.
* Michael(tm) Smith: chunker.output.cdata-section-elements.xml;
chunker.output.standalone.xm
Fixed some broken formatting in source files for chunker.* params,
as pointed out by Dave Pawson.
* Michael(tm) Smith: label.from.part.xml
Changed handling of reference auto-labeling such that reference
(when it appears at the component level) is now affected by the
label.from.part param, just as preface, chapter, and appendix.
* Mauritz Jeanson: callout.graphics.extension.xml
Clarified that 'extension' refers to file names.
* Michael(tm) Smith: abstract.notitle.enabled.xml
Added new param abstract.notitle.enabled.
If non-zero, in output of the abstract element on titlepages,
display of the abstract title is suppressed.
Because sometimes you really don't want or need that title
there...
* Michael(tm) Smith: man.string.subst.map.xml
Updated manpages string-substitute map to reflect fact that
because of another recent change to suppress bold markup in .SH
output, we no longer need to add a workaround for the accidental
uppercasing of roff escapes that occurred previously.
* Jirka Kosek: margin.note.float.type.xml; title.font.family.xml;
table.frame.border.color.x
Improved parameter metadata
* Robert Stayton: profile.wordsize.xml; profile.audience.xml
Add support for profiling on new attributes audience and wordsize.
* Robert Stayton: callout.graphics.number.limit.xml;
callout.graphics.extension.xml
Added SVG graphics for fo output.
* Robert Stayton: callout.icon.size.xml
Set size of callout graphics.
* Jirka Kosek: default.units.xml; chunker.output.method.xml;
toc.list.type.xml; output.inden
Updated parameter metadata to the new format.
* Jirka Kosek: man.output.quietly.xml; title.font.family.xml;
footnote.sep.leader.properties
Added type annotations into parameter definition files.
* Robert Stayton: section.container.element.xml
Support spans in sections for certain processors.
* Robert Stayton: component.titlepage.properties.xml
Empty attribute set for top level component titlepage block.
Allows setting a span on title info.
* Jirka Kosek: bibliography.style.xml
Added link to WiKi page with description of special markup needed for ISO690 biblioentries
* Robert Stayton: make.year.ranges.xml
Clarify that multiple year elements are required.
* Robert Stayton: id.warnings.xml
Turn off id.warnings by default.
* Jirka Kosek: bibliography.style.xml
Added support for formatting biblioentries according to ISO690 citation style.
New bibliography style can be turned on by setting parameter bibliography.style to "iso690"
The code was provided by Jana Dvorakova
* Robert Stayton: header.table.properties.xml; footer.table.properties.xml
Support adding table properties to header and footer tables.
Highlighting
The following changes have been made to the highlighting code since the 1.72.0
release.
* Jirka Kosek: c-hl.xml; xslthl-config.xml
Added support for C language. Provided by Bruno Guegan.
Profiling
The following changes have been made to the profiling code since the 1.72.0
release.
* Robert Stayton: profile-mode.xsl
Add support for new profiling attributes audience and wordsize.
Lib
The following changes have been made to the lib code since the 1.72.0 release.
* Michael(tm) Smith: lib.xweb
Changed name of prepend-pad template to pad-string and twheeked so
it can do both right/left padding.
Tools
The following changes have been made to the tools code since the 1.72.0
release.
* Michael(tm) Smith: bin; bin/docbook-xsl-update
Did some cleanup to the install.sh source and added a
docbook-xsl-update script to the docbook-xsl distro, the purpose
of which is to facilitate easy sync-up to the latest docbook-xsl
snapshot (by means of rsync).