docbook-apps message

Subject: ANNOUNCE: DocBook XSL Stylesheets 1.74.1 released

From: DocBook Project <docbook-dev@xml-doc.org>
To: docbook-apps@lists.oasis-open.org
Date: Tue, 17 Feb 2009 17:10:44 -0800 (PST)

Version 1.74.1 of the DocBook XSL Stylesheets, for processing
non-namespaced (DocBook 4 or earlier) documents, is now available:

http://docbook.sf.net/files/xsl/latest

The 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/current/doc/
http://docbook.sf.net/release/xsl/current/RELEASE-NOTES.html

Release 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

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 <a> 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

● 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 <h1> in each HTML file in rendered ePub files
for <book>s
- should include one and only one <h1> 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