param.xweb

数据仓库工具

<!DOCTYPE book [
<!ENTITY % param.ent SYSTEM "param.ent">
%param.ent;
]>
<book xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<bookinfo>
<title>FO Parameter Reference</title>
<releaseinfo role="meta">
$Id: param.xweb,v 1.1 2003/05/22 13:35:04 sinisa Exp $
</releaseinfo>
<author>
  <surname>Walsh</surname>
  <firstname>Norman</firstname>
</author>
<copyright>
  <year>1999</year>
  <year>2000</year>
  <year>2001</year>
  <holder>Norman Walsh</holder>
</copyright>
</bookinfo>

<preface><title>Introduction</title>

<para>This is technical reference documentation for the DocBook XSL
Stylesheets; it documents (some of) the parameters, templates, and
other elements of the stylesheets.</para>

<para>This reference describes each of the HTML Stylesheet parameters.
These are the <quote>easily customizable</quote> 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 <quote>driver</quote> stylesheet.</para>

<para>For example, if you want to change the <literal>html.stylesheet</literal>
to <filename>reference.css</filename>, you might create a driver
stylesheet like this:</para>

<programlisting><![CDATA[<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>]]></programlisting>

<para>Naturally, you have to change the
<sgmltag class='attribute'>href</sgmltag> attribute on
<literal>&lt;xsl:import&gt;</literal> to point to
<filename>docbook.xsl</filename> on your system. (Or
<filename>chunk.xsl</filename>, if you're using chunking.)</para>

<para>This is not intended to be <quote>user</quote> documentation.
It is provided for developers writing customization layers for the
stylesheets, and for anyone who's interested in <quote>how it
works</quote>.</para>

<para>Although I am trying to be thorough, this documentation is known
to be incomplete. Don't forget to read the source, too :-)</para>
</preface>

<reference><title>Admonitions</title>
&admon.graphics;
&admon.graphics.extension;
&admon.graphics.path;
&admonition.title.properties;
&admonition.properties;
</reference>

<reference><title>Callouts</title>
&callout.defaultcolumn;
&callout.graphics;
&callout.graphics.extension;
&callout.graphics.number.limit;
&callout.graphics.path;
&callout.unicode;
&callout.unicode.font;
&callout.unicode.number.limit;
&callout.unicode.start.character;
&callouts.extension;
</reference>

<reference><title>ToC/LoT/Index Generation</title>
&autotoc.label.separator;
&process.empty.source.toc;
&process.source.toc;
&generate.toc;
&generate.index;
&make.index.markup;
&toc.section.depth;
&toc.indent.width;
&toc.margin.properties;
&bridgehead.in.toc;
&generate.section.toc.level;

<!--
annotate.toc;
bridgehead.in.toc;
manual.toc;
generate.section.toc.level;
-->

</reference>

<reference><title>Processor Extensions</title>
&arbortext.extensions;
&fop.extensions;
&passivetex.extensions;
&tex.math.in.alt;
&tex.math.delims;
&xep.extensions;
</reference>

<reference><title>Stylesheet Extensions</title>
&linenumbering.everyNth;
&linenumbering.extension;
&linenumbering.separator;
&linenumbering.width;
&tablecolumns.extension;
&textinsert.extension;
&use.extensions;
</reference>

<reference><title>Automatic labelling</title>
&appendix.autolabel;
&chapter.autolabel;
&part.autolabel;
&preface.autolabel;
&section.autolabel;
&section.label.includes.component.label;
&label.from.part;
</reference>

<reference><title>XSLT Processing</title>
&rootid;
</reference>

<reference><title>Meta/*Info</title>
&make.single.year.ranges;
&make.year.ranges;
&author.othername.in.middle;
</reference>

<reference><title>Reference Pages</title>
&funcsynopsis.decoration;
&funcsynopsis.style;
&function.parens;
&refentry.generate.name;
&refentry.generate.title;
&refentry.title.properties;
&refentry.xref.manvolnum;
</reference>

<reference><title>Tables</title>
&default.table.width;
&nominal.table.width;
&table.cell.padding;
&table.frame.border.thickness;
&table.frame.border.style;
&table.frame.border.color;
&table.cell.border.thickness;
&table.cell.border.style;
&table.cell.border.color;
</reference>

<reference><title>Linking</title>
&target.database.document;
&use.local.olink.style;
&current.docid;
&olink.doctitle;
</reference>

<reference><title>QAndASet</title>
&qandadiv.autolabel;
&qanda.inherit.numeration;
</reference>

<reference><title>Bibliography</title>
&biblioentry.item.separator;
&bibliography.collection;
&bibliography.numbered;
</reference>

<reference><title>Glossary</title>
&glossterm.auto.link;
&firstterm.only.link;
&glossary.collection;
&glossterm.separation;
&glossterm.width;
&glossary.as.blocks;
&glosslist.as.blocks;
</reference>

<reference><title>Miscellaneous</title>
&formal.procedures;
&formal.title.placement;
&runinhead.default.title.end.punct;
&runinhead.title.end.punct;
&show.comments;
&punct.honorific;
&segmentedlist.as.table;
&variablelist.as.blocks;
&blockquote.properties;
&ulink.show;
&ulink.footnotes;
&ulink.hyphenate;
&shade.verbatim;
&shade.verbatim.style;
&use.svg;
&use.role.as.xrefstyle;
&menuchoice.separator;
&menuchoice.menu.separator;
&default.float.class;
</reference>

<reference><title>Graphics</title>
&graphic.default.extension;
&default.image.width;
</reference>

<reference><title>Pagination and General Styles</title>
<partintro>
<section><title>Understanding XSL FO Margins</title>

<para>In order for the parameters in this section to make sense, it is useful to
consider <xref linkend="fig.pagemodel"/>.</para>

<figure id="fig.pagemodel">
<mediaobject>
<imageobject>
<imagedata fileref="page.png"/>
</imageobject>
<textobject><phrase>Figure showing page margins</phrase></textobject>
<textobject>
<para>This figure shows the physical page with the various FO page regions
identified.</para>
</textobject>
</mediaobject>
</figure>

<para>First, let's consider the regions on the page.</para>

<para>The white region is the physical page. Its dimensions are determined by
the <parameter>page.height</parameter> and <parameter>page.width</parameter>
parameters.</para>

<para>The yellow region is the region-body. The size and placement of
the region body is constrained by the dimensions labelled in the
figure.</para>

<para>The pink region at the top of the page is the region-before. The
darker area inside the region-before is the header text. In XSL, the default
display alignment for a region is <literal>before</literal>, but the
DocBook stylesheets still explicitly make it <literal>before</literal>. That's
why the darker area is at the top.</para>

<para>The pink region at the bottom of the page is the region-after.
The darker area is the footer text. In XSL, the default display
alignment for a region is <literal>before</literal>,
but the DocBook stylesheets explicitly make it
<literal>after</literal>. That's why the darker area is at the bottom.</para>

<para>The dimensions in the figure are:</para>

<orderedlist numeration="upperalpha">
<listitem><para>The page-master margin-top.
</para></listitem>
<listitem><para>The region-before extent.
</para></listitem>
<listitem><para>The region-body margin-top.
</para></listitem>
<listitem><para>The region-after extent.
</para></listitem>
<listitem><para>The page-master margin-bottom.
</para></listitem>
<listitem><para>The region-body margin-bottom.
</para></listitem>
<listitem><para>The sum of the page-master margin-left and the
region-body margin-left. In DocBook, the region-body margin-left is
zero by default, so this is simply the page-master region-left.
</para></listitem>
<listitem><para>The sum of the page-master margin-right and the
region-body margin-right. In DocBook, the region-body margin-right is
zero by default, so this is simply the page-master region-left.
</para></listitem>
</orderedlist>

</section>
</partintro>

&page.height;
&page.height.portrait;
&page.margin.bottom;
&page.margin.inner;
&page.margin.outer;
&page.margin.top;
&page.orientation;
&page.width;
&page.width.portrait;
&paper.type;
&double.sided;
&body.margin.bottom;
&body.margin.top;
&alignment;
&hyphenate;
&line-height;
&column.count.back;