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://docb
ook.sf.net/files/xsl-ns/latest
http://source
forge.net/projects/docbook
The DocBook XSL-NS Stylesheets are designed for processing
namespaced (DocBook 5) documents.
The reference docs are packaged separately and downloadable
from:
http://doc
book.sf.net/files/xsl-doc/latest
The docs are also available online:
http://docbook.sf.net/release/xsl/current/doc/refere
nce.html
http://docbook.sf.net/release/xsl/current/doc/referen
ce.pdf
http://docbook.sf.net/release/xsl/current/doc/referen
ce.txt
The release notes are included below. HTML and PDF versions
of the
release notes are also available:
http://docbook.sf.net/release/xsl/current/RELEASE-NO
TES.html
http://docbook.sf.net/release/xsl/current/RELEASE-NOT
ES.pdf
Release: 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 <p> 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 <p> element around question and answer
labels to avoid misalignment of label and listitem in xhtml
(non-quirks mode) output
* David Cramer: lists.xsl
Added <p> 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 <a> 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. <title> Foo</title>) 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).
------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-apps-unsubscribe lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help lists.oasis-open.org
|