[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: ANNOUNCE: DocBook XSL 1.72.0 released
The DocBook Project wishes to announce that version 1.72.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 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 ------------------------------------------------------------------------------ This release includes important bug fixes and adds the following significant feature changes: Automatic sorting of glossary entries The HTML and FO stylesheets now support automatic sorting of glossary entries. To enable glossary sorting, set the value of the glossary.sort parameter to 1 (by default, its value is 0). When you enable glossary sorting, glossentry elements within a glossary, glossdiv, or glosslist are sorted on the glossterm, using the current language setting. If you dont enable glossary sorting, then the order of glossentry elements is left as is that is, they are not sorted but are instead just displayed in document order. WordML renamed to Roundtrip, OpenOffice support added Stylesheets for roundtrip conversion between documents in OpenOffice format (ODF) and DocBook XML have been added to the set of stylesheets that formerly had the collective title WordML, and that set of stylesheets has been renamed to Roundtrip to better reflect the actual scope and purpose of its contents. So the DocBook XSL Stylesheets now support roundtrip conversion (with certain limitations) of WordML, OpenOffice, and Apple Pages documents to and from DocBook XML. Including QandASet questions in TOCs The HTML stylesheet now provides support for including QandASet questions in the document TOC. To enable display of questions in the document TOC, set the value of the qanda.in.toc to 1 (by default, its 0). When you enable qanda.in.toc, then the generated table of contents for a document will include qandaset titles, qandadiv titles, and question elements. The default value of zero excludes them from the TOC. Note The qanda.in.toc parameter does not affect any tables of contents that may be generated within a qandaset or qandadiv (only in the document TOC). Language identifier in man-page filenames and pathnames Added new parameter man.output.lang.in.name.enabled, which controls whether a language identifier is included in man-page filenames and pathnames. It works like this: If the value of man.output.lang.in.name.enabled is non-zero, man-page files are output with a language identifier included in their filenames or pathnames as follows: * if man.output.subdirs.enabled is non-zero, each file is output to, e.g., a /$lang/man8/foo.8 pathname * if man.output.subdirs.enabled is zero, each file is output with a foo.$lang.8 filename index.page.number.properties property set For FO output, use the index.page.number.properties to control formatting of page numbers in index output to (for example) to display page numbers in index output in a different color (to indicate that they are links). Crop marks in output from Antenna House XSL Formatter Support has been added for generating crop marks in print/PDF output generated using Antenna House XSL Formatter More string-substitution hooks in manpages output The man.string.subst.map.local.pre and man.string.subst.map.local.post parameters have been added to enable easier control over custom string substitutions. Moved verbatim properties to attribute-set The hardcoded properties used in verbatim elements (literallayout, programlisting, screen) were moved to the verbatim.properties attribute-set so they can be more easily customized. enhanced simple.xlink template Now the simple.xlink template in inline.xsl works with cross reference elements xref and link as well. Also, more elements call simple.xlink, which enables DB5 xlink functionality. DocBook 5 compatibility Stylesheets now consistently support DocBook 5 attributes (such as xml:id). Also, DocBook 5 info elements are now checked along with other *info elements, and the use of name() function was replaced by local-name() so it also matches on DocBook 5 elements. These changes enable reusing the stylesheets with DocBook 5 documents with minimal fixup. HTML class attributes now handled in class.attribute mode The HTML class attributes were formerly hardcoded to the element name. Now the class attribute is generated by applying templates in class.attribute mode so class attribute names can be customized. The default is still the element name. arabic-indic numbering enabled in autolabels Numbering of chapter, sections, and pages can now use arabic-indic numbering when number format is set to 'arabicindic' or to . The following is a detailed list of changes (not including bug fixes) that have been made since the 1.71.1 release. Common The following changes have been made to the common code since the 1.71.1 release. * Add support for arabicindic numbering to autolabel.format template. * Finish support for @xml:id everywhere @id is used. * replace name() with local-name() in most cases. * Add support for info. * Add utility template tabstyle to return the tabstyle from any table element. FO The following changes have been made to the fo code since the 1.71.1 release. * Add support for sorting glossary entries * Add table.row.properties template to customize table rows. * Moved all properties to attribute-sets so can be customized more easily. * Add index.page.number.properties attribute-set to format page numbers. * xref now supports xlink:href, using simple.xlink template. * Rewrote simple.xlink, and call it with all charseq templates. * Add simple.xlink processing to term and member elements. * Add support for crop marks in Antenna House. HTML The following changes have been made to the html code since the 1.71.1 release. * Add support for sorting glossary entries * Add support for qanda.in.toc to add qandaentry questions to document TOC. * add simple.xlink support to variablelist term and simplelist member. * *.propagates.style now handled in class.attribute mode. * add class parameter to class.attribute mode to set default class. * Convert all class attributes to use the class.attribute mode so class names can be customized more easily. * Add class.attribute mode to generate class attributes. * Added simple.xlink to most remaining inlines. Changed class attributes to applying class.attributes mode. * Changed xref template to use simple.xlink tempalte. * Improve generate.html.title to work with link targets too. * Improved simple.xlink to support link and xref. * Use new link.title.attribute now. * Rewrote simple.xlink to handle linkend also. Better computation of title attribute on link too. * Handle Xalan quirk as special case. * Add support for info. * Fixed imagemaps so they work properly going from calspair coords to HTML area coords. Manpages The following changes have been made to the manpages code since the 1.71.1 release. * Added doc for man.output.lang.in.name.enabled parameter. This checkin completes support for writing file/pathnames for man-pages with $lang include in the names. Closes #1585967. knightly accolades to Daniel Leidert for providing the feature request. * Added new param man.output.lang.in.name.enabled, which controls whether $LANG value is included in manpages filenames and pathnames. It works like this: If the value of man.output.lang.in.name.enabled is non-zero, man-page files are output with the $lang value included in their filenames or pathnames as follows; - if man.output.subdirs.enabled is non-zero, each file is output to, e.g., a /$lang/man8/foo.8 pathname - if man.output.subdirs.enabled is zero, each file is output with a foo.$lang.8 filename * Use "\e" instead of "\\" for backslash output, because the groff docs say that's the correct thing to do; also because testing (thanks, Paul Dubois) shows that "\\" doesn't always work as expected; for example, "\\" within a table seems to mess things up. * Added the man.string.subst.map.local.pre and man.string.subst.map.local.post parameters. Those parameters enable local additions and changes to string-substitution mappings without the need to change the value of man.string.subst.map parameter (which is for standard system mappings). Closes #1456738. Thanks to Sam Steingold for constructing a true stylesheet torture test (the clisp docs) that exposed the need for these params. * Added the Markup element to the list of elements that get output in bold. Thanks to Eric S. Raymond. * Replaced all dots in roff requests with U+2302 ("house" character), and added escaping in output for all instances of dot that are not in roff requests. This fixes the problem case where a string beginning with a dot (for example, the string ".bashrc") might occur at the beginning of a line in output, in which case would mistakenly get interpreted as a roff request. Thanks to Eric S. Raymond for pushing to fix this. * Made change to ensure that list content nested in itemizedlist and orderedlist instances is properly indented. This is a switch from using .TP to format those lists to using .RS/.RE to format them instead (because .TP does not allow nesting). Closes bug #1602616. Thanks to Daniel Leidert. Params The following changes have been made to the params code since the 1.71.1 release. * Added doc for man.output.lang.in.name.enabled parameter. This checkin completes support for writing file/pathnames for man-pages with $lang include in the names. Closes #1585967. knightly accolades to Daniel Leidert for providing the feature request. * Added new param man.output.lang.in.name.enabled, which controls whether $LANG value is included in manpages filenames and pathnames. It works like this: If the value of man.output.lang.in.name.enabled is non-zero, man-page files are output with the $lang value included in their filenames or pathnames as follows; - if man.output.subdirs.enabled is non-zero, each file is output to, e.g., a /$lang/man8/foo.8 pathname - if man.output.subdirs.enabled is zero, each file is output with a foo.$lang.8 filename * Added the man.string.subst.map.local.pre and man.string.subst.map.local.post parameters. Those parameters enable local additions and changes to string-substitution mappings without the need to change the value of man.string.subst.map parameter (which is for standard system mappings). Closes #1456738. Thanks to Sam Steingold for constructing a true stylesheet torture test (the clisp docs) that exposed the need for these params. * Add index.page.number.properties by default. * Added index.page.number.properties to allow customizations of page numbers in indexes. * Move show-destination="replace" property from template to attribute-set so it can be customized. * Add support for sorting glossary entries * Add option to include qanda in tables of contents. * Moved all properties to attribute-sets so can be customized more easily. Template The following changes have been made to the template code since the 1.71.1 release. * Added workaround for Xalan bug: use for-each and copy instead of copy-of (#1604770). Roundtrip The following changes have been made to the roundtrip code since the 1.71.1 release. * rename to roundtrip, add OpenOffice support
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]