OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[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]