From 60a5a938e6657250d228742b8367f8dbe7dd28d4 Mon Sep 17 00:00:00 2001 From: Manuel Canales Esparcia Date: Sat, 21 Jul 2007 15:00:15 +0000 Subject: Merged r8226 from new-xsl branch. git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@8228 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689 --- .../lfs-xsl/docbook-xsl-snapshot/common/common.xsl | 101 ++---- .../lfs-xsl/docbook-xsl-snapshot/common/de.xml | 7 + .../lfs-xsl/docbook-xsl-snapshot/common/en.xml | 7 + .../lfs-xsl/docbook-xsl-snapshot/common/es.xml | 7 + .../lfs-xsl/docbook-xsl-snapshot/common/fr.xml | 7 + .../lfs-xsl/docbook-xsl-snapshot/common/it.xml | 7 + .../lfs-xsl/docbook-xsl-snapshot/common/labels.xsl | 21 +- .../lfs-xsl/docbook-xsl-snapshot/common/pi.xsl | 377 ++++++++++++++------- .../docbook-xsl-snapshot/common/refentry.xsl | 105 +++--- .../lfs-xsl/docbook-xsl-snapshot/common/table.xsl | 10 +- .../docbook-xsl-snapshot/common/utility.xsl | 92 +++-- .../lfs-xsl/docbook-xsl-snapshot/common/zh_cn.xml | 7 + .../lfs-xsl/docbook-xsl-snapshot/common/zh_tw.xml | 7 + 13 files changed, 443 insertions(+), 312 deletions(-) (limited to 'stylesheets/lfs-xsl/docbook-xsl-snapshot/common') diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/common.xsl b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/common.xsl index 484e7ee2d..0f6c378f9 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/common.xsl +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/common.xsl @@ -14,38 +14,24 @@ See ../README or http://docbook.sf.net/release/xsl/current/ for copyright and other information. - This file contains general templates common to both the HTML and FO - versions of the DocBook stylesheets. ******************************************************************** --> - - - -$Id$ - -Walsh -Norman -1999-2007 -Norman Walsh - - -Common Template Reference - - -Introduction - -This is technical reference documentation for the “common” -templates in the DocBook XSL Stylesheets. The common templates are -“common” because they are shared across output formats (that is, -they’re not output-format-dependent). - -This documentation 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. - - - + + + Common » Base Template Reference + + $Id$ + + + + + Introduction + This is technical reference documentation for the “base” + set of common templates in the DocBook XSL Stylesheets. + This is not intended to be user documentation. It is + provided for developers writing customization layers for the + stylesheets. + @@ -183,7 +169,7 @@ manvolnum This template calculates the hierarchical level of a section. -The element sect1 is at level 1, sect2 is +The element sect1 is at level 1, sect2 is at level 2, etc. Recursive sections are calculated down to the fifth level. @@ -1324,45 +1310,24 @@ pointed to by the link is one of the elements listed in - - - - - - - - - - - - - - - - - - - + + + - - - - - + + 1 + select="$list/preceding::orderedlist[1]"/> 2 @@ -1382,7 +1347,6 @@ pointed to by the link is one of the elements listed in - @@ -1903,33 +1867,28 @@ unchanged. localized "choice" separator (for example, "and" or "or") before the final item in an inline list (though it could also be useful for generating choice separators for non-inline lists). - It currently works by evaluating a processing instruction (PI) of the form <?dbchoice choice="foo"?> : - - if the value of the choice + if the value of the choice pseudo-attribute is "and" or "or", returns a localized "and" or "or" otherwise returns the literal value of the - choice pseudo-attribute + choice pseudo-attribute - The latter is provided only as a temporary workaround because the locale files do not currently have translations for the word or. So if you want to generate a a logical "or" separator in French (for example), you currently need to do this: - <?dbchoice choice="ou"?> - - The dbchoice processing instruction is + The dbchoice processing instruction is an unfortunate hack; support for it may disappear in the future (particularly if and when a more appropriate means for marking up "choice" lists becomes available in DocBook). @@ -1937,14 +1896,9 @@ unchanged. - - - - choice - + - @@ -2024,5 +1978,4 @@ engine does not support it. - diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/de.xml b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/de.xml index 79b2201b1..a8233d13c 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/de.xml +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/de.xml @@ -19,6 +19,13 @@ + + + + + + + diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/en.xml b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/en.xml index a5ef40079..1aa99856b 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/en.xml +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/en.xml @@ -19,6 +19,13 @@ + + + + + + + diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/es.xml b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/es.xml index c6d6bb630..11592e1e8 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/es.xml +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/es.xml @@ -19,6 +19,13 @@ + + + + + + + diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/fr.xml b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/fr.xml index 5d590f725..58826b96c 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/fr.xml +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/fr.xml @@ -19,6 +19,13 @@ + + + + + + + diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/it.xml b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/it.xml index a07b68eea..fc473dfef 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/it.xml +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/it.xml @@ -19,6 +19,13 @@ + + + + + + + diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/labels.xsl b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/labels.xsl index 98050d012..38b123a35 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/labels.xsl +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/labels.xsl @@ -193,12 +193,31 @@ element label. + + + + + + + + + - + + + + + + + + diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/pi.xsl b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/pi.xsl index cc2d6c264..5c3df8815 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/pi.xsl +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/pi.xsl @@ -1,11 +1,13 @@ - + - - - +Common Processing Instruction Reference + + $Id$ + + + + Introduction + This is generated reference documentation for all + user-specifiable processing instructions (PIs) in the + “common” part of the DocBook XSL stylesheets. + + You add these PIs at particular points in a document to + cause specific “exceptions” to formatting/output behavior. To + make global changes in formatting/output behavior across an + entire document, it’s better to do it by setting an + appropriate stylesheet parameter (if there is one). + + + + + + + + Generates a localized choice separator + + Use the dbchoice choice PI to + generate an appropriate localized “choice” separator (for + example, and or or) + before the final item in an inline simplelist + + This PI is a less-than-ideal hack; support for it may + disappear in the future (particularly if and when a more + appropriate means for marking up "choice" lists becomes + available in DocBook). + + + + dbchoice choice="and"|"or"|string" + + + + choice="and" + + generates a localized and separator + + + choice="or" + + generates a localized or separator + + + choice="string" + + generates a literal string separator + + + + + + + + + + choice + - + + Inserts a date timestamp + + Use the dbtimestamp PI at any point in a + source document to cause a date timestamp (a formatted + string representing the current date and time) to be + inserted in output of the document. + + + dbtimestamp format="formatstring" [padding="0"|"1"] + + + + format="formatstring" + + Specifies format in which the date and time are + output + + For details of the content of the format string, + see Date and time. + + + + padding="0"|"1" + + Specifies padding behavior; if non-zero, padding is is added + + + + + + @@ -44,8 +137,7 @@ - - + @@ -60,7 +152,6 @@ 1 - @@ -72,10 +163,9 @@ - + function-available('date:dateTime')"> @@ -88,124 +178,169 @@ + + + + Generates delimiters around embedded TeX equations + in output + + Use the dbtex delims PI as a + child of a textobject containing embedded TeX + markup, to cause that markup to be surrounded by + $ delimiter characters in output. + + + dbtex delims="no"|"yes" + + + + dbtex delims="no"|"yes" + + Specifies whether delimiters are output + + + + + + tex.math.delims + + + DBTeXMath + + + + + + + + + + + + + + + + + + - + select="translate($format, + ' ', + '    ')"/> - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0 - - - - 0 - - - - - - - 0 - - - - 0 - - - - 0 - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + 0 + + + + + + + 0 + + + + 0 + + + + 0 + + + + + + + + + + + + + + + + + + + + + + - - - - - Timestamp processing requires an XSLT processor with support - for the EXSLT node-set() function. - - - + + + + Timestamp processing requires an XSLT processor with support + for the EXSLT node-set() function. + + + - diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/refentry.xsl b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/refentry.xsl index 4373e4849..892b9fb72 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/refentry.xsl +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/refentry.xsl @@ -16,36 +16,25 @@ ******************************************************************** --> - - + + + Common » Refentry Metadata Template Reference $Id$ - The DocBook Project - - 2005-2007 - The DocBook Project - - - Refentry Metadata-Gathering Template Reference - - + + + Introduction - - This is technical reference documentation for the "refentry - metadata gathering" templates in the DocBook XSL Stylesheets. - + This is technical reference documentation for the “refentry + metadata” templates in the DocBook XSL Stylesheets. This is not intended to be user documentation. It is provided - for developers writing customization layers for the - stylesheets. - + for developers writing customization layers for the stylesheets. Currently, only the manpages stylesheets make use of these templates. They are, however, potentially useful elsewhere. - - @@ -56,27 +45,27 @@ etc., is sometimes viewed in isolation from its greater "context". For example, users view Unix man pages as, well, individual pages, not as part of a "book" of some kind. Therefore, it is sometimes necessary to - embed "context" information in output for each refentry. + embed "context" information in output for each refentry. However, one problem is that different users mark up that context information in different ways. Often (usually), the context information is not actually part of the content of the - refentry itself, but instead part of the content of a - parent or ancestor element to the the refentry. And + refentry itself, but instead part of the content of a + parent or ancestor element to the the refentry. And even then, DocBook provides a variety of elements that users might potentially use to mark up the same kind of information. One user - might use the productnumber element to mark up version + might use the productnumber element to mark up version information about a particular product, while another might use - the releaseinfo element. + the releaseinfo element. Taking all that in mind, the get.refentry.metadata template tries to gather - metadata from a refentry element and its ancestor + metadata from a refentry element and its ancestor elements in an intelligent and user-configurable way. The basic mechanism used in the XPath expressions throughout this stylesheet is to select the relevant metadata from the *info element that is - closest to the actual refentry – either on the - refentry itself, or on its nearest ancestor. + closest to the actual refentry – either on the + refentry itself, or on its nearest ancestor. The get.refentry.metadata @@ -91,13 +80,13 @@ refname - The first refname in the refentry + The first refname in the refentry info - A set of info nodes (from a refentry + A set of info nodes (from a refentry element and its ancestors) @@ -194,23 +183,23 @@ The man(7) man page describes this as "the title of the man page (e.g., MAN). This differs - from refname in that, if the refentry has a - refentrytitle, we use that as the title; - otherwise, we just use first refname in the first - refnamediv in the source. + from refname in that, if the refentry has a + refentrytitle, we use that as the title; + otherwise, we just use first refname in the first + refnamediv in the source. refname - The first refname in the refentry + The first refname in the refentry - Returns a title node. + Returns a title node. @@ -232,8 +221,8 @@ The man(7) man page describes this as "the section number the man page should be placed in (e.g., - 7)". If we do not find a manvolnum - specified in the source, and we find that the refentry is + 7)". If we do not find a manvolnum + specified in the source, and we find that the refentry is for a function, we use the section number 3 ["Library calls (functions within program libraries)"]; otherwise, we default to using 1 ["Executable programs or shell @@ -244,7 +233,7 @@ refname - The first refname in the refentry + The first refname in the refentry @@ -323,13 +312,13 @@ refname - The first refname in the refentry + The first refname in the refentry info - A set of info nodes (from a refentry + A set of info nodes (from a refentry element and its ancestors) @@ -342,7 +331,7 @@ - Returns a date node. + Returns a date node. @@ -495,13 +484,13 @@ refname - The first refname in the refentry + The first refname in the refentry info - A set of info nodes (from a refentry + A set of info nodes (from a refentry element and its ancestors) @@ -515,7 +504,7 @@ - Returns a source node. + Returns a source node. @@ -611,13 +600,13 @@ refname - The first refname in the refentry + The first refname in the refentry info - A set of info nodes (from a refentry + A set of info nodes (from a refentry element and its ancestors) @@ -795,13 +784,13 @@ refname - The first refname in the refentry + The first refname in the refentry info - A set of info nodes (from a refentry + A set of info nodes (from a refentry element and its ancestors) @@ -981,13 +970,13 @@ refname - The first refname in the refentry + The first refname in the refentry info - A set of info nodes (from a refentry + A set of info nodes (from a refentry element and its ancestors) @@ -1001,7 +990,7 @@ - Returns a manual node. + Returns a manual node. @@ -1140,25 +1129,25 @@ Gets user preferences for refentry metadata gathering The DocBook XSL stylesheets include several user-configurable - global stylesheet parameters for controlling refentry + global stylesheet parameters for controlling refentry metadata gathering. Those parameters are not read directly by the - other refentry metadata-gathering + other refentry metadata-gathering templates. Instead, they are read only by the get.refentry.metadata.prefs template, which assembles them into a structure that is then passed to - the other refentry metadata-gathering + the other refentry metadata-gathering templates. So the, get.refentry.metadata.prefs template is the only interface to collecting stylesheet parameters for - controlling refentry metadata gathering. + controlling refentry metadata gathering. There are no local parameters for this template; however, it does rely on a number of global parameters. - Returns a manual node. + Returns a manual node. @@ -1223,7 +1212,7 @@ refname - The first refname in the refentry + The first refname in the refentry diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/table.xsl b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/table.xsl index 9c0c49844..562d3412a 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/table.xsl +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/table.xsl @@ -124,17 +124,17 @@ Determine the column number in which a given entry occurs -If an entry has a -colname or -namest attribute, this template +If an entry has a +colname or +namest attribute, this template will determine the number of the column in which the entry should occur. -For other entrys, nothing is returned. +For other entrys, nothing is returned. entry -The entry-element which is to be tested. +The entry-element which is to be tested. diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/utility.xsl b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/utility.xsl index 8f9fadd9f..f6b3a0186 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/utility.xsl +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/utility.xsl @@ -3,6 +3,7 @@ xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" xmlns:dyn="http://exslt.org/dynamic" xmlns:saxon="http://icl.com/saxon" + xmlns:xlink="http://www.w3.org/1999/xlink" exclude-result-prefixes="doc dyn saxon" version='1.0'> @@ -15,42 +16,33 @@ copyright and other information. ******************************************************************** --> - - - - -$Id$ - -The DocBook Project Development Team -2007 -The DocBook Project - - -Utility Template Reference - - -Introduction - -This is technical reference documentation for the - miscellaneous utility templates in the DocBook XSL - Stylesheets. - - -These templates are defined in a separate file from the set - of “common” templates because some of the comment templates - reference DocBook XSL stylesheet parameters, requiring the - entire set of parameters to be imported/included in any - stylesheet that imports/includes the common templates. -The utility templates don’t import or include any DocBook - XSL stylesheet parameters, so the utility templates can be used - without importing the whole set of parameters. - - -The following documentation 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. - + + + Common » Utility Template Reference + + $Id$ + + + + + Introduction + This is technical reference documentation for the + miscellaneous utility templates in the DocBook XSL + Stylesheets. + + These templates are defined in a separate file from the set + of “common” templates because some of the comment templates + reference DocBook XSL stylesheet parameters, requiring the + entire set of parameters to be imported/included in any + stylesheet that imports/includes the common templates. + The utility templates don’t import or include any DocBook + XSL stylesheet parameters, so the utility templates can be used + without importing the whole set of parameters. + + This is not intended to be user documentation. It is + provided for developers writing customization layers for the + stylesheets. + @@ -67,8 +59,7 @@ $Id$ - - level + level Text to log/emit in the message-level field to indicate the message level @@ -76,8 +67,7 @@ $Id$ Warning) - - source + source Text to log/emit in the source field to identify the “source” to which the notification/warning relates. @@ -96,15 +86,13 @@ $Id$ XPath expression. - - context-desc + context-desc Text to log/emit in the context-description field to describe the context for the message. - - context-desc-field-length + context-desc-field-length Specifies length of the context-description field (in characters); default is 12 @@ -126,14 +114,12 @@ $Id$ parameter. - - message + message Text to log/emit in the actual message field - - message-field-length + message-field-length Specifies length of the message field (in characters); default is 45 @@ -255,11 +241,11 @@ $Id$ character). This function began as a copy of Nate Austin's - prepend-pad function in the Padding - Content section of Dave Pawson's XSLT - FAQ. + prepend-pad function in the Padding + Content section of Dave Pawson's XSLT + FAQ. diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/zh_cn.xml b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/zh_cn.xml index 9f1c8d431..6a782fca0 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/zh_cn.xml +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/zh_cn.xml @@ -19,6 +19,13 @@ + + + + + + + diff --git a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/zh_tw.xml b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/zh_tw.xml index fbc52f415..db63cdca5 100644 --- a/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/zh_tw.xml +++ b/stylesheets/lfs-xsl/docbook-xsl-snapshot/common/zh_tw.xml @@ -19,6 +19,13 @@ + + + + + + + -- cgit v1.2.3-54-g00ecf