All Downloads are FREE. Search and download functionalities are using the official Maven repository.

xslt.base.common.common.xsl Maven / Gradle / Ivy












Common Templates Reference

  
    Walsh
    Norman
  

2004
Norman Walsh




Introduction This is technical reference documentation for the DocBook XSL Stylesheets; it documents (some of) the parameters, templates, and other elements of the stylesheets. 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 :-)
Formats a personal name This template formats a personal name. It supports several styles that may be specified with a role attribute on the element (personname, author, editor, and othercredit) or with the locale. node The node containing the personal name. The formatted personal name. Formats a personal name in the “family given” style This template formats a personal name in the “family given” style. It is generally called by person-name template. node The node containing the personal name. The formatted personal name. [FAMILY Given] Mode for converting text to upper-case This mode is used to convert the text in a subtree to upper-case. It returns a copy of the subtree with all text() nodes converted to upper-case. Formats a personal name in the “last, first” style This template formats a personal name in the “last, first” style. It is generally called by person-name template. node The node containing the personal name. The formatted personal name. , Formats a personal name in the “first last” style This template formats a personal name in the “first last” style. It is generally called by person-name template. node The node containing the personal name. The formatted personal name. , Formats a list of personal names This template formats a list of personal names, for example in an authorgroup. The list of names is assumed to be in the current context node. node The node containing the personal name. The formatted personal name. Mode for inserting element labels (numbers) This mode is used to insert numbers for numbered elements. Any element processed in this mode should generate its number. Print a set of years with collapsed ranges This template prints a list of year elements with consecutive years printed as a range. In other words: 1992 1993 1994]]> is printed 1992-1994, whereas: 1992 1994]]> is printed 1992, 1994. This template assumes that all the year elements contain only decimal year numbers, that the elements are sorted in increasing numerical order, that there are no duplicates, and that all the years are expressed in full century+year (1999 not 99) notation. years The initial set of year elements. print.ranges If non-zero, multi-year ranges are collapsed. If zero, all years are printed discretely. single.year.ranges If non-zero, two consecutive years will be printed as a range, otherwise, they will be printed discretely. In other words, a single year range is 1991-1992 but discretely it's 1991, 1992. This template returns the formatted list of years. , , - , , , - , Selects and processes an appropriate media object from a list This template takes a list of media objects (usually the children of a mediaobject or inlinemediaobject) and processes the "right" object. This template relies on f:select-mediaobject-index to determine which object in the list is appropriate. If no acceptable object is located, nothing happens. olist The node list of potential objects to examine. Calls <xsl:apply-templates> on the selected object. Selects the position of the appropriate media object from a list This function takes a list of media objects (usually the children of a mediaobject or inlinemediaobject) and determines the "right" object. It returns the position of that object to be used by the calling template. If the global parameter use.role.for.mediaobject is nonzero, then it first checks for an object with a role attribute of the appropriate value. It takes the first of those. Otherwise, it takes the first acceptable object in the list. This template relies on a f:is-acceptable-mediaobject to determine if a given object is an acceptable graphic. The semantics of media objects is that the first acceptable graphic should be used. If no acceptable object is located, no index is returned. olist The node list of potential objects to examine. Returns the position of the selected object in the original list or 0 if no object is selected. Returns '1' if the specified media object is recognized. This template examines a media object and returns '1' if the object is recognized as a graphic. object The media object to consider. 0 or 1 0 1 1 1 0 . . / Returns an “id” attribute if appropriate This template returns an attribute named “id” if the specified node has an id (or xml:id) attribute or if the force parameter is non-zero. If an ID is generated, it's value is f:node-id(). node The node for which an ID should be generated. It defaults to the context item. force To force an “id” attribute to be generated, even if the node does not have an ID, make this parameter non-zero. It defaults to 0. An “id” attribute or nothing. Warn users about references to non-unique IDs If passed an ID in linkend, t:check-id-unique prints a warning message to the user if either the ID does not exist or the ID is not unique. Error: no ID for constraint linkend: . Warning: multiple "IDs" for constraint linkend: . Warn users about incorrectly typed references If passed an ID in linkend, t:check-idref-targets makes sure that the element pointed to by the link is one of the elements listed in element-list and warns the user otherwise. The element-list is a list of QNames. Error: linkend ( ) points to " " not (one of):




© 2015 - 2024 Weber Informatics LLC | Privacy Policy