Version 1.74.1 of the DocBook XSL-NS Stylesheets, for processing
namespaced (DocBook 5) documents, is now available:
http://docbook.sf.net/files/xsl-ns/latestThe release notes are included below, and also available online.
The reference docs are available as a separate package, and online.
http://docbook.sf.net/files/xsl-doc/latest http://docbook.sf.net/release/xsl-ns/current/doc/ http://docbook.sf.net/release/xsl-ns/current/RELEASE-NOTES.htmlRelease Notes: 1.74.1
The following is a list of changes that have been made since the 1.74.0
release.
Gentext
The following changes have been made to the gentext code since the 1.74.0
release.
? Mauritz Jeanson: locale/sv.xml
Added "Acknowledgements".
? Michael(tm) Smith: locale/ky.xml; Makefile
new Kirghiz locale from Ilyas Bakirov
? Dongsheng Song: locale/zh.xml; locale/zh_cn.xml
Fix Auditlocale.pl warning.
? Dongsheng Song: locale/zh_cn.xml
Follow-up to r8219, add "Acknowledgements".
? Mauritz Jeanson: locale/en.xml
Added "Acknowledgements".
? Dongsheng Song: locale/zh_cn.xml
Simplified Chinese translation.
* defguide5/zh/stylesheets/fo.xsl,defguide5/zh/stylesheets/zh/fo.xsl,
defguide/zh/stylesheets/fo.xsl,defguide/zh/stylesheets/zh/fo.xsl: change symbol font.
* gentext/locale/zh_cn.xml: Use publishing term instead.
? Dongsheng Song: locale/zh_cn.xml
Update some gentext translations.
? Robert Stayton: locale/lv.xml; locale/ca.xml; locale/pt.xml; locale/tr.xml;
locale/af.xml; ?¯
Add writing-mode gentext string to support right-to-left languages.
Common
The following changes have been made to the common code since the 1.74.0
release.
? Michael(tm) Smith: .gitignore; Makefile
incorporate Kirghiz locale from Ilyas Bakirov
? Mauritz Jeanson: common.xsl
Reverted revision 7671 in order to prevent orgname from being mixed into
person names. The bug has been reported twice: #2000787 and #2082455.
? Mauritz Jeanson: table.xsl
Modified predicate in tabstyle template. Closes bug #2269202.
? Michael(tm) Smith: Makefile
remove the now-totally-pointless xjparse pass on gentext sources
? Mauritz Jeanson: gentext.xsl
Added template for procedure autonumbering. Closes bug #2020982.
? Keith Fahlgren: Makefile
Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN
FO
The following changes have been made to the fo code since the 1.74.0 release.
? Mauritz Jeanson: table.xsl
Fixed bug #2574111 (missing rowsep border between tgroups in one table).
? Mauritz Jeanson: titlepage.xsl
Updated abstract template so that the abstract.properties and
abstract.title.properties attribute-sets are used. See bug #1842865.
? Jirka Kosek: xref.xsl
Allow hyphnetation also in xlink urls
? Mauritz Jeanson: table.xsl
Added processing of mediaobject/graphic to calsTable template. Closes bug #2298384.
? Dongsheng Song: titlepage.xsl
Fix a longstanding bug, "gentext" for "bookinfo/pubdate|info/pubdate" should
map to 'pubdate', not 'published'!
This bug exist since initial checkin by nwalsh, all languages except english
affected, I'm very surprised why no one complain it yet!
? Robert Stayton: table.xsl
Fix bug in computation of nextspans variable when
skipped columns and column span are used.
? Mauritz Jeanson: graphics.xsl
Set scalefit=1 if a default image width is defined. Closes bug #2020774.
? Mauritz Jeanson: fop1.xsl
Added header with Id and copyright info.
? Mauritz Jeanson: fop1.xsl
Added fix for subtitle in metadata.
? Robert Stayton: autoidx.xsl
Fix two bugs in info.reference template:
- mediaobject omitted from list of info containers.
- replace [1] with [position() = last()] in the target predicate because
when parens are used, the ancestor node list is in document order
instead of closest ancestor order.
? David Cramer: footnote.xsl
Added a check to confirm that a footnoteref's linkend points to a footnote. Stylesheets stop processing if not and provide a useful error message.
? Mauritz Jeanson: spaces.xsl
Convert spaces to fo:leader also in elements in the DB 5 namespace.
? Mauritz Jeanson: pi.xsl; synop.xsl
Added support for a new processing instruction: dbfo funcsynopsis-style.
Closes bug #1838213.
? Michael(tm) Smith: inline.xsl; param.xweb; param.ent
Added new param email.mailto.enabled for FO output.
Patch from Paolo Borelli. Closes #2086321.
? Mauritz Jeanson: docbook.xsl
Added support for document metadata for fop1 (patch #2067318).
? Mauritz Jeanson: fop1.xsl
Added support for document metadata for fop1 (patch #2067318).
? Michael(tm) Smith: index.xsl
make fo index titlepage respect component.titlepage.properties; closes bug #2060418; thanks to Paolo Borelli
? Mauritz Jeanson: toc.xsl
Removed duplicate templates. Closes bug #2034582.
? Jirka Kosek: param.ent; param.xweb; highlight.xsl
Upgraded to support the latest version of XSLTHL 2.0
-- nested markup in highlited code is now processed
-- it is no longer needed to specify path XSLTHL configuration file using Java property
-- support for new languages, including Perl, Python and Ruby was added
? Mauritz Jeanson: pi.xsl
Clarified usage of table PIs (only bgcolor works for both CALS and HTML tables).
? Mauritz Jeanson: pi.xsl
"lines" -> "line".
? Robert Stayton: table.xsl
Fix bug in table.width where it wasn't using the tgroup
context for computing column widths.
? Mauritz Jeanson: autotoc.xsl
Removed "." from the nodes variable in the set.toc template.
? Keith Fahlgren: Makefile
Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN
HTML
The following changes have been made to the html code since the 1.74.0 release.
? Robert Stayton: html.xsl
Modified comment only.
? Robert Stayton: admon.xsl; autotoc.xsl; chunk-common.xsl; lists.xsl;
titlepage.xsl; graphi ?¯
Change align="left" to use $direction.align.start instead,
and change align="right" to use $direction.align.end instead.
? Robert Stayton: param.xweb; docbook.xsl; param.ent; html.xsl
Add support for writing.mode to set text direction and alignment
based on document locale.
? Mauritz Jeanson: sections.xsl
Added <xsl:when> for subtitle in section.heading template. Closes bug #2329704.
? Robert Stayton: table.xsl
Fix bug in computation of nextspans variable when there are
skipped columns and spanning across columns.
? Mauritz Jeanson: chunk-changebars.xsl
Added SVN keywords.
? Mauritz Jeanson: chunk-changebars.xsl
Added a new top-level stylesheet module, chunk-changebars.xsl, to be
used for generating chunked output with highlighting based on change
(@revisionflag) markup. The module imports/includes the standard chunking
and changebars templates and contains additional logic for chunked output.
See FRs #1015180 and #1819915.
? Mauritz Jeanson: changebars.xsl
Reorganized by adding a named template (to enable code reuse).
? Mauritz Jeanson: table.xsl
Modified declaration of the "col" parameter in the template with
match="entry|entrytbl". This is a workaround for bug #1816373.
The parameter was reset to 1 for cells with @revisionflag when
using changebars.xsl, which resulted in malformed output.
? David Cramer: footnote.xsl
Added a check to confirm that a footnoteref's linkend points to a footnote. Stylesheets stop processing if not and provide a useful error message.
? Mauritz Jeanson: graphics.xsl
Replaced
elements with warning messages (textinsert extension).
? Mauritz Jeanson: htmltbl.xsl
Sorry about r8102: tbody, thead, and tfoot are OK in HTML tables.
? Mauritz Jeanson: htmltbl.xsl
Removed superfluous thead, tbody and tgroup in match attribute (leaving only tr).
? Mauritz Jeanson: pi.xsl
Reverted the temporary r8075 change.
? Mauritz Jeanson: toc.xsl
Removed duplicate templates. Closes bug #2034582.
? Jirka Kosek: highlight.xsl
Improved default color scheme for XML markup
? Jirka Kosek: param.ent; param.xweb; highlight.xsl
Upgraded to support the latest version of XSLTHL 2.0
-- nested markup in highlited code is now processed
-- it is no longer needed to specify path XSLTHL configuration file using Java property
-- support for new languages, including Perl, Python and Ruby was added
? Mauritz Jeanson: pi.xsl
More snapshot testing.
? Mauritz Jeanson: pi.xsl
"lines" -> "line".
? Mauritz Jeanson: pi.xsl
Clarified that the table PIs are for CALS tables.
Manpages
The following changes have been made to the manpages code since the 1.74.0
release.
? Michael(tm) Smith: docbook.xsl
Put the following at the top of generated roff for each page:
\" t
purpose is to explicitly tell AT&T troff that the page needs to be
pre-processed through tbl(1); groff can figure it out
automatically, but apparently AT&T troff needs to be explicitly told
? Michael(tm) Smith: utility.xsl
Suppress FC/F[] stuff unless man.output.better.ps.enabled is non-zero.
? Michael(tm) Smith: block.xsl; refentry.xsl; param.xweb; docbook.xsl;
param.ent; other.xsl; ?¯
This change closes bug 2013441 and makes man-page output generally
usable again on Solaris and other platforms that use AT&T troff
instead of groff.
The change was to add man.output.better.ps.enabled parameter, with
its default value set to zero.
If the value of the man.output.better.ps.enabled parameter is
non-zero, certain markup is embedded in each generated man page
such that PostScript output from the man -Tps command for that
page will include a number of enhancements designed to improve the
quality of that output.
If man.output.better.ps.enabled is zero (the default), no such
markup is embedded in generated man pages, and no enhancements are
included in the PostScript output generated from those man pages
by the man -Tps command.
WARNING: The enhancements provided by this parameter rely on
features that are specific to groff (GNU troff) and that are not
part of "classic" AT&T troff or any of its derivatives. Therefore,
any man pages you generate with this parameter enabled will be
readable only on systems on which the groff (GNU troff) program is
installed, such as GNU/Linux systems. The pages will not not be
readable on systems on with the classic troff (AT&T troff) command
is installed.
NOTE: The value of this parameter only affects PostScript output
generated from the man command. It has no effect on output
generated using the FO backend.
TIP: You can generate PostScript output for any man page by
running the following command:
man FOO -Tps > FOO.ps
You can then generate PDF output by running the following command:
ps2pdf FOO.ps
? Michael(tm) Smith: other.xsl
removed unnecessary namespaced stuff element names from strip-space list
Epub
The following changes have been made to the epub code since the 1.74.0 release.
? Keith Fahlgren: docbook.xsl
...continue that last commit, being slightly more generic in the CSS to get the desired output in ADE.
? Keith Fahlgren: docbook.xsl
Patch from Paul Norton of Adobe to get covers to look better in Adobe Digital Editions
? Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec/files/
v5cover.xml; bin/spec/sp ?¯
Patch contributed by Liza Daly to make ePub cover handling more generic. Additionally
DocBook 5.0's <cover> now has some limited support:
- should reference a cover in the OPF guide for a DocBook 5.0 test document
? Keith Fahlgren: bin/spec/files/isbn.xml; bin/spec/files/issn.xml; bin/spec/
files/biblioid. ?¯
Liza Daly reported that the dc:identifer-generation code was garbage (she was right).
Added new tests:
- should include at least one dc:identifier
- should include an ISBN as URN for dc:identifier if an ISBN was in the metadata
- should include an ISSN as URN for dc:identifier if an ISSN was in the metadata
- should include an biblioid as a dc:identifier if an biblioid was in the metadata
- should include a URN for a biblioid with @class attribute as a dc:identifier if an biblioid was in the metadata
? Keith Fahlgren: bin/spec/tools/obfuscate_regression_submission.xsl; bin/
spec/tools; bin/sp ?¯
An XSLT2 stylehseet to obfuscate the text of a DocBook document so that you can submit it as a failing test case (probably because of unhandled markup)
? Keith Fahlgren: docbook.xsl; bin/spec/epub_spec.rb
Improve both SEO and semantic structure of chunked ePub output by ensuring that
we always send out one and only one h1 in each XHTML chunk.
DocBook::Epub
- should include one and only one in each HTML file in rendered ePub files
for <book>s
- should include one and only one
in each HTML file in rendered ePub files
for <book>s even if they do not have section markup
? Keith Fahlgren: docbook.xsl; bin/spec/files/orm.book.001.xml
Only try to chunk bibliodiv[title] to prevent ???TITLE??? and OPF/NCX errors (regression included)
? Keith Fahlgren: bin/lib/docbook.rb; bin/spec/epub_realbook_spec.rb
epubcheck 1.0.3 actually sets an exit code properly, so use that instead of doing nasty output regexp.
? Keith Fahlgren: docbook.xsl
Fixing image @align attribute handling override (to just use what is in xhtml-1_1/graphics.xsl)
? Keith Fahlgren: bin/spec/README
Slightly clearer README for epub output developers running tests
? Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/
epub_realbook_spe ?¯
Adding patch from Liza Daly to fix problems with XHTML 1.1 DOCTYPES showing up in non-XHTML files
? Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
/orm.book.001.x ?¯
Better dc:publisher (ALWAYS WRITE TESTS FIRST!)
? Keith Fahlgren: docbook.xsl
Ignore anything else in *info for opf.metadata
? Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
/orm.book.001.x ?¯
Adding test for dc:rights properly populating from <copyright>
? Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb
Finishing support for covers in epub files destined for .mobi and the Kindle
? Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
/orm.book.001.x ?¯
Adding better support for covers in epub files destined for .mobi and the Kindle
? Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl
Fixing CSS mimetype bug reported by Liza Daly
? Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/
DejaVuSerif.otf; docbook. ?¯
Adding primitive support for embedding a single font
? Keith Fahlgren: bin/dbtoepub; bin/lib/docbook.rb; bin/spec/files/
test_cust.xsl; bin/spec/e ?¯
Adding support for user-specified customization layers in dbtoepub
? Keith Fahlgren: bin/spec/epub_regressions_spec.rb; docbook.xsl; bin/spec/
epub_spec.rb
Adding regression for dropped text in dedications and bookinfos
? Keith Fahlgren: docbook.xsl; bin/spec/epub_realbook_spec.rb; bin/spec/files
/orm.book.001.x ?¯
Adding support for proper dc:identifiers based on <isbn>
? Keith Fahlgren: bin/dbtoepub; bin/spec/epub_regressions_spec.rb; bin/lib/
docbook.rb; bin/s ?¯
Adding CSS support to .epub target & dbtoepub:
-c, --css [FILE] Use FILE for CSS on generated XHTML.
DocBook::Epub
...
- should include a CSS link in HTML files when a CSS file has been provided
- should include CSS file in .epub when a CSS file has been provided
- should include a CSS link in OPF file when a CSS file has been provided
? Keith Fahlgren: bin/spec
Get rid of the remaining SVN property cruft
? Keith Fahlgren: bin/spec/epub_regressions_spec.rb; bin/spec; bin/spec/
epub_small_smoketest ?¯
Removing testdocs svn:external
? Michael(tm) Smith: bin/spec; bin/spec/files; bin/spec/.gitignore; bin/spec/
files/.gitignor ?¯
set some ignores
HTMLHelp
The following changes have been made to the htmlhelp code since the 1.74.0
release.
? Keith Fahlgren: Makefile
Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN
Eclipse
The following changes have been made to the eclipse code since the 1.74.0
release.
? Keith Fahlgren: Makefile
Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN
JavaHelp
The following changes have been made to the javahelp code since the 1.74.0
release.
? Keith Fahlgren: Makefile
Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN
Roundtrip
The following changes have been made to the roundtrip code since the 1.74.0
release.
? Steve Ball: blocks2dbk.xsl; template.xml; template.dot
added support for imagedata-metadata
added support for table as images
? Steve Ball: blocks2dbk.xsl
added error checking for publisher-address
? Steve Ball: blocks2dbk.xsl
Fixed bug in emphasis
? Steve Ball: blocks2dbk.xsl
fixed bug in metadata processing
? Steve Ball: blocks2dbk.xsl; normalise2sections.xsl; sections2blocks.xsl
Improved support for personname inlines.
? Steve Ball: blocks2dbk.xsl; blocks2dbk.dtd; template.xml
Added support for legalnotice.
? Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl
added support for orgname in author
? Steve Ball: wordml2normalise.xsl
fix elimination of section breaks
? Steve Ball: wordml2normalise.xsl
Eliminate empty paragraphs due to section breaks
? Steve Ball: wordml2normalise.xsl
parameterise choice of image filename
? Steve Ball: blocks2dbk.xsl
fixed figure captions and associated figure metadata
? Steve Ball: blocks2dbk.xsl
handle weird EndnoteReference character style
added support for footnote in author paragraph
? Steve Ball: blocks2dbk.xsl; wordml2normalise.xsl
fixed tables in list items
handle Word track changes
? Steve Ball: blocks2dbk.xsl
fix metadata for non-article toplevels and divisions.
? Steve Ball: dbk2wp.xsl
fixed blockquote attribution.
fixed listitem para continuation.
? Steve Ball: specifications.xml; supported.xml; blocks2dbk.xsl;
wordml2normalise.xsl; dbk2w ?¯
Updated specification.
to-DocBook: add cols attribute to tgroup
from-DocBook: fix for blockquote title
? Keith Fahlgren: Makefile
Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN
Slides
The following changes have been made to the slides code since the 1.74.0
release.
? Mauritz Jeanson: fo/plain.xsl
Added template for foil and foilgroup in mode "xref-to". Closes bug #1913376.
? Mauritz Jeanson: fo/plain.xsl
Removed redundant calls to anchor template that were the cause of duplicate IDs.
Closes bug #1859831.
? Keith Fahlgren: xhtml/Makefile; fo/Makefile; html/Makefile
More stupid makefile changes for slides
? Keith Fahlgren: Makefile
Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN
Website
The following changes have been made to the website code since the 1.74.0
release.
? Mauritz Jeanson: website-common.xsl
Added Spanish localization. Closes bug #1876282.
? Keith Fahlgren: Makefile
Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN
Params
The following changes have been made to the params code since the 1.74.0
release.
? Michael(tm) Smith: man.output.better.ps.enabled.xml
This change closes bug 2013441 and makes man-page output generally
usable again on Solaris and other platforms that use AT&T troff
instead of groff.
The change was to add man.output.better.ps.enabled parameter, with
its default value set to zero.
If the value of the man.output.better.ps.enabled parameter is
non-zero, certain markup is embedded in each generated man page
such that PostScript output from the man -Tps command for that
page will include a number of enhancements designed to improve the
quality of that output.
If man.output.better.ps.enabled is zero (the default), no such
markup is embedded in generated man pages, and no enhancements are
included in the PostScript output generated from those man pages
by the man -Tps command.
WARNING: The enhancements provided by this parameter rely on
features that are specific to groff (GNU troff) and that are not
part of "classic" AT&T troff or any of its derivatives. Therefore,
any man pages you generate with this parameter enabled will be
readable only on systems on which the groff (GNU troff) program is
installed, such as GNU/Linux systems. The pages will not not be
readable on systems on with the classic troff (AT&T troff) command
is installed.
NOTE: The value of this parameter only affects PostScript output
generated from the man command. It has no effect on output
generated using the FO backend.
TIP: You can generate PostScript output for any man page by
running the following command:
man FOO -Tps > FOO.ps
You can then generate PDF output by running the following command:
ps2pdf FOO.ps
? Mauritz Jeanson: hyphenate.verbatim.characters.xml
A very small update.
? Mauritz Jeanson: callout.list.table.xml
Made a few small fixes to the description.
? Mauritz Jeanson: highlight.source.xml
Corrected parameter name.
? Mauritz Jeanson: use.role.as.xrefstyle.xml
Updated description.
? Robert Stayton: writing.mode.xml
writing mode param used to set text direction.
? Jirka Kosek: footnote.mark.properties.xml
Do not inherit font-family from surrounding text
? Mauritz Jeanson: default.units.xml; page.width.xml; body.font.size.xml;
body.font.master.x ?¯
Some small updates of parameter documentation.
? Mauritz Jeanson: refentry.generate.name.xml; refentry.generate.title.xml;
annotate.toc.xml
Made element names lowercase.
? Mauritz Jeanson: component.titlepage.properties.xml
Updated documentation (see r8111).
? Michael(tm) Smith: email.mailto.enabled.xml
Added new param email.mailto.enabled for FO output.
Patch from Paolo Borelli. Closes #2086321.
? Jirka Kosek: highlight.source.xml; highlight.xslthl.config.xml
Upgraded to support the latest version of XSLTHL 2.0
-- nested markup in highlited code is now processed
-- it is no longer needed to specify path XSLTHL configuration file using Java property
-- support for new languages, including Perl, Python and Ruby was added
? Mauritz Jeanson: abstract.notitle.enabled.xml
Whitespace changes only (to test the snapshot system).
? Mauritz Jeanson: variablelist.as.table.xml;
index.preferred.page.properties.xml
Fixed typos.
Highlighting
The following changes have been made to the highlighting code since the 1.74.0
release.
? Mauritz Jeanson: common.xsl
Fixed a little detail.
? Mauritz Jeanson: common.xsl
Removed declaration of "d" namespace prefix (the xslns-build script adds it
for the XSL-NS distribution).
? Jirka Kosek: cpp-hl.xml; c-hl.xml; tcl-hl.xml; php-hl.xml; common.xsl;
perl-hl.xml; delphi ?¯
Upgraded to support the latest version of XSLTHL 2.0
-- nested markup in highlited code is now processed
-- it is no longer needed to specify path XSLTHL configuration file using Java property
-- support for new languages, including Perl, Python and Ruby was added
Lib
The following changes have been made to the lib code since the 1.74.0 release.
? Keith Fahlgren: Makefile
Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN
Tools
The following changes have been made to the tools code since the 1.74.0
release.
? Michael(tm) Smith: xsl/build/xsl2jref.xsl
unbreak the build
? Mauritz Jeanson: xsl/build/jref2refsect1.xsl
Added "Description" title for refdescription.
? Mauritz Jeanson: xsl/build/tdg-link.xsl
Changed "tdg-baseuri" to http://docbook.org/tdg5/en/html/ (since the DB 5 schema
is used to generate docbook-elements.xsl).
? Mauritz Jeanson: xsl/build/reference-fo.xsl
Removed junk.
Extensions
The following changes have been made to the extensions code since the 1.74.0
release.
? Keith Fahlgren: Makefile
Get rid of the rest of the hardcoded buildtools references and actually use DOCBOOK_SVN
XSL-Saxon
The following changes have been made to the xsl-saxon code since the 1.74.0
release.
? Mauritz Jeanson: src/com/nwalsh/saxon/ImageIntrinsics.java; src/com/nwalsh/
saxon/LineCount ?¯
Cleaned up import statements.
XSL-Xalan
The following changes have been made to the xsl-xalan code since the 1.74.0
release.
? Mauritz Jeanson: src/com/nwalsh/xalan/Callout.java; src/com/nwalsh/xalan/
FormatUnicodeCall ?¯
Cleaned up import statements.