1.11.2

Fixes a bug (#221) where attempting to use a locale that doesn't exist would cause the transformation to fail.

2.0.0

This is a pre-release. This verison has substantial backwards-incompatible changes.

• The system for dealing with generated text has been completely rewritten. We’re back to using templates as described in Chapter 4 of the updated reference guide. Most of the parameters, variables, and functions associated with gentext have been removed.
• It’s likely that there are small changes to the way lists-of-titles and cross references are formatted by default in some cases.
• Labels for formal objects may be different, but I think these changes actually fix previously unreported bugs.
• In some contexts, for example callouts, labels are now used for the links instead of titles.
• The parameters for the t:top-nav and t:bottom-nav templates have changed. These templates are now always called, even when chunking is not being performed. The new $chunk parameter indicates whether or not a chunk is being formatted.
• Fixed a bug where orderedlist numeration was not handled correctly in cross-references to list items.
• Made another attempt at sorting out how media object URIs are resolved in the source (for reading their properties) and formatted in the output. If the $mediaobject-input-base-uri is specified, it is always used.

There are probably other changes as well, fixing localization was a pretty substantial change.

Many customization layers will need to be updated before they’ll generate the right output. If you’re having trouble, please open up a bug report and I’ll try to help.

1.11.1

This update simply fixes a CSS issue in Firefox (#200) and removes a bit of debugging cruft that got left in.

1.11.0

This is a big release. I was on the fence about whether to call this 1.11.0 or 2.0.0. There aren't any fundamental breaking changes, it's mostly new EPUB support. But I did change the markup for media objects and some CSS. It's worth checking those areas before you deploy this to production.

• Added support for EPUB3 output.
• Reworked how media objects are processed
  • Reworked how contentwidth, contentdepth, width, depth, scalefit, and scale are handled. Width and height (depth) are now processed independently. The results are supposed to be the same as before.
  • It now makes sense to have both multiple imageobject elements and multiple imagedata elements with an imageobject. (And, analogously, multiple videoobject elements with multiple videodata, and multiple audioobject elements with multiple audiodata inside.)
    • The stylesheets select the first object for which none of the data elements are excluded by $mediaobject-exclude-extensions and then process all of the data elements inside.
      • For images, all of the alternatives are placed in a picture element using source and img.
      • For videos, all of the alternatives are placed in a video element using source unless the $mediaobject-video-element is iframe.
      • For audio, all of the alternatives are placed in an audio elemnt using source.
    • The fallback for audio and video elements is a paragraph that offers download links. This can be configured by overriding the t:audio-fallback and t:video-fallback templates, respectively.
    • Use db:multimediaparams to specify the controls for audio and vidoe objects. If no parameters are specified, controls will be added automatically. (If you specify any parameters, you are responsible for specifying the controls parameter.)
    • If you have multiple data elements in an object, only the attributes associated with the last alternative are considered when calculating the viewport, alignment, etc. This is (a) consistent with HTML, and (b) at least partly justifiable by the observation that for scalable formats like SVG, it doesn’t make sense to say that the image has a particular height or width. Specify that on the raster fallback image where it makes sense.
  • The actual nesting of divs and spans and some of the class values have changed. Check your CSS.
  • Fixed a bug where the summary accesibility attribute was not always output.
  • Reworked image maps.
    • Simpified the code for computing how calspair coordinates are calculated.
    • Added support for html-rect, html-circle, and html-poly styles. Use units="other" and place the new styles in otherunits. See the calloutlist.005.xml unit test for examples.
    • Changed the $mediaobject-exclude-extensions parameter into space-delimited string so that it’s easier to pass as a parameter. The variable $v:mediaobject-exclude-extensions is a list constructed from the string.
    • Added $mediaobject-video-element parameter.
    • Changed f:parse-length() so that it accepts xs:string? and returns an empty sequence if it’s passed one.
    • Added support for db:textdata. If a text data element is present, the first one encountered is used (unless it contains only a single db:phrase as those where historically used for alt text).
• The icons used for admonitions have been changed. One or two of them didn’t show up in EPUB readers.
• Updated the extension functions that attempt to extract metadata from images so that they accept filenames that aren’t URIs. Also added support for a second “image” parameter, so that you can prevent them from attempting to parse, for example, a video as an image.
• Added convenience variables $v:as-xml and $v:as-json for convenience in calls to fn:serialize(). Mostly this is for debugging.
• Reworked how the preprocessing pipeline is evaluated.
• Switched to using Sass to generate CSS.
• Fixed a bug in link processing that sometimes resulted in nested anchors.
• Fixed bug where unnumbered verbatim listings still had room for line numbers.

1.10.1

This release adds support for enumsynopsis.

1.10.0

This release reworks how verbatim listings are formatted. The changes should be invisible on a browser using CSS, but much improved in text browsers and perhaps other environments.

1.9.1

This release contains some build improvements for users who want to build it from source and some documentation improvements.

1.9.0

This release introduce a performance improvement. Pre-compiled stylesheets are included for the standard pre-processing transforms (structural tidying, XInclude processing, transclusion processing, annotation processing, etc.). If you're using a recent version of Saxon to run the stylesheets, this will avoid the cost of preparing those stylesheets for execution each time.

If you find that they cause problems, now or in the future, you can disable them by setting $use-compiled-transforms to false. That variable is false by default for other processors.

1.8.1

What's Changed

• Make sure link to PDF is persistent by @ndw in #168
• Use Docker tag docbook-xsltng consistently by @tomschr in #169
• Fix error in processing 'sortas' on 'glossentry' by @ndw in #172
• Fix bug in orderedlist continuations, resolve languages at runtime by @ndw in #175

New Contributors

• @tomschr made their first contribution in #169

Full Changelog: 1.8.0...1.8.1

Vesion 1.8.0

This release has a few bug fixes, but is also backwards-incompatible with respect to how CSS links are generated. It's a ".0" version so test thoroughly before using it in production.

What's Changed

• Don't call resolve-uri if it isn't necessary, fix #152
• Handle 'null' tag descriptions, fix #157
• Improve verbatim continuations, fix #156
• Allow admonitions in questions (and others), fix #155
• Propagated role values to HTML table cell class attribute values, fix #154
• Process calloutlist inside imageobjectco, fix #153
• Reworked CSS. The css-links parameter no longer exists (or the v:css-links variable). Added user-css-links and use-docbook-css. The way CSS links are generated has been changed. The underlying CSS, especially the print CSS, has been changed.
• Added an output-media parameter that has the value screen or print depending on the output media target.
• Added page-style and paper-size parameters for print rendering. These appear as class attribute values on the html element.
• Add document status as a class attribute value on the html element. Added CSS support for a draft watermark.
• Added new class attribute values component, division, formalobject, and informalobject to make grouping chapters, appendixes, etc, easier. Especially for print output.
• Fixed a bug where sidebar was accidentally rendered in the DocBook namespace.
• Updated Prism.js and Highlight.js versions. Added Highlight.js to the distribution instead of relying on CDN access.
• Build cleanup for JDK 8 builds.

Full Changelog: 1.7.1...1.8.0