Release Notes for the DocBook XSL Stylesheets
$Revision: 9697 $ $Date: 2012-12-18 $
Release Notes: 1.78.0
The following is a list of changes that have been made since the 1.77.1
release.
Gentext
The following changes have been made to the gentext code since the 1.77.1
release.
- Mauritz Jeanson: locale/nn.xml; locale/nb.xml
Bug #3556630: Updated nb and nn locale files.
- Mauritz Jeanson: locale/README
Bug #3556628: Updated information in README.
- tom_schr: locale/de.xml
Added keycap context from RFE#3540451 to support @function attribute
- tom_schr: locale/en.xml
Added keycap context from RFE#3540451 to support @function attribute
- Robert Stayton: locale/en.xml
Add support for title element in screenshot, now allowed in DocBook 5.
Common
The following changes have been made to the common code since the 1.77.1
release.
- Robert Stayton: titles.xsl
Corrected template for bridgehead in mode="title.markup" to
process its children in normal mode.
- Robert Stayton: labels.xsl
Convert hard wired xsl:number for production into a template
with mode="label.markup" to be consistent with other element numbering.
- Robert Stayton: olink.xsl
Remove all references and code for obsolete olink attributes
@linkmode @targetdocent and @localinfo.
- Robert Stayton: olink.xsl
Add parameter 'activate.external.olinks' to allow making
external olinks inactive, as for epub output.
FO
The following changes have been made to the fo code since the 1.77.1 release.
- Robert Stayton: pagesetup.xsl
Change initial page number for book from 1 to auto so front
cover and title pages are sequential, and so that book inside
set will continue numbering.
- Robert Stayton: inline.xsl
Add missing closing tag for xsl:choose in new template.
- Robert Stayton: param.xweb; param.ent; pagesetup.xsl
Add force.blank.pages parameter to allow turning off blank
pages in double.sided output.
- Robert Stayton: lists.xsl; callout.xsl
Implement active links between co and callout elements for
PDF output, linking in both directions.
- Robert Stayton: table.xsl
Fix typo to replace "ro" with "row" in three places.
- Robert Stayton: ebnf.xsl
Convert hard wired xsl:number for production into a template
with mode="label.markup" to be consistent with other element numbering.
- Robert Stayton: inline.xsl
Make comma inserted after function/parameter or function/replaceable
conditional on $function.parens to be consistent with the function template.
- tom_schr: inline.xsl
Added new inline.sansseq template for consistency reasons.
Makes it easier for customization layers: Just use
<xsl:call-template name="inline.sansseq"/>
to change to sans serif font, but also takes into account
XLinks and direction of text.
- Robert Stayton: xref.xsl
Remove all references and code for obsolete olink attributes
@linkmode @targetdocent and @localinfo.
- Robert Stayton: table.xsl
Remove passivetex.extensions code.
- Robert Stayton: spaces.xsl; autotoc.xsl; docbook.xsl; division.xsl;
table.xsl; sections.xs⋯
Remove all passivetex code because it is obsolete.
- Robert Stayton: param.xweb; param.ent
Add parameter 'activate.external.olinks' to allow making
external olinks inactive, as for epub output.
- Mauritz Jeanson: table.xsl
Added support for keep-together PI on informaltable. Closes bug #3555609.
- tom_schr: verbatim.xsl
Fixed subtle typo when calling lastLineNumber template: must be $listing instead of listing
- tom_schr: autoidx.xsl
Fixed typo: fole -> role attribute for phrase
- tom_schr: inline.xsl
Added support for @function attribute in keycap (uses keycap context
from language files) => fixes RFE#3540451
If @function is set and keycap is empty, then template will use the
content from the keycap context, otherwise it will use just the given
text
- Robert Stayton: graphics.xsl; xref.xsl
Add support for title element in screenshot, now allowed in DocBook 5.
- Robert Stayton: graphics.xsl
Restore formatting of figure/caption that was broken in 1.77.1.
HTML
The following changes have been made to the html code since the 1.77.1 release.
- David Cramer: autotoc.xsl
Fixing bug where toc.title.p and nodes params had not been declared inside manual-toc template
- Robert Stayton: autotoc.xsl
Add 'toc.list.attributes' template to insert class and other
attributes on the top level list element in a table of contents.
- Robert Stayton: block.xsl
Fix bug 3590039 abstract/title not rendered.
- Jirka Kosek: chunk-common.xsl; footnote.xsl
Fixed positioning of footnote separate when CSS decoration is used.
- Robert Stayton: ebnf.xsl
Convert hard wired xsl:number for production into a template
with mode="label.markup" to be consistent with other element numbering.
- Robert Stayton: inline.xsl
Make comma inserted after function/parameter or function/replaceable
conditional on $function.parens to be consistent with the function template.
- Robert Stayton: graphics.xsl
Add support for mediaobject/alt, with precedence over
mediaobject/textobject/phrase.
- Robert Stayton: param.xweb
Remove src:fragref elements for deleted obsolete olink params.
- Robert Stayton: chunker.xsl
Fix bug #3563697 where template make-relative-filename was using a
global param chunk.base.dir instead of its local param base.dir. Now it uses base.dir.
- Robert Stayton: param.xweb; param.ent; xref.xsl
Remove all references and code for obsolete olink attributes
@linkmode @targetdocent and @localinfo.
- Robert Stayton: param.xweb; param.ent
Add parameter 'activate.external.olinks' to allow making
external olinks inactive, as for epub output.
- stefan: graphics.xsl
Add hook for customization.
- tom_schr: docbook.xsl
Splitting head.content into smaller chunks of templates.
See https://lists.oasis-open.org/archives/docbook-apps/201209/msg00037.html
- tom_schr: verbatim.xsl
Fixed subtle typo when calling lastLineNumber template: must be $listing instead of listing
- Robert Stayton: footnote.xsl
Fix bug in footnote link introduced in 1.77.1.
- Robert Stayton: formal.xsl; htmltbl.xsl
Resolve conflict of duplicate ids on html table with caption.
Wrap a div with class and id attribute around html table without caption.
- Robert Stayton: component.xsl
Remove call to 'generate.id' template in <h1> in component.title because the
id is already generated for the parent div element.
- Robert Stayton: chunker.xsl
Set omit-xml-declaration to 'yes' for write.text.chunk template, since a text
file should never have an xml declaration.
- tom_schr: inline.xsl
Added support for @function attribute in keycap (uses keycap context
from language files) => fixes RFE#3540451
If @function is set and keycap is empty, then template will use the
content from the keycap context, otherwise it will use just the given
text
- David Cramer: docbook.xsl
Also set the title param in head.content since it's sometimes
called without that param being passed in. Use the passed-in
value in user.head.title.
- Robert Stayton: docbook.xsl
Restore missing title param on 'head.content' template, and passed
it along to user.head.title. That param
is used for certain special chunkings such as Long Descriptions.
- Robert Stayton: graphics.xsl; xref.xsl
Add support for title in screenshot, available since DocBook 5.
- David Cramer: docbook.xsl
HTML: Add hook for easily customizing html/head/title
Manpages
The following changes have been made to the manpages code since the 1.77.1
release.
- Robert Stayton: lists.xsl
Add a line break at start of variablelist to fix bug #3595156.
- Robert Stayton: lists.xsl
Better fix for bug #3545150 by putting the title with the step number
rather than before it.
- Robert Stayton: utility.xsl
Add 'content' param to template name inline.monoseq to support
email format, fixing bug #3524417.
- Robert Stayton: utility.xsl
Fix bug #3512473 where an inline synopsis element produced
an extra line break in nroff output.
- Robert Stayton: lists.xsl
Fix bug 3545150 where procedure/step/title not rendered in man pages.
Roundtrip
The following changes have been made to the roundtrip code since the 1.77.1
release.
- Robert Stayton: dbk2wordml.xsl
Fix bug #3297553 error in Word metadata elements from including
WordML markup instead of just text.
Slides
The following changes have been made to the slides code since the 1.77.1
release.
- gaborkovesdan: xhtml/plain.xsl
- Use real push-style processing in the foil/foilgroup page content, which
allows better customization in general (e.g. you can add PI templates)
and also let us render scattered speakernotes/handoutnotes if that is
desired
- gaborkovesdan: xhtml/Makefile
- Titlepage markup belongs to the XHTML namespace
- gaborkovesdan: xhtml/plain.xsl
- Remove now unnecessary template redefinition
- gaborkovesdan: xhtml/plain.xsl
- Generate valid links from cross-references
- gaborkovesdan: xhtml/plain.xsl
- Do not add fallbacks for EXSLT extensions, the main DocBook XSL stylesheets
do not do that either
- Robert Stayton: schema/relaxng/slides.rnc
Update the import path for docbook.rnc after the slides directory was moved.
- stefan: xhtml/plain.xsl
Add missing stylesheet.
- stefan: schema/xsd/Makefile; schema/Makefile; schema/relaxng/Makefile
Adjust Makefiles.
- stefan: locatingrules.xml; RELEASE-NOTES.xml; doc; images;
locatingrules.xml; Makefile; im⋯
Moved many files from slides/ to xsl/slides/
- stefan: fo/param.xweb; xhtml/Makefile; xhtml/param.xweb; fo/Makefile
Separate slides package.
- stefan: Makefile
A bit of cleanup...
- stefan: xhtml/Makefile; fo/Makefile
Add to 'clean' target.
- David Cramer: Makefile
Slides: Change html to xhtml passim.
- David Cramer: xhtml
Adding items to svn ignore for slides
- stefan: slidy
Import slidy from vendor branch.
- stefan: s5
Import s5 from vendor branch.
- stefan: Makefile; common/common.xsl; common; fo/param.ent; graphics; xhtml/
Makefile.param;⋯
Merge Slides GSoC project to trunk.
Webhelp
The following changes have been made to the webhelp code since the 1.77.1
release.
- David Cramer: docsrc/readme.xml
Webhelp: More doc updates
- David Cramer: docsrc/readme.xml
Webhelp: Documentation updates.
- David Cramer: template/content; Makefile; Makefile.sample; build.xml;
template/search
Webhelp: Improving sample Makefile to allow for profiling params and other params, removing content dir from template and making related adjustments in Makefile and build.xml
- David Cramer: Makefile.sample
Attempting to include sample Makefile in webhelp output dir
- David Cramer: template/common/css/positioning.css
Webhelp: Do not display sidebar if js is disabled in browser since it will not be functional
- Jirka Kosek: build.xml
Xerces must be on the classpath in order to XInclude work
- David Cramer: Makefile
Adding generated files to various clean targets.
- David Cramer: build.properties
Webhelp: By default don't validate against dtd when using ant build
- David Cramer: Makefile
Webhelp: By default only exclude ix01.html from search in Makefile
- David Cramer: template/common/jquery/jquery-ui-1.8.2.custom.min.js;
template/common/jquery⋯
Webhelp: Reverting last commit
- David Cramer: template/common/jquery/jquery-ui-1.8.2.custom.min.js;
template/common/jquery⋯
Webhelp: Removing two more unused jquery files
- David Cramer: template/common/jquery/jquery-1.4.2.min.js
Webhelp: Removing old, unused jquery file
- David Cramer: xsl/webhelp-common.xsl
Webhelp: Fix header logo link
- David Cramer: xsl/webhelp-common.xsl
Webhelp: Fix bad link to favicon.ico
- David Cramer: template/common/jquery/jquery-1.7.2.min.js; template/common/
main.js; templat⋯
First part of the GSoC 2012 work by Arun and Visitha:
Visitha Baddegama
Remove content folder from Webhelp output
Build Webhelp using GNU Make/without ant
Support a parameterized list of files to exclude while indexing
Improve information message for browser with JavaScript disabled
Support searching for terms with punctuation like build.xml
Arun Bharadwaj
Make it possible to include the doc title in head/title and
not in the search results
Improve performance in IE 8/9
Expandable TOC pane
Information message for browser with JavaScript disabled
- David Cramer: xsl/webhelp-common.xsl
Use user.head.title to add title to webhelp pages,
but do not yet add the book title to the page title.
- David Cramer: xsl/webhelp-common.xsl
Webhelp: Revert 9433. We need to fix the indexer before we can include the document title in the html/head/title
- David Cramer: xsl/webhelp-common.xsl
Webhelp: Append document title to html/head/title
- David Cramer: xsl/webhelp-common.xsl
Webhelp: fix missing reference to ie.css
Params
The following changes have been made to the params code since the 1.77.1
release.
- Robert Stayton: page.height.portrait.xml; page.width.portrait.xml
Add USlegal and USlegallandscape.
- Robert Stayton: force.blank.pages.xml
Improve the description.
- Robert Stayton: page.margin.outer.xml; writing.mode.xml; double.sided.xml;
page.margin.inn⋯
Improve the description.
- Robert Stayton: force.blank.pages.xml
New param to control generating blank even-numbered pages.
- Robert Stayton: passivetex.extensions.xml
Indicate that passivetex is no longer supported.
- Robert Stayton: footnote.properties.xml
Fix bug #3555628 where a footnote inside a blockquote inherits the end-indent from the blockquote.
- stefan: foil.page-sequence.properties.xml; handoutnotes.properties.xml;
slidy.duration.xml⋯
Merge Slides GSoC project to trunk.
- Robert Stayton: activate.external.olinks.xml
Add parameter 'activate.external.olinks' to allow making
external olinks inactive, as for epub output.
Profiling
The following changes have been made to the profiling code since the 1.77.1
release.
- Robert Stayton: xsl2profile.xsl
Test for @xml:id as well as @id for $rootid.
Tools
The following changes have been made to the tools code since the 1.77.1
release.
- David Cramer: bin/docbook-xsl-update
s/VERSION/VERSION.xsl/ again.
- David Cramer: xsl/build/xsl-param-link.xsl; xsl/build/make-xsl-params.xsl
Slides: Change html to xhtml passim.
Template
The following changes have been made to the template code since the 1.77.1
release.
- Jirka Kosek: titlepage.xsl
Autoguess of proper parameter settings
Release Notes: 1.77.1
The following list summarizes the major changes that have been made since the
1.76.1 release. It is followed by sections detailing changes to individual
files from the SVN checkin logs, edited to remove housekeeping changes and bug
fixes. See the NEWS.xml file for a complete unedited list of SVN changes.
- Gentext
webhelp
Many improvements to the generated text for webhelp output.
- Common
Support more media types
Expanded list of supported filename extensions for media to include
video and audio, mostly for HTML5 and EPUB3 outputs.
Topic element
Add basic support for new topic element, which is available in DocBook
5.1. Generally a topic element will be used with assembly and may be
transformed to some other hierarchical element during processing, but
it can also be formatted as a plain topic.
- FO
Add para.properties attribute-set
Add a para.properties attribute-set that applies only to para elements.
That allows still using normal.para.spacing attribute-set for many
block elements for uniform spacing, but allows separate formatting of
para elements.
List of titles in article
Add support for List of Tables, List of Figures, etc. for articles and
other component-level elements. Includes a new template for each in
autotoc.xsl, new attribute-sets in titlepage.xsl, and new entries in
the titlepage.templates.xml file tu support customization.
Customizing links in FO
Add template mode simple.xlink.properties to allow easy customization
of formatting of links generated from elements that use the xlink
attributes. This extends link formatting beyond that of xref, link, and
olink which use xref.properties attribute-set.
Table caption
The caption element in an HTML table is now handled like a title in a
CALS table, using the formal.object.title template with all its
features, including placement. Now caption template in mode="htmlTable"
does nothing, because caption handled by formal.object.title template.
Also adds support for table caption element in a CALS table, placing it
after the table.
Graphics attribute handling
Refactored the big process.image template to use individual templates
such as image.width for most attributes to allow easier customization
of individual properties.
Side regions
Add support for side page regions in addition to header and footer
regions. This feature lets you add running content to the side margins,
and by default the content is rotated 90 degrees. Adds new templates
named running.side.content, region.inner and region.outer; new template
modes region.inner.mode and region.outer.mode; new parameters named
region.inner.extent, region.outer.extent, body.margin.inner,
body.margin.outer, and side.region.precedence; and new attribute-sets
named inner.region.content.properties, outer.region.content.properties,
region.inner.properties, and region.outer.properties.
Callout formatting
Add new attribute-sets for calloutlist.
Topic element
Add basic support for formatting a topic element, which is available in
DocBook 5.1.
- HTML
HTML5
Add variables to the base HTML stylesheets that can be adjusted for the
HTML5 stylesheets.
Insert Javascript reference
Add support for html.script param to insert reference to a Javascript
file.
Namespace for titlepage mechanism.
Titlepage mechanism is now namespace aware to support XHTML.
Chunked filename prefix
New param named chunked.filename.prefix lets you add a filename prefix
to each chunked file. This replaces the buggy practice of adding such a
prefix to the base.dir param. Now the base.dir param will always have a
trailing slash added if it is not present, so you no longer have to
remember to add it to the param value.
Generate id attributes
The stylesheet param generate.id.attributes already existed but was
incompletely implemented. Now when it is set to 1, only id attributes
should be output, not <a name> named anchors.
Generate consistent id attributes
New generate.consistent.ids parameter which allows generating a more
stable id values based on XPath rather than the generate-id() function,
which may not produce consistent values between runs. Stable output ids
allow you to make stable links to generated content from the outside.
Topic element
Add basic support for formatting a topic element, which is available in
DocBook 5.1. Generally a topic element will be used with assembly and
may be transformed to some other hierarchical element during
processing, but it can also be formatted as a plain topic.
- Webhelp
Webhelp refactored
Webhelp templates refactored to better support customization.
Added documentation.
More and better documentation added.
Webhelp generated text
Many improvements to the generated text for webhelp output.
- XHTML5
New stylesheets to generate HTML5 output, in an XML serialization. These
templates are a customization layer on top of the XHTML stylesheet files.
- EPUB3
New stylesheets to generate EPUB3 output. These templates are a
customization layer on top of the xhtml5 stylesheet files.
- Assembly
New assembly.xsl stylesheet to convert a DocBook 5.1 assembly into a
standard DocBook 5 document. Also includes a topic-maker-chunk.xsl
stylesheet that can convert a DocBook 5 book or article document into an
assembly with a collection of modular files, including converting some
elements to topic files.
Gentext
The following changes have been made to the gentext code since the 1.76.1
release.
- stefanhinz: locale/de.xml
Translated German WebHelp strings
- David Cramer: locale/zh.xml; locale/en.xml; locale/fr.xml; locale/de.xml;
locale/ja.xml
Webhelp: Update non-en gentext strings
- Robert Stayton: locale/en.xml
Add topic to title-numbered context.
- Robert Stayton: locale/en.xml
Add basic topic element templates.
- Mauritz Jeanson: locale/el.xml
Updated gentext for quotation marks. Fixes bug #3512440.
- Jirka Kosek: locale/cs.xml
Adding missing context for webhelp
- David Cramer: locale/en.xml
Fixing syntax of webhelp gentext entries
- David Cramer: locale/en.xml
Moving webhelp gentext strings into a context
- tom_schr: locale/zh.xml; locale/en.xml; locale/cs.xml; locale/fr.xml;
locale/de.xml; local⋯
Moved language specific of WebHelp to gentext/locale/ as discussed with
Stefan following the "minimal intrusive approach". :)
In the long run, maybe moving the text into a context, not sure.
- Jirka Kosek: locale/ru.xml
Aligned capitalization of first letters with English original
Common
The following changes have been made to the common code since the 1.76.1
release.
- Robert Stayton: common.xsl
In "select.mediaobject.index" template, add selection of videoobject
and audioobject since now supported in HTML5.
- Robert Stayton: labels.xsl; titles.xsl; entities.ent; targets.xsl;
subtitles.xsl; gentext.⋯
Add basic support for new <topic> element.
- Robert Stayton: common.xsl
Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
- Robert Stayton: olink.xsl
Generate error message if olink data in targetset is in a namespace.
- Robert Stayton: common.xsl
Add support for generate.consistent.ids parameter.
- Robert Stayton: subtitles.xsl
Add verbose param to subtitle.markup templates to allow its
error message to be ignored.
Add that param to fop1.xsl application of subtitle.markup
to avoid unnecessary error message in document information.
- Robert Stayton: labels.xsl
Add empty templates for glossdiv, glosslist, and glossentry in
mode="label.markup".
FO
The following changes have been made to the fo code since the 1.76.1 release.
- Robert Stayton: graphics.xsl
qualify caption template to mediaobject/caption so not confused with table/caption.
- Robert Stayton: table.xsl
Add template to process table/caption element.
- Robert Stayton: titlepage.xsl; autotoc.xsl; component.xsl; xref.xsl;
titlepage.templates.x⋯
Add basic support for new <topic> element.
- Robert Stayton: graphics.xsl
Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
- Robert Stayton: titlepage.xsl
Add default style att-sets for component.list.of.titles, etc.
- Robert Stayton: autotoc.xsl; component.xsl; titlepage.templates.xml
Add make.component.tocs to support lists of tables, etc. for
article and other components. Added component.list.of.tables to
titlepage.templates.xml to format the title.
- Robert Stayton: param.xweb; param.ent
Add new para.properties attribute-set for paragraphs.
- Robert Stayton: inline.xsl
Add template mode 'simple.xlink.properties' to allow
easy customization of formatting of links generated
from elements other than xref, link, and olink using
the xlink attributes.
- Robert Stayton: param.xweb; param.ent
Add table.caption.properties to format table captions.
- Robert Stayton: table.xsl
Add support for caption in a CALS table.
- Robert Stayton: graphics.xsl; math.xsl
Refactored the 'process.image' template to create modular
templates for each attribute so they can be individually
customized. Also merged in support for embedded svg and
mml content so they can have image attributes too.
- Robert Stayton: param.xweb; param.ent
Check in new params for FO side regions in page masters.
- Robert Stayton: titlepage.xsl; titlepage.templates.xml
Add support for itermset in info elements, using titlepage mechanism
to ensure entries are placed inside page-sequence.
- Robert Stayton: pagesetup.xsl
Add support for side body margins and side static content regions.
Fixes bug 3389931.
- Robert Stayton: param.xweb; param.ent; task.xsl
Add attribute-set task.properties to task element to
support customization.
- Robert Stayton: lists.xsl; param.xweb; param.ent
Add new attribute-sets calloutlist.properties and callout.properties
to better support customization of calloutlists, fixing bug 3160341.
- Jirka Kosek: Makefile
Titlepage mechanism is now namespace aware to support XHTML. Please note that when generating titlepage template stylesheets you have to pass FO or XHTML namespace inside ns parameter. For HTML parameter should be empty.
- Robert Stayton: graphics.xsl
Allow selection by role for multiple imageobject elements
within an imageobjectco, which since Docbook 5 allows multiple imageobjects.
- Mauritz Jeanson: titlepage.xsl
Added template for collabname. Fixes bug #3414436.
- David Cramer: verbatim.xsl
Support the keep-together processing-instruction on programlisting, screen, synopsis, and literallayout. Tracker id #3396906.
- Robert Stayton: pagesetup.xsl
Pass the pageclass, sequence, and gentext-key to the template
named header.footer.widths to enable further customization
based on page master.
- Jirka Kosek: xref.xsl
hyphenation of URL content must be disabled for link, not only for ulink because od DB5
- Jirka Kosek: xref.xsl
URLs shouldn't be hyphenated as normal text
- Jirka Kosek: callout.xsl
Added support for alternative circled numbers
- Mauritz Jeanson: axf.xsl; fop1.xsl; xep.xsl
Added support for author/orgname in document metadata. Closes bug #3132862.
- Robert Stayton: component.xsl
Add template for article/colophon to avoid nested page-sequence.
HTML
The following changes have been made to the html code since the 1.76.1 release.
- Robert Stayton: xref.xsl
Add support for using info/title as well as title in target element.
- Robert Stayton: component.xsl
Enable support for html5 features, including using <section> instead of
<div> for certain elements, and setting heading level to <h1> for chapters.
These features are not changed in the base html stylesheet for backwards
compatibility.
- Robert Stayton: docbook.css.xml
Add style for footnote rule.
- Robert Stayton: biblio-iso690.xsl
Add support for subtitle inside info.
- Robert Stayton: docbook.xsl
Add call to new 'root.attributes' placeholder template to allow
adding attributes to the <html> output element.
- Robert Stayton: inline.xsl; titlepage.xsl; formal.xsl; division.xsl;
toc.xsl; sections.xsl⋯
Finish implementation of generate.id.attributes for all elements
using the template named id.attribute.
- Robert Stayton: autotoc.xsl; chunktoc.xsl; titlepage.xsl; chunk-code.xsl;
changebars.xsl; ⋯
Add basic support for new <topic> element.
- Robert Stayton: graphics.xsl
Fix handling of mediatypes for video and audio files, mostly for HTML5 and EPUB3 outputs.
- Robert Stayton: callout.xsl; verbatim.xsl
Restore programlisting to use <pre> instead of <div> and instead
wrap callout img elements in <span> to make valid HTML.
- Robert Stayton: graphics.xsl
Turn off img longdesc attribute because not supported by browsers.
- Robert Stayton: footnote.xsl
Move square brackets and <sup> inside <a> element for footnote
marks to fix display problems in some browsers.
- Robert Stayton: param.xweb; param.ent
Add new params html.script and html.script.type to support
Javascript references.
- Robert Stayton: chunk-common.xsl; chunktoc.xsl; titlepage.xsl; chunker.xsl;
chunk-code.xsl⋯
Add support for chunked.filename.prefix param.
Make sure base.dir value has a trailing slash in
the chunk.base.dir internal param used by the templates.
- Robert Stayton: formal.xsl; htmltbl.xsl
Now handles caption in html markup table like title,
so formal.object.title is used with all its features, including
formatting and placement.
Added htmlTable.with.caption template to handle the wrapper, and
left htmlTable template unchanged.
Now caption template in mode="htmlTable" does nothing, because
caption handled by formal.object.title template.
- Robert Stayton: html.xsl
Turn off generating the title attribute for block and hierarchical elements.
Should only be used for inline elements, usually using the alt element.
Also used for links to show the target title.
- Robert Stayton: lists.xsl
The spacing="compact" attribute on lists in HTML no longer outputs compact="compact"
(or just "compact" in the case of Saxon 6), since that attribute is
deprecated and improperly supported. Instead, the output uses a
multiple class attribute such as class="orderedlist compact".
Use CSS to style such lists without margin above.
- Robert Stayton: graphics.xsl
Allow selection by role for multiple imageobject elements
within an imageobjectco, which since Docbook 5 allows multiple imageobjects.
- Robert Stayton: pi.xsl
Improve doc descriptions of dbhtml filename and dir.
- Robert Stayton: autoidx.xsl
Add setindex to context param in mode="reference" to better
support setindex.
- Robert Stayton: autotoc.xsl
Support set as child of set in set.toc template.
- Robert Stayton: qandaset.xsl
Change question and title templates to replace hard-coded
class="local-name()" with mode="class.attribute" to support customization
of class values.
- Norman Walsh: chunktoc.xsl
Separate book appendixes from article appendixes (so that they can be customized independently)
- Mauritz Jeanson: graphics.xsl
Added condition to prevent "Failed to interpret image" messages (SVG is not supported
by the graphic size extension).
Epub
The following changes have been made to the epub code since the 1.76.1 release.
- Robert Stayton: docbook.xsl
Replace $base.dir with $chunk.base.dir to ensure trailing slash in place.
HTMLHelp
The following changes have been made to the htmlhelp code since the 1.76.1
release.
- Robert Stayton: htmlhelp-common.xsl
Change $base.dir to $chunk.base.dir to ensure trailing slash in place.
Eclipse
The following changes have been made to the eclipse code since the 1.76.1
release.
- Robert Stayton: eclipse.xsl; eclipse3.xsl
Use $chunk.base.dir instead of $base.dir to ensure trailing slash is in place.
JavaHelp
The following changes have been made to the javahelp code since the 1.76.1
release.
- Robert Stayton: javahelp.xsl
Change $base.dir to $chunk.base.dir to ensure trailing slash is present.
- Mauritz Jeanson: javahelp.xsl
Replaced empty header.navigation and footer.navigation templates with parameter suppress.navigation=1,
which simplifies customization. See bug #3310904.
Webhelp
The following changes have been made to the webhelp code since the 1.76.1
release.
- David Cramer: template/common/css/positioning.css
Webhelp: Adding print-only css rules
- David Cramer: template/common/main.js
Webhelp: Arun's fix for bug where heading was partially hidden by header in some situations.
- David Cramer: xsl/webhelp-common.xsl
Webhelp: turn off autolabeling by default
- David Cramer: xsl/webhelp.xsl
Webhelp: Import xhtml base stylesheets
- David Cramer: docsrc/readme.xml
Webhelp: Link to the DocBook reference docs from the webhelp readme
- David Cramer: xsl/webhelp-common.xsl
Webhelp: Use gentext value for noscript warning
- David Cramer: Makefile
Webhelp: Delete tempfile after DocBook xsl build
- David Cramer: xsl/webhelp.xsl
Webhelp: moving parameters into the standard location so they will be part of the parameter reference
- David Cramer: xsl/webhelp.xsl; xsl/webhelp-common.xsl
Webhelp: moving parameters into the standard location so they will be part of the parameter reference
- David Cramer: template/common/main.js
Webhelp: tweaking scrolldown offset for anchors
- David Cramer: docsrc/images; docsrc/images/sample.jpg; docsrc/readme.xml;
template/content⋯
Webhelp: updating docs. Ant version, install instructions, handling of images.
- David Cramer: xsl/webhelp.xsl
Patch from Arun Bharadwaj to display message if JavaScript is disabled
- David Cramer: template/content/search/nwSearchFnt.js
Patch from Arun Bharadwaj to strip quotes from search query strings
- Robert Stayton: xsl/webhelp.xsl
Add basic support for new <topic> element.
- Jirka Kosek: xsl/webhelp.xsl
Put back old extensibility point.
Guys, please don't remove existing extensibility points like named templates, it will break existing customizations.
- David Cramer: xsl/webhelp.xsl
Moving webhelp gentext strings into a context
- tom_schr: param.ent
Disabled branding and brandname entities for the time being
- tom_schr: param.xweb; param.ent
Prepared WebHelp reference documentation :)
Not clear about parameters brandname and branding: Should they renamed
to "webhelp.branding" and "webhelp.brandname"?
Currently, docsrc/reference.xml contains only a comment for the WebHelp
ref doc to be non-intrusive.
Idea is to enable it when it is ready
- tom_schr: xsl/webhelp.xsl
Moved language specific of WebHelp to gentext/locale/ as discussed with
Stefan following the "minimal intrusive approach". :)
In the long run, maybe moving the text into a context, not sure.
- David Cramer: template/common/css/positioning.css
Webhelp: Lower the minimum width of content pane
- kasunbg: xsl/webhelp.xsl; template/common/main.js
If an user moved to another page by clicking on a toc link, and then clicked on #searchDiv,
search should be performed if the cookie textToSearch is not empty.
- David Cramer: xsl/webhelp.xsl
Webhelp: Left align titles in nav header. Display for all but the topmost page
- David Cramer: template/content/search/stemmers/en_stemmer.js; docsrc/
xinclude-test.xml
Webhelp: Cleanup related to en_stemmer.js changes
- David Cramer: template/common/css/positioning.css
Webhelp: Don't put borders around qandaset list
- David Cramer: template/common/main.js
Webhelp: Avoid unnecessary scroll ups when anchor is clicked on
- David Cramer: build.properties
Webhelp: Show footer nav by default
- David Cramer: build.properties; build.xml
Webhelp: Support setting suppress.footer.navigation from build.properties
- David Cramer: build.properties; build.xml
Webhelp: Support admon.graphics param in build.properties
- David Cramer: docsrc/xinclude-test.xml; docsrc/readme.xml
Webhelp: Adding xinclude example to the demo/readme doc
- David Cramer: template/common/css/positioning.css
Webhelp: Remove border around table used to format callout list
- David Cramer: xsl/webhelp.xsl; template/common/images/admon/tip.png;
template/common/image⋯
Webhelp: Support admon graphics (still off by default)
- David Cramer: xsl/webhelp.xsl; template/common/css/positioning.css
Webhelp: Turn on navfooter and fix related css
- David Cramer: xsl/webhelp.xsl
Webhelp: Fix error about undeclared doc.title param
- David Cramer: docsrc/readme.xml
Webhelp: Adding some test search terms to the readme
- David Cramer: template/content/search/stemmers/en_stemmer.js
Handle exceptional cases listed in the Porter 2 stemming algo
- David Cramer: template/content/search/stemmers/en_stemmer.js
Webhelp: adding special case word 'say' to en js stemmer
- David Cramer: template/content/search/stemmers/en_stemmer.js
Webhelp: Refine stemming of terms that end in (only stem if there's a consonant before the -y)
- David Cramer: template/content/search/stemmers/en_stemmer.js; template/
content/search/nwSe⋯
Webhelp: fixed bug where words like key, day, and nucleus, were not found due to differences in the way the client stemmer and indexer stemmed words
- David Cramer: build.xml
Webhelp: Support xinclude and two-pass profiling in build.xml
- David Cramer: xsl/webhelp.xsl
Fix bad link to default topic.
- kasunbg: docsrc/readme.xml
Automatically limit the size of the search description to something 140 characters
- kasunbg: xsl/webhelp.xsl
removing outline in 'contents' and 'search' buttons that is visible when clicked. tabindex for SIDEBAR button.
- kasunbg: xsl/webhelp.xsl; build.xml
Webhelp ant script changes - HTML transformation support for WebHelp - Uses Tagsoup for parsing the bad html.
tagsoup-1.2.1.jar is added to trunk/xsl-webhelpindexer/lib/
- kasunbg: xsl/webhelp.xsl
proper support for saxon xhtml transformation.
- kasunbg: template/common/images/callouts/10.png; template/common/images/
callouts/11.png; t⋯
webhelp - adding callouts
- kasunbg: xsl/webhelp.xsl; template/common/main.js; template/common/css/
positioning.css
webhelp - animations for show/hide Sidebar
- kasunbg: build.properties
commenting about brand and brandname
- kasunbg: Makefile
parameterized MAKE for webhelp
- kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css;
build.properties; build.xml
webhelp xsl customization - logo
- kasunbg: template/content/search/nwSearchFnt.js
remove some JS warninings
- kasunbg: template/content/search/nwSearchFnt.js
Fix for missing "No results found for..." bug
- kasunbg: xsl/webhelp.xsl
commented about the importance of the order of css contents. Order is important between the in-html-file css and the linked css files. Some css declarations in jquery-ui-1.8.2.custom.css are over-ridden. If that's a concern, just remove the additional css contents inside these default jquery css files. I thought of keeping them intact for easier maintenance.
- Jirka Kosek: xsl/webhelp.xsl; template/common/css/positioning.css
Minor cleanup, added extensibility hook, some styling moved into CSS for easier customization
- David Cramer: template/content/search/nwSearchFnt.js
Removing onclick that came from Oxygen's dita stuff
- kasunbg: docsrc/readme.xml
webhelp - documenting about features
- kasunbg: template/common/css/positioning.css
webhelp search text box
- kasunbg: template/common/css/positioning.css
adding header background image
- kasunbg: xsl/webhelp.xsl; template/common/images/header-bg.png
new header background image
- kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css
fix left navigation
- kasunbg: template/common/css/positioning.css
some css
- kasunbg: build.xml
Adding html.extension property
- kasunbg: template/common/css/positioning.css; build.properties; build.xml
webhelp - Adding enable.stemming, toc.file build properties
- David Cramer: template/common/css/positioning.css
Make the webhelp banner slightly larger.
- David Cramer: template/common/main.js; template/common/css/positioning.css
Adjust colors and positioning of header and search/toc tabs
- David Cramer: xsl/webhelp.xsl
Only put doc title in header
- David Cramer: template/common/css/positioning.css; template/common/images/
main_bg_fade.png
Adjusting default color of the header
- kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css
adjustments to header title. Now output in Opera looks good.
- kasunbg: template/common/images/sidebar.png; template/content/search/
punctuation.props; te⋯
deleting svn:executable flag from webhelp files
- kasunbg: xsl/webhelp.xsl; template/common/css/positioning.css; template/
common/images/sear⋯
Customized the left navagation headers; Contents and Search.
Adding custom css for the current redmond ui of jquery-ui. These override jquery-ui's default css customizations. These are supposed to take precedence.
- kasunbg: docsrc/readme.xml
typo fix
- kasunbg: template/common/images/next-arrow.png; xsl/webhelp.xsl; template/
common/main.js; ⋯
UI improvements.
Moved search highligher to search tab.
Added nice icons for navigation buttons etc.
Removed footer navigation
Corrected tree colorings
Overall, some css magic
- David Cramer: docsrc/readme.xml
Added listitem thinking SyncRO Soft for their contributions.
- kasunbg: build.xml
support for default classpath for Gentoo Linux
- kasunbg: docsrc/readme.xml
webhelp - some updates to the documentation about search
- kasunbg: template/common/css/positioning.css
Fix for issue 'Keep "search" & "contents" titles always visible in webhelp - ID: 3403438'
- David Cramer: template/common/images/starsSmall.png
Changed icons used to show search weightings from stars to boxes so they won't look like user ratings
- David Cramer: xsl/webhelp.xsl; template/common/main.js; template/common/
images/starsSmall.⋯
Merged Oxygen webhelp improvements (search weightings etc) into trunk: -r9031:9039
- kasunbg: docsrc/readme.xml
webhelp documentation - search indexing, faq
- kasunbg: docsrc/readme.xml
update webhelp documentation
- David Cramer: xsl/webhelp.xsl
Fixed bug where webhelp.default.topic was not being used if it was set
- David Cramer: xsl/webhelp.xsl; template/content/search/nwSearchFnt.js
Localize string in nwSearchFnt.js file
- David Cramer: xsl/webhelp.xsl
Added tabindex attributes to make tab order in UI more logical in webhelp.
- David Cramer: template/common/main.js
Fixed bug where anchors in pages landed beneath the banner.
- kasunbg: xsl/webhelp.xsl
Added more comments to the xsl/webhelp/xsl/webhelp.xsl file. Removed some clutter.
- David Cramer: template/common/main.js
Fixed problem reported in IE 8. See tracker id # 373747.
- David Cramer: xsl/webhelp.xsl
Addressed tracker #3247166 by removing hard-coded reference to ch01.html.
- kasunbg: build.xml
Changed the webhelp build.xml to reflect the changes to xsl-webhelpindexer.
Added classpaths for xercesImpl and xml-api jars to the indexer. Paths added for *nix environments, need to look at how the current system behaves in Windows. Discussion: http://lists.oasis-open.org/archives/docbook-apps/201011/msg00116.html
- kasunbg: template/common/images/loading.gif; template/common/jquery/
treeview/jquery.treevi⋯
webhelp: Removing some unnecessary JQuery JS files
- kasunbg: template/common/main.js
webhelp: Usability improvement - when click on a node in the TOC tree, the child nodes will auto populate now.
- kasunbg: xsl/webhelp.xsl
Added google translated localizations for Japanese, German, French, and Chinese. The translations might not be pretty accurate.
Better translations are appreciated.
- kasunbg: docsrc/readme.xml; template/content/images; template/content/
images/sample.jpg
Added documentation for how to add images to WebHelp
- Jirka Kosek: xsl/webhelp.xsl
Added more customization hooks
Search code output only when search tab is active
Added cs localization
- Jirka Kosek: xsl/webhelp.xsl
Added parameter webhelp.common.dir for specifying location of common files (JS+CSS)
Added hooks for adding additional user defined tabs
Params
The following changes have been made to the params code since the 1.76.1
release.
- David Cramer: webhelp.indexer.language.xml
Webhelp: Fixing list of supported languages
- David Cramer: webhelp.indexer.language.xml
Webhelp: Correct language code in docs for Chinese
- Mauritz Jeanson: admon.graphics.extension.xml
Added list of graphics formats.
- Mauritz Jeanson: passivetex.extensions.xml
Updated link.
- tom_schr: webhelp.indexer.language.xml; webhelp.default.topic.xml;
webhelp.tree.cookie.id.⋯
Prepared WebHelp reference documentation :)
Not clear about parameters brandname and branding: Should they renamed
to "webhelp.branding" and "webhelp.brandname"?
Currently, docsrc/reference.xml contains only a comment for the WebHelp
ref doc to be non-intrusive.
Idea is to enable it when it is ready
- Robert Stayton: glossary.collection.xml
Add info about relative paths.
- Robert Stayton: para.properties.xml
Special attribute-set for para only.
- Robert Stayton: table.caption.properties.xml
To format table captions.
- Robert Stayton: html.script.type.xml; html.script.xml
Add support for specifying javascript references like css references.
- Robert Stayton: body.margin.outer.xml; region.outer.extent.xml;
body.margin.inner.xml; reg⋯
Add support for side regions in FO output.
- Robert Stayton: chunked.filename.prefix.xml
New param chunked.filename.prefix to separate any such prefix from
the base.dir param, which helps fix bug 3087359.
- Robert Stayton: generate.consistent.ids.xml
New param to support replacing generate-id() with xsl:number
for more consistent id values.
- Robert Stayton: task.properties.xml
Allow task to be customized more easily.
- Robert Stayton: calloutlist.properties.xml; callout.properties.xml
Support better customization of callout lists.
- Jirka Kosek: callout.unicode.start.character.xml
Added support for alternative circled numbers
- David Cramer: example.properties.xml
Made example.properties use keep-together='auto' like table.properies to avoid problems where example/programlisting takes more than one page
- Mauritz Jeanson: graphicsize.extension.xml
Added info about supported image formats.
Highlighting
The following changes have been made to the highlighting code since the 1.76.1
release.
- Jirka Kosek: csharp-hl.xml
Added LINQ keywords
- Jirka Kosek: delphi-hl.xml
Additional keywords from Yuri Zhilin
Profiling
The following changes have been made to the profiling code since the 1.76.1
release.
- David Cramer: profile-mode.xsl
When profile.* params only consist of space characters, then ignore them.
Lib
The following changes have been made to the lib code since the 1.76.1 release.
- Robert Stayton: lib.xweb
Added two utility templates to make lib.xsl work
without reference to other modules since it is used
that way with profiling/xsl2profile.xsl.
- Robert Stayton: lib.xweb
Fix trim.common.uri.paths to first resolve any ../ in
the paths.
Template
The following changes have been made to the template code since the 1.76.1
release.
- Jirka Kosek: titlepage.xsl
Titlepage mechanism is now namespace aware to support XHTML. Please note that when generating titlepage template stylesheets you have to pass FO or XHTML namespace inside ns parameter. For HTML parameter should be empty.
Extensions
The following changes have been made to the extensions code since the 1.76.1
release.
- kasunbg: Makefile
webhelp - Adding enable.stemming, toc.file build properties
- David Cramer: Makefile
Attempt to convince Makefile that webhelpindexer is dirty
XSL-Saxon
The following changes have been made to the xsl-saxon code since the 1.76.1
release.
- Mauritz Jeanson: src/com/nwalsh/saxon/Verbatim.java; src/com/nwalsh/saxon/
FormatGraphicCal⋯
Added fixes to ensure that generated XHTML markup for callouts is in the proper namespace.
Download Latest Version
docbook-xsl-1.79.1.tar.bz2 (22.0 MB)
