+++ /dev/null
-<?xml version="1.0"?>\r
-\r
-<reference xml:id="template"><?dbhtml dir="template"?><?dbhtml filename="index.html"?>\r
- \r
- \r
- <info>\r
- <title>Titlepage Template Stylesheet Reference</title>\r
- <releaseinfo role="meta">\r
- $Id: titlepage.xsl 7058 2007-07-17 13:59:29Z xmldoc $\r
- </releaseinfo>\r
- </info>\r
- <partintro xml:id="intro_partintro">\r
- <title>Introduction</title>\r
- \r
-<para>This is technical reference documentation for the\r
- “titlepage” templates in the DocBook XSL Stylesheets.</para>\r
-\r
- \r
-<para>This is not intended to be user documentation. It is\r
- provided for developers writing customization layers for the\r
- stylesheets.</para>\r
-\r
- </partintro>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="templates">\r
-<refnamediv>\r
-<refname>t:templates</refname>\r
-<refpurpose>Construct a stylesheet for the templates provided</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="t:templates"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>The <literal>t:templates</literal> element is the root of a\r
-set of templates. This template creates an appropriate\r
-<literal>xsl:stylesheet</literal> for the templates.</para>\r
-\r
-\r
-\r
-<para>If the <literal>t:templates</literal> element has a\r
-<literal>base-stylesheet</literal> attribute, an\r
-<literal>xsl:import</literal> statement is constructed for it.</para>\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="star">\r
-<refnamediv>\r
-<refname>xsl:*</refname>\r
-<refpurpose>Copy xsl: elements straight through</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="xsl:*"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>This template simply copies the xsl: elements\r
-straight through into the result tree.</para>\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="titlepage">\r
-<refnamediv>\r
-<refname>t:titlepage</refname>\r
-<refpurpose>Create the templates necessary to construct a title page</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="t:titlepage"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>The <literal>t:titlepage</literal> element creates a set of\r
-templates for processing the titlepage for an element. The\r
-<quote>root</quote> of this template set is the template named\r
-<quote><literal>wrapper.titlepage</literal></quote>. That is the\r
-template that should be called to generate the title page.\r
-</para>\r
-\r
-\r
-\r
-<para>The <literal>t:titlepage</literal> element has three attributes:\r
-\r
-\r
-<variablelist>\r
-<varlistentry><term>element</term>\r
-<listitem>\r
-<para>The name of the source document element for which\r
-these templates apply. In other words, to make a title page for the\r
-<tag>article</tag> element, set the\r
-<tag class="attribute">element</tag> attribute to\r
-<quote><literal>article</literal></quote>. This attribute is required.\r
-</para>\r
-</listitem>\r
-</varlistentry>\r
-<varlistentry><term>wrapper</term>\r
-<listitem>\r
-<para>The entire title page can be wrapped with an element.\r
-This attribute identifies that element.\r
-</para>\r
-</listitem>\r
-</varlistentry>\r
-<varlistentry><term>class</term>\r
-<listitem>\r
-<para>If the <tag class="attribute">class</tag> attribute\r
-is set, a <tag class="attribute">class</tag> attribute with this\r
-value will be added to the wrapper element that surrounds the entire\r
-title page.\r
-</para>\r
-</listitem>\r
-</varlistentry>\r
-</variablelist>\r
-\r
-</para>\r
-\r
-\r
-\r
-<para>Any other attributes are copied through literally to the\r
-wrapper element.</para>\r
-\r
-\r
-\r
-<para>The content of a <literal>t:titlepage</literal> is one or\r
-more <literal>t:titlepage-content</literal>,\r
-<literal>t:titlepage-separator</literal>, and\r
-<literal>t:titlepage-before</literal> elements.</para>\r
-\r
-\r
-\r
-<para>Each of these elements may be provided for the <quote>recto</quote>\r
-and <quote>verso</quote> sides of the title page.</para>\r
-\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="attr_star_in_copy.literal.atts">\r
-<refnamediv>\r
-<refname>@* (in copy.literal.atts mode)</refname>\r
-<refpurpose>Copy t:titlepage attributes</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="@*" mode="copy.literal.atts"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>This template copies all of the <quote>other</quote> attributes\r
-from a <literal>t:titlepage</literal> element onto the specified\r
-wrapper.</para>\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="titlepage-content">\r
-<refnamediv>\r
-<refname>t:titlepage-content</refname>\r
-<refpurpose>Create templates for the content of one side of a title page</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="t:titlepage-content"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>The title page content, that is, the elements from the source\r
-document that are rendered on the title page, can be controlled independently\r
-for the recto and verso sides of the title page.</para>\r
-\r
-\r
-\r
-<para>The <literal>t:titlepage-content</literal> element has two attributes:\r
-\r
-\r
-<variablelist>\r
-<varlistentry><term>side</term>\r
-<listitem>\r
-<para>Identifies the side of the page to which this title\r
-page content applies. The\r
-<tag class="attribute">side</tag> attribute is required and\r
-must be set to either \r
-<quote><literal>recto</literal></quote> or\r
-<quote><literal>verso</literal></quote>. In addition, you must specify\r
-exactly one <literal>t:titlepage-content</literal> for each side\r
-within each <literal>t:titlepage</literal>.</para>\r
-\r
-</listitem>\r
-</varlistentry>\r
-<varlistentry><term>order</term>\r
-<listitem>\r
-<para>Indicates how the order of the elements presented on\r
-the title page is determined. If the\r
-<tag class="attribute">order</tag> is\r
-<quote><literal>document</literal></quote>, the elements are presented\r
-in document order. Otherwise (if the\r
-<tag class="attribute">order</tag> is\r
-<quote><literal>stylesheet</literal></quote>), the elements are presented\r
-in the order that they appear in the template (and consequently in\r
-the stylesheet).</para>\r
-\r
-</listitem>\r
-</varlistentry>\r
-</variablelist>\r
-\r
-</para>\r
-\r
-\r
-\r
-<para>The content of a <literal>t:titlepage-content</literal> element is\r
-a list of element names. These names should be unqualified. They identify\r
-the elements in the source document that should appear on the title page.\r
-</para>\r
-\r
-\r
-\r
-<para>Each element may have a single attribute:\r
-<tag class="attribute">predicate</tag>. The value of this\r
-attribute is used as a predicate for the expression that matches\r
-the element on which it occurs.</para>\r
-\r
-\r
-\r
-<para>In other words, to put only the first three authors on the\r
-recto-side of a title\r
-page, you could specify:\r
-\r
-<screen>\r
- <t:titlepage-contents side="recto">\r
- <!-- other titlepage elements -->\r
- <author predicate="[count(previous-sibling::author)<2]"/>\r
- <!-- other titlepage elements -->\r
- </t:titlepage-contents>\r
-</screen>\r
-</para>\r
-\r
-\r
-\r
-<para>Usually, the elements so named are empty. But it is possible to\r
-make one level of selection within them. Suppose that you want to\r
-process <literal>authorgroup</literal> elements on the title page, but\r
-you want to select only proper authors, editors, or corporate authors,\r
-not collaborators or other credited authors.</para>\r
-\r
-\r
-\r
-<para>In that case, you can put a <literal>t:or</literal> group inside\r
-the <literal>authorgroup</literal> element:\r
-\r
-<screen>\r
- <t:titlepage-contents side="recto">\r
- <!-- other titlepage elements -->\r
- <authorgroup>\r
- <t:or>\r
- <author/>\r
- <editor/>\r
- <corpauthor/>\r
- </t:or>\r
- </authorgroup>\r
- <!-- other titlepage elements -->\r
- </t:titlepage-contents>\r
-</screen>\r
-</para>\r
-\r
-\r
-\r
-<para>This will have the effect of automatically generating a template\r
-for processing <literal>authorgroup</literal>s in the title page mode,\r
-selecting only the specified children. If you need more complex processing,\r
-you'll have to construct the templates by hand.</para>\r
-\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="titlepage-separator">\r
-<refnamediv>\r
-<refname>t:titlepage-separator</refname>\r
-<refpurpose>Create templates for the separator</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="t:titlepage-separator"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>The title page is separated from the content which follows it by\r
-the markup specified in the <literal>t:titlepage-separator</literal>\r
-element.</para>\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="titlepage-before">\r
-<refnamediv>\r
-<refname>t:titlepage-before</refname>\r
-<refpurpose>Create templates for what precedes a title page</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="t:titlepage-before"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>Each side of the title page is preceded by the markup specified\r
-in the <literal>t:titlepage-before</literal> element for that\r
-side.</para>\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="star_in_copy">\r
-<refnamediv>\r
-<refname>* (in copy mode)</refname>\r
-<refpurpose>Copy elements</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="*" mode="copy"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>This template simply copies the elements that it applies to\r
-straight through into the result tree.</para>\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="attr_star_in_copy">\r
-<refnamediv>\r
-<refname>@* (in copy mode)</refname>\r
-<refpurpose>Copy attributes</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="@*" mode="copy"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>This template simply copies the attributes that it applies to\r
-straight through into the result tree.</para>\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="attr_star_in_document.order">\r
-<refnamediv>\r
-<refname>* (in document.order mode)</refname>\r
-<refpurpose>Create rules to process titlepage elements in document order</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="*" mode="document.order"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>This template is called to process all of the children of the\r
-<literal>t:titlepage-content</literal> element. It creates the hairy\r
-select expression necessary to process each of those elements in\r
-the title page.</para>\r
-\r
-\r
-\r
-<para>Note that this template automatically handles the case where\r
-some DocBook elements, like title and subtitle, can occur both inside\r
-the *info elements where metadata is usually stored and outside.\r
-</para>\r
-\r
-\r
-\r
-<para>It also automatically calculates the name for the *info container\r
-and handles elements that have historically had containers with different\r
-names.</para>\r
-\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="star_in_document.order">\r
-<refnamediv>\r
-<refname>* (in document.order mode)</refname>\r
-<refpurpose>Create rules to process titlepage elements in stylesheet order</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="*" mode="document.order"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>This template is called to process all of the children of the\r
-<literal>t:titlepage-content</literal> element. It creates the set\r
-of <literal>xsl:apply-templates</literal> elements necessary\r
-process each of those elements in the title page.</para>\r
-\r
-\r
-\r
-<para>Note that this template automatically handles the case where\r
-some DocBook elements, like title and subtitle, can occur both inside\r
-the *info elements where metadata is usually stored and outside.\r
-</para>\r
-\r
-\r
-\r
-<para>It also automatically calculates the name for the *info container\r
-and handles elements that have historically had containers with different\r
-names.</para>\r
-\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="star_in_titlepage.specialrules">\r
-<refnamediv>\r
-<refname>* (in titlepage.specialrules mode)</refname>\r
-<refpurpose>Create templates for special rules</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="*" mode="titlepage.specialrules"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>This template is called to process all of the descendants of the\r
-<literal>t:titlepage-content</literal> element that require special\r
-processing. At present, that's just <literal>t:or</literal> elements.\r
-</para>\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="star_in_titlepage.subrules">\r
-<refnamediv>\r
-<refname>* (in titlepage.subrules mode)</refname>\r
-<refpurpose>Create template for individual special rules</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="*" mode="titlepage.subrules"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>This template is called to process the children of special\r
-template elements.\r
-</para>\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="or">\r
-<refnamediv>\r
-<refname>t:or</refname>\r
-<refpurpose>Process the t:or special rule</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="t:or"/><xsl:template match="t:or" mode="titlepage.subrules"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>This template processes t:or.</para>\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="or_in_titlepage.subrules">\r
-<refnamediv>\r
-<refname>t:or (in titlepage.subrules mode)</refname>\r
-<refpurpose>Process the t:or special rule in\r
-titlepage.subrules mode</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template match="t:or" mode="titlepage.subrules"/></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>The titlepage.subrules mode doesn't apply to t:or, so just\r
-reprocess this node in the normal mode.</para>\r
-\r
-</refsect1></refentry>\r
-\r
-<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.element-or-list">\r
-<refnamediv>\r
-<refname>element-or-list</refname>\r
-<refpurpose>Construct the "or-list" used in the select attribute for\r
-special rules.</refpurpose>\r
-</refnamediv>\r
-<refsynopsisdiv>\r
-<synopsis><xsl:template name="element-or-list">\r
-<xsl:param name="elements" select="*"/>\r
-<xsl:param name="element.count" select="count($elements)"/>\r
-<xsl:param name="count" select="1"/>\r
-<xsl:param name="orlist"/>\r
- ...\r
-</xsl:template></synopsis>\r
-</refsynopsisdiv>\r
-<refsect1><title>Description</title>\r
-\r
-<para>Walk through each of the children of t:or, producing the\r
-text of the select attribute.</para>\r
-\r
-</refsect1></refentry>\r
-</reference>\r
-\r
projects / Evergreen-DocBook.git / blobdiff