[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: ANNOUNCE: DocBook XSL 1.73.0 released
The DocBook Project wishes to announce that version 1.73.0 of the DocBook XSL Stylesheets is now available for download from the project website: http://docbook.sf.net/files/xsl/latest http://sourceforge.net/projects/docbook The DocBook XSL Stylesheets are designed for processing non-namespaced (DocBook 4 or earlier) documents. The reference docs are packaged separately and downloadable from: http://docbook.sf.net/files/xsl-doc/latest The 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.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-NOTES.html http://docbook.sf.net/release/xsl/current/RELEASE-NOTES.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).
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]