$Id: param.xweb,v 1.3 2001/10/15 12:42:44 nwalsh Exp $
Copyright © 1999, 2000, 2001 Norman Walsh
Table of Contents
This is technical reference documentation for the DocBook XSL Stylesheets; it documents (some of) the parameters, templates, and other elements of the stylesheets.
This reference describes each of the HTML Stylesheet parameters. These are the “easily customizable” parts of the stylesheet. If you want to specify an alternate value for one or more of these parameters, you can do so in a “driver” stylesheet.
For example, if you want to change the html.stylesheet to reference.css, you might create a driver stylesheet like this:
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version='1.0'> <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/> <xsl:param name="html.stylesheet">reference.css</xsl:param> </xsl:stylesheet>
Naturally, you have to change the href attribute on <xsl:import> to point to docbook.xsl on your system. (Or chunk.xsl, if you're using chunking.)
This is not intended to be “user” documentation. It is provided for developers writing customization layers for the stylesheets, and for anyone who's interested in “how it works”.
Although I am trying to be thorough, this documentation is known to be incomplete. Don't forget to read the source, too :-)
Table of Contents
admon.graphics — Use graphics in admonitions?
If true (non-zero), admonitions are presented in an alternate style that uses a graphic. Default graphics are provided in the distribution.
admon.graphics.extension — Extension for admonition graphics
Sets the extension to use on admonition graphics.
admon.graphics.path — Path to admonition graphics
Sets the path, probably relative to the directory where the HTML files are created, to the admonition graphics.
admonition.title.properties — To set the style for admonitions.
§4: §114 |
<xsl:attribute-set name="admonition.title.properties"> <xsl:attribute name="font-size">14pt</xsl:attribute> <xsl:attribute name="font-weight">bold</xsl:attribute> <xsl:attribute name="hyphenate">false</xsl:attribute> <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> </xsl:attribute-set> |
How do you want admonitions styled?
Set the font-size, weight etc to the style required
alignment — Specify the default text alignment
The default text alignment is used for most body text.
appendix.autolabel — Are Appendixes automatically enumerated?
If true (non-zero), unlabeled appendixes will be enumerated.
arbortext.extensions — Enable Arbortext extensions?
If non-zero, Arbortext extensions will be used.
author.othername.in.middle — Is othername in author a middle name?
If true (non-zero), the othername of an author appears between the firstname and surname. Otherwise, othername is suppressed.
biblioentry.item.separator — Text to separate bibliography entries
Text to separate bibliography entries
bibliography.collection — Name of the bibliography collection file
§10: §114 |
<xsl:param name="bibliography.collection" select="'http://docbook.sourceforge.net/release/bibliography/bibliography.xml'"/> |
Tired of copying bibliography entries from one document to another? Now you can maintain a central bibliography and let the stylesheets do the copying for you. This parameter identifies the file (by URI reference) that contains your complete bibliography collection.
body.font.family — The default font family for body text
The body font family is the default font used for text in the page body.
body.font.master — Specifies the default point size for body text
The body font size is specified in two parameters (body.font.master and body.font.size) so that math can be performed on the font size by XSLT.
body.font.size — Specifies the default font size for body text
§13: §114 |
<xsl:param name="body.font.size"> <xsl:value-of select="$body.font.master"/><xsl:text>pt</xsl:text> </xsl:param> |
The body font size is specified in two parameters (body.font.master and body.font.size) so that math can be performed on the font size by XSLT.
body.margin.bottom — The bottom margin of the body text
The body bottom margin is the distance from the last line of text in the page body to the bottom page margin. Note that the page footer, if any, appears in the space between the body bottom margin and the page bottom margin.
body.margin.top — To specify the size of the top margin of a page
The body top margin is the distance from the page top margin to the first line of text in the page body. Note that the page header, if any, appears in the space between the page top margin and the body top margin.
callout.defaultcolumn — Indicates what column callouts appear in by default
If a callout does not identify a column (for example, if it uses the linerange unit), it will appear in the default column.
callout.graphics — Use graphics for callouts?
If non-zero, callouts are presented with graphics (e.g., reverse-video circled numbers instead of "(1)", "(2)", etc.). Default graphics are provided in the distribution.
callout.graphics.extension — Extension for callout graphics
Sets the extension to use on callout graphics.
callout.graphics.number.limit — Number of the largest callout graphic
If callout.graphics is non-zero, graphics are used to represent callout numbers. The value of callout.graphics.number.limit is the largest number for which a graphic exists. If the callout number exceeds this limit, the default presentation "(nnn)" will always be used.
callout.graphics.path — Path to callout graphics
Sets the path, probably relative to the directory where the HTML files are created, to the callout graphics.
callout.unicode — Use Unicode characters rather than images for callouts.
The stylesheets can use either an image of the numbers one to ten, or the single Unicode character which represents the numeral, in white on a black background. Use this to select the Unicode character option.
callout.unicode.font — Specify a font for Unicode glyphs
The name of the font to specify around Unicode callout glyphs. If set to the empty string, no font change will occur.
callout.unicode.number.limit — Number of the largest callout graphic
If callout.graphics is non-zero, graphics are used to represent callout numbers. The value of callout.graphics.number.limit is the largest number for which a graphic exists. If the callout number exceeds this limit, the default presentation "(nnn)" will always be used.
callout.unicode.start.character — First Unicode character to use, decimal value.
If callout.graphics is non-zero, graphics are used to represent callout numbers. The value of callout.graphics.number.limit is the largest number for which a graphic exists. If the callout number exceeds this limit, the default presentation "(nnn)" will always be used.
callouts.extension — Enable the callout extension
The callouts extension processes areaset elements in ProgramListingCO and other text-based callout elements.
chapter.autolabel — Are chapters automatically enumerated?
If true (non-zero), unlabeled chapters will be enumerated.
column.count — Specifies the number of columns of text on the page
The specified number of columns of text will appear on each page.
component.title.properties — Specify the styling for the title elements of a component.
§28: §114 |
<xsl:attribute-set name="component.title.properties"> <xsl:attribute name="space-before.optimum">2em</xsl:attribute> <xsl:attribute name="space-before.minimum">1.8em</xsl:attribute> <xsl:attribute name="space-before.maximum">2.2em</xsl:attribute> <xsl:attribute name="font-weight">bold</xsl:attribute> <xsl:attribute name="font-size">18pt</xsl:attribute> <xsl:attribute name="space-after.optimum">1.5em</xsl:attribute> <xsl:attribute name="space-after.minimum">1.3em</xsl:attribute> <xsl:attribute name="space-after.maximum">1.8em</xsl:attribute> <xsl:attribute name="hyphenate">false</xsl:attribute> <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> </xsl:attribute-set> |
A set of attributes are used to style the title of a component (chapters, appendixes, articles, etc.). Components are usually printed in the title.font.family. Spacing before and after, font size etc are specified using this parameter.
default.table.width — The default width of tables
If specified, this value will be used for the WIDTH attribute on tables that do not specify an alternate width (with the dbhtml processing instruction).
default.units — Default units for an unqualified dimension
If an unqualified dimension is encountered (for example, in a graphic width), the default-units will be used for the units. Unqualified dimensions are not allowed in XSL Formatting Objects.
dingbat.font.family — The font family for copyright, quotes, and other symbols
The dingbat font family is used for dingbats. If it is defined as the empty string, no font change is effected around dingbats.
double.sided — Is the document to be printed double sided?
Double-sided documents are printed with a slightly wider margin on the binding edge of the page.
FIXME: The current set of parameters does not take writing direction into account.
footnote.font.size — The font size for footnotes
§33: §114 |
<xsl:param name="footnote.font.size"> <xsl:value-of select="$body.font.master * 0.8"/><xsl:text>pt</xsl:text> </xsl:param> |
The footnote font size is used for...footnotes!
fop.extensions — Enable FOP extensions?
If non-zero, FOP extensions will be used. At present, this consists of PDF bookmarks.
formal.object.properties — Properties associated with a formal object such as a figure, or other component that has a title
§35: §114 |
<xsl:attribute-set name="formal.object.properties"> <xsl:attribute name="space-before.minimum">0.5em</xsl:attribute> <xsl:attribute name="space-before.optimum">1em</xsl:attribute> <xsl:attribute name="space-before.maximum">2em</xsl:attribute> <xsl:attribute name="space-after.minimum">0.5em</xsl:attribute> <xsl:attribute name="space-after.optimum">1em</xsl:attribute> <xsl:attribute name="space-after.maximum">2em</xsl:attribute> <xsl:attribute name="keep-with-previous.within-column">always</xsl:attribute> </xsl:attribute-set> |
The styling for formal objects in docbook. Specify the spacing before and after the object.
formal.procedures — Selects formal or informal procedures
Formal procedures are numbered and always hav a title.
formal.title.properties — Style the title element of formal object such as a figure.
§37: §114 |
<xsl:attribute-set name="formal.title.properties" use-attribute-sets="normal.para.spacing"> <xsl:attribute name="font-weight">bold</xsl:attribute> <xsl:attribute name="font-size">12pt</xsl:attribute> <xsl:attribute name="hyphenate">false</xsl:attribute> <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> </xsl:attribute-set> |
Specify how the title should be styled. Specify the font size and weight of the title of the formal object.
format.variablelist.as.list — Use an fo:list to format VariableLists?
If non-zero, an fo:list will be used to format VariableLists. Otherwise, nested fo:blocks will be used.
funcsynopsis.decoration — Decorate elements of a FuncSynopsis?
If true (non-zero), elements of the FuncSynopsis will be decorated (e.g. bold or italic). The decoration is controlled by functions that can be redefined in a customization layer.
funcsynopsis.style — What style of 'FuncSynopsis' should be generated?
If funcsynopsis.style is ansi, ANSI-style function synopses are generated for a funcsynopsis, otherwise K&R-style function synopses are generated.
generate.book.equation.lot — Should a lot be generated for equations?
Specify if list of equations, like a table of contents, is required.
generate.book.example.lot — Is a list of equations required?
Specify if a list of examples is required, similar to a table of contents but for examples.
generate.book.figure.lot — Is a list of figures required for book?
Specify if a list of figures is required, similar to a table of contents but for figures.
generate.book.table.lot — Do you want a list of tables in a book?
Specify if a list of tables is required, similar to a table of contents, but for all the tables in the book
generate.book.toc — Do you want a table of contents in the book?
Specify if a table of contents is required in the book.
generate.component.toc — Should TOCs be genereated in components (Chapters, Appendixes, etc.)?
If true (non-zero), they are.
generate.division.equation.lot — Generate a list of titles for Equations?
If non-zero, a list of titles is generated for Equations.
generate.division.example.lot — Generate a list of titles for Examples?
If non-zero, a list of titles is generated for Examples.
generate.division.figure.lot — Generate a list of titles for Figures?
If non-zero, a list of titles is generated for Figures.
generate.division.table.lot — Generate a list of titles for Tables?
If non-zero, a list of titles is generated for Tables.
generate.division.toc — Should TOCs be genereated in divisions (Books, Parts, etc.)?
If true (non-zero), they are.
graphic.default.extension — Default extension for graphic filenames
If a graphic or mediaobject includes a reference to a filename that does not include an extension, and the format attribute is unspecified, the default extension will be used.
html.stylesheet — Name of the stylesheet to use in the generated HTML
The name of the stylesheet to place in the HTML LINK tag, or the empty string to suppress the stylesheet LINK.
html.stylesheet.type — The type of the stylesheet used in the generated HTML
The type of the stylesheet to place in the HTML link tag.
hyphenate — Specify hyphenation behavior
If true, words may be hyphenated. Otherwise, they may not.
insert.xref.page.number — Turns page numbers in xrefs on and off
When equal to 1, this parameter triggers generation of page number citations after xrefs.
label.from.part — Renumber chapters in each part?
If label.from.part is non-zero, components (chapters, appendixes, etc.) will be numbered from 1 in each part. Otherwise, they will be numbered monotonically throughout each book.
linenumbering.everyNth — Indicate which lines should be numbered
If line numbering is enabled, everyNth line will be numbered.
linenumbering.extension — Enable the line numbering extension
If true, verbatim environments (elements that have the format='linespecific' notation attribute: address, literallayout, programlisting, screen, synopsis) that specify line numbering will have, surprise, line numbers.
linenumbering.separator — Specify a separator between line numbers and lines
The separator is inserted between line numbers and lines in the verbatim environment.
linenumbering.width — Indicates the width of line numbers
If line numbering is enabled, line numbers will appear right justified in a field "width" characters wide.
list.block.spacing — What spacing do you want before lists?
§63: §114 |
<xsl:attribute-set name="list.block.spacing"> <xsl:attribute name="space-before.optimum">1em</xsl:attribute> <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> </xsl:attribute-set> |
Specify the spacing required before a list.
list.item.spacing — What space do you want between list items?
§64: §114 |
<xsl:attribute-set name="list.item.spacing"> <xsl:attribute name="space-before.optimum">1em</xsl:attribute> <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> </xsl:attribute-set> |
Specify what spacing you want between each list item.
make.single.year.ranges — Print single-year ranges (e.g., 1998-1999)
If non-zero, year ranges that span a single year will be printed in range notation (1998-1999) instead of discrete notation (1998, 1999).
make.year.ranges — Collate copyright years into ranges?
If non-zero, copyright years will be collated into ranges.
monospace.font.family — The default font family for monospace environments
The monospace font family is used for verbatim environments (program listings, screens, etc.).
monospace.verbatim.properties — What font and size do you want for monospaced content?
§68: §114 |
<xsl:attribute-set name="monospace.verbatim.properties" use-attribute-sets="verbatim.properties"> <xsl:attribute name="font-family"> <xsl:value-of select="$monospace.font.family"/> </xsl:attribute> <xsl:attribute name="font-size"> <xsl:value-of select="$body.font.master * 0.9"/> <xsl:text>pt</xsl:text> </xsl:attribute> </xsl:attribute-set> |
Specify the font name and size you want for monospaced output
nominal.table.width — The (absolute) nominal width of tables
In order to convert CALS column widths into HTML column widths, it is sometimes necessary to have an absolute table width to use for conversion of mixed absolute and relative widths. This value must be an absolute length (not a percentag).
normal.para.spacing — What space do you want between normal paragraphs
§70: §114 |
<xsl:attribute-set name="normal.para.spacing"> <xsl:attribute name="space-before.optimum">1em</xsl:attribute> <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> </xsl:attribute-set> |
Specify the spacing required between normal paragraphs
page.height — The height of the physical page
§71: §114 |
<xsl:param name="page.height"> <xsl:choose> <xsl:when test="$page.orientation = 'portrait'"> <xsl:value-of select="$page.height.portrait"/> </xsl:when> <xsl:otherwise> <xsl:value-of select="$page.width.portrait"/> </xsl:otherwise> </xsl:choose> </xsl:param> |
The page height is generally calculated from the paper.type and page.orientation.
page.height.portrait — Specify the physical size of the long edge of the page
§72: §114 |
<xsl:param name="page.height.portrait"> <xsl:choose> <xsl:when test="$paper.type = 'A4landscape'">210mm</xsl:when> <xsl:when test="$paper.type = 'USletter'">11in</xsl:when> <xsl:when test="$paper.type = 'USlandscape'">8.5in</xsl:when> <xsl:when test="$paper.type = '4A0'">2378mm</xsl:when> <xsl:when test="$paper.type = '2A0'">1682mm</xsl:when> <xsl:when test="$paper.type = 'A0'">1189mm</xsl:when> <xsl:when test="$paper.type = 'A1'">841mm</xsl:when> <xsl:when test="$paper.type = 'A2'">594mm</xsl:when> <xsl:when test="$paper.type = 'A3'">420mm</xsl:when> <xsl:when test="$paper.type = 'A4'">297mm</xsl:when> <xsl:when test="$paper.type = 'A5'">210mm</xsl:when> <xsl:when test="$paper.type = 'A6'">148mm</xsl:when> <xsl:when test="$paper.type = 'A7'">105mm</xsl:when> <xsl:when test="$paper.type = 'A8'">74mm</xsl:when> <xsl:when test="$paper.type = 'A9'">52mm</xsl:when> <xsl:when test="$paper.type = 'A10'">37mm</xsl:when> <xsl:when test="$paper.type = 'B0'">1414mm</xsl:when> <xsl:when test="$paper.type = 'B1'">1000mm</xsl:when> <xsl:when test="$paper.type = 'B2'">707mm</xsl:when> <xsl:when test="$paper.type = 'B3'">500mm</xsl:when> <xsl:when test="$paper.type = 'B4'">353mm</xsl:when> <xsl:when test="$paper.type = 'B5'">250mm</xsl:when> <xsl:when test="$paper.type = 'B6'">176mm</xsl:when> <xsl:when test="$paper.type = 'B7'">125mm</xsl:when> <xsl:when test="$paper.type = 'B8'">88mm</xsl:when> <xsl:when test="$paper.type = 'B9'">62mm</xsl:when> <xsl:when test="$paper.type = 'B10'">44mm</xsl:when> <xsl:when test="$paper.type = 'C0'">1297mm</xsl:when> <xsl:when test="$paper.type = 'C1'">917mm</xsl:when> <xsl:when test="$paper.type = 'C2'">648mm</xsl:when> <xsl:when test="$paper.type = 'C3'">458mm</xsl:when> <xsl:when test="$paper.type = 'C4'">324mm</xsl:when> <xsl:when test="$paper.type = 'C5'">229mm</xsl:when> <xsl:when test="$paper.type = 'C6'">162mm</xsl:when> <xsl:when test="$paper.type = 'C7'">114mm</xsl:when> <xsl:when test="$paper.type = 'C8'">81mm</xsl:when> <xsl:when test="$paper.type = 'C9'">57mm</xsl:when> <xsl:when test="$paper.type = 'C10'">40mm</xsl:when> <xsl:otherwise>11in</xsl:otherwise> </xsl:choose> </xsl:param> |
The portrait page height is the length of the long edge of the physical page.
page.margin.bottom — The bottom margin of the page
The bottom page margin is the distance from the physical bottom of the page to the last line of text (body or footer).
page.margin.inner — The inner page margin
§74: §114 |
<xsl:param name="page.margin.inner"> <xsl:choose> <xsl:when test="$double.sided != 0">1.25in</xsl:when> <xsl:otherwise>1in</xsl:otherwise> </xsl:choose> </xsl:param> |
The inner page margin is the distance from binding edge of the page to the first column of text. In the left-to-right, top-to-bottom writing direction, this is the left margin of recto pages.
The inner and outer margins are usually the same unless the output is double-sided.
page.margin.outer — The outer page margin
§75: §114 |
<xsl:param name="page.margin.outer"> <xsl:choose> <xsl:when test="$double.sided != 0">0.75in</xsl:when> <xsl:otherwise>10pc</xsl:otherwise> </xsl:choose> </xsl:param> |
The outer page margin is the distance from non-binding edge of the page to the last column of text. In the left-to-right, top-to-bottom writing direction, this is the right margin of recto pages.
The inner and outer margins are usually the same unless the output is double-sided.
page.margin.top — The top margin of the page
The top page margin is the distance from the physical top of the page to the first line of text (body or header).
page.orientation — Select the page orientation
In portrait orientation, the short edge is horizontal; in landscape orientation, it is vertical.
page.width — The width of the physical page
§78: §114 |
<xsl:param name="page.width"> <xsl:choose> <xsl:when test="$page.orientation = 'portrait'"> <xsl:value-of select="$page.width.portrait"/> </xsl:when> <xsl:otherwise> <xsl:value-of select="$page.height.portrait"/> </xsl:otherwise> </xsl:choose> </xsl:param> |
The page width is generally calculated from the paper.type and page.orientation.
page.width.portrait — Specify the physical size of the short edge of the page
§79: §114 |
<xsl:param name="page.width.portrait"> <xsl:choose> <xsl:when test="$paper.type = 'USletter'">8.5in</xsl:when> <xsl:when test="$paper.type = '4A0'">1682mm</xsl:when> <xsl:when test="$paper.type = '2A0'">1189mm</xsl:when> <xsl:when test="$paper.type = 'A0'">841mm</xsl:when> <xsl:when test="$paper.type = 'A1'">594mm</xsl:when> <xsl:when test="$paper.type = 'A2'">420mm</xsl:when> <xsl:when test="$paper.type = 'A3'">297mm</xsl:when> <xsl:when test="$paper.type = 'A4'">210mm</xsl:when> <xsl:when test="$paper.type = 'A5'">148mm</xsl:when> <xsl:when test="$paper.type = 'A6'">105mm</xsl:when> <xsl:when test="$paper.type = 'A7'">74mm</xsl:when> <xsl:when test="$paper.type = 'A8'">52mm</xsl:when> <xsl:when test="$paper.type = 'A9'">37mm</xsl:when> <xsl:when test="$paper.type = 'A10'">26mm</xsl:when> <xsl:when test="$paper.type = 'B0'">1000mm</xsl:when> <xsl:when test="$paper.type = 'B1'">707mm</xsl:when> <xsl:when test="$paper.type = 'B2'">500mm</xsl:when> <xsl:when test="$paper.type = 'B3'">353mm</xsl:when> <xsl:when test="$paper.type = 'B4'">250mm</xsl:when> <xsl:when test="$paper.type = 'B5'">176mm</xsl:when> <xsl:when test="$paper.type = 'B6'">125mm</xsl:when> <xsl:when test="$paper.type = 'B7'">88mm</xsl:when> <xsl:when test="$paper.type = 'B8'">62mm</xsl:when> <xsl:when test="$paper.type = 'B9'">44mm</xsl:when> <xsl:when test="$paper.type = 'B10'">31mm</xsl:when> <xsl:when test="$paper.type = 'C0'">917mm</xsl:when> <xsl:when test="$paper.type = 'C1'">648mm</xsl:when> <xsl:when test="$paper.type = 'C2'">458mm</xsl:when> <xsl:when test="$paper.type = 'C3'">324mm</xsl:when> <xsl:when test="$paper.type = 'C4'">229mm</xsl:when> <xsl:when test="$paper.type = 'C5'">162mm</xsl:when> <xsl:when test="$paper.type = 'C6'">114mm</xsl:when> <xsl:when test="$paper.type = 'C7'">81mm</xsl:when> <xsl:when test="$paper.type = 'C8'">57mm</xsl:when> <xsl:when test="$paper.type = 'C9'">40mm</xsl:when> <xsl:when test="$paper.type = 'C10'">28mm</xsl:when> <xsl:otherwise>8.5in</xsl:otherwise> </xsl:choose> </xsl:param> |
The portrait page width is the length of the short edge of the physical page.
paper.type — Select the paper type
The paper type is a convenient way to specify the paper size. The list of known paper sizes includes USletter and most of the A, B, and C sizes. See page.width.portrait, for example.
part.autolabel — Are parts and references enumerated?
If true (non-zero), unlabeled parts and references will be enumerated.
passivetex.extensions — Enable PassiveTeX extensions?
If non-zero, PassiveTeX extensions will be used. At present, this consists of PDF bookmarks and sorted index terms.
preface.autolabel — Are prefaces enumerated?
If true (non-zero), unlabeled prefaces will be enumerated.
qanda.inherit.numeration — Does enumeration of QandASet components inherit the numeration of parent elements?
If true (non-zero), numbered QandADiv elements and Questions and Answers inherit the numeration of the ancestors of the QandASet.
qandadiv.autolabel — Are divisions in QAndASets enumerated?
If true (non-zero), unlabeled qandadivs will be enumerated.
refentry.generate.name — Output NAME header before 'RefName'(s)?
If true (non-zero), a "NAME" section title is output before the list of 'RefName's.
refentry.xref.manvolnum — Output manvolnum as part of refentry cross-reference?
if true (non-zero), the manvolnum is used when cross-referencing refentrys, either with xref or citerefentry.
region.after.extent — Specifies the height of the footer.
The region after extent is the height of the area where footers are printed.
region.before.extent — Specifies the height of the header
The region before extent is the height of the area where headers are printed.
rootid — Specify the root element to format
If rootid is specified, it must be the value of an ID that occurs in the document being formatted. The entire document will be loaded and parsed, but formatting will begin at the element identified, rather than at the root. For example, this allows you to process only chapter 4 of a book.
Because the entire document is available to the processor, automatic numbering, cross references, and other dependencies are correctly resolved.
runinhead.default.title.end.punct — Default punctuation character on a run-in-head
FIXME:
runinhead.title.end.punct — Characters that count as punctuation on a run-in-head
FIXME:
sans.font.family — The default sans-serif font family
The default sans-serif font family. At the present, this isn't actually used by the stylesheets.
section.autolabel — Are sections enumerated?
If true (non-zero), unlabeled sections will be enumerated.
section.label.includes.component.label — Do section labels include the component label?
If true (non-zero), section labels are prefixed with the label of the component that contains them.
show.comments — Display comment elements?
If true (non-zero), comments will be displayed, otherwise they are suppressed. Comments here refers to the comment element, which will be renamed remark in DocBook V4.0, not XML comments (<-- like this -->) which are unavailable.
stylesheet.result.type — Identifies the output format of this stylesheet
The Saxon extension functions need to know if the output format is HTML ('html') or XSL Formatting Objects ('fo'). This variable answers that question. Valid settings are 'html' or 'fo'.
tablecolumns.extension — Enable the table columns extension function
The table columns extension function adjusts the widths of table columns in the HTML result to more accurately reflect the specifications in the CALS table.
textinsert.extension — Enable the textinsert extension element
The textinsert extension element inserts the contents of a a file into the result tree (as text).
title.font.family — The default font family for titles
The title font family is used for titles (chapter, section, figure, etc.)
toc.margin.properties — FIXME:
§103: §114 |
<xsl:attribute-set name="toc.margin.properties"> <xsl:attribute name="space-before.minimum">0.5em</xsl:attribute> <xsl:attribute name="space-before.optimum">1em</xsl:attribute> <xsl:attribute name="space-before.maximum">2em</xsl:attribute> <xsl:attribute name="space-after.minimum">0.5em</xsl:attribute> <xsl:attribute name="space-after.optimum">1em</xsl:attribute> <xsl:attribute name="space-after.maximum">2em</xsl:attribute> </xsl:attribute-set> |
FIXME:
use.extensions — Enable extensions
If non-zero, extensions may be used. Each extension is further controlled by its own parameter. But if use.extensions is zero, no extensions will be used.
verbatim.properties — FIXME:
§105: §114 |
<xsl:attribute-set name="verbatim.properties"> <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> <xsl:attribute name="space-before.optimum">1em</xsl:attribute> <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> </xsl:attribute-set> |
FIXME:
xep.extensions — Enable XEP extensions?
If non-zero, XEP extensions will be used. XEP extensions consists of PDF bookmarks and document information.
The param.xsl stylesheet is just a wrapper around all these parameters.