<?xml version="1.0" encoding="ASCII"?> <book version="5.0" xml:id="slides_xhtml_doc"> <info> <title>Slides XHTML Parameter Reference</title> <releaseinfo role="meta"> $Id$ </releaseinfo> <author> <personname> <surname>Kövesdán</surname> <firstname>Gábor</firstname> </personname> </author> <copyright> <year>2012</year> <holder>Gábor Kövesdán</holder> </copyright> <abstract> <para>This is reference documentation for all user-configurable parameters in the DocBook XSL Slides XHTML stylesheet. Note that the Slides stylesheet for XHTML output is a customization layer of the DocBook XSL XHTML stylesheet. Therefore, in addition to the slides-specific parameters listed in this section, you can also use a number of <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../fo/">XHTML stylesheet parameters</link> to control Slides XHTML output.</para> </abstract> </info> <reference xml:id="xhtml"> <title>XHTML: General Params</title> <refentry version="5.0" xml:id="disable.collapsible"> <refmeta> <refentrytitle>disable.collapsible</refentrytitle> <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> </refmeta> <refnamediv> <refname>disable.collapsible</refname> <refpurpose>Specifies whether collapsible rendering is enabled</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="disable.collapsible.frag"> <xsl:param name="disable.collapsible">0</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies whether elements marked as collapsible are generated as such in the output document.</para> </refsection> </refentry> <refentry version="5.0" xml:id="disable.incremental"> <refmeta> <refentrytitle>disable.incremental</refentrytitle> <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> </refmeta> <refnamediv> <refname>disable.incremental</refname> <refpurpose>Specifies whether incremental rendering is enabled</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="disable.incremental.frag"> <xsl:param name="disable.incremental">0</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies whether elements marked as incremental are generated as such in the output document.</para> </refsection> </refentry> <refentry version="5.0" xml:id="generate.copyright"> <refmeta> <refentrytitle>generate.copyright</refentrytitle> <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> </refmeta> <refnamediv> <refname>generate.copyright</refname> <refpurpose>Specifies whether copyright is generated</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="generate.copyright.frag"> <xsl:param name="generate.copyright">1</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies whether the copyright info is generated in the footer area.</para> </refsection> </refentry> <refentry version="5.0" xml:id="generate.foilgroup.numbered.toc"> <refmeta> <refentrytitle>generate.foilgroup.numbered.toc</refentrytitle> <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> </refmeta> <refnamediv> <refname>generate.foilgroup.numbered.toc</refname> <refpurpose>Specifies whether foilgroups have a numbered TOC</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="generate.foilgroup.numbered.toc.frag"> <xsl:param name="generate.foilgroup.numbered.toc">1</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>If TOC generation is turned on, this parameter specifies whether foilgroups have a numbered TOC. If disabled, TOC items will be bulleted, not numbered.</para> </refsection> </refentry> <refentry version="5.0" xml:id="generate.foilgroup.toc"> <refmeta> <refentrytitle>generate.foilgroup.toc</refentrytitle> <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> </refmeta> <refnamediv> <refname>generate.foilgroup.toc</refname> <refpurpose>Specifies whether foilgroups have a TOC</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="generate.foilgroup.toc.frag"> <xsl:param name="generate.foilgroup.toc">1</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies whether foilgroups will contain a table of contents of the included foils.</para> </refsection> </refentry> <refentry version="5.0" xml:id="generate.handoutnotes"> <refmeta> <refentrytitle>generate.handoutnotes</refentrytitle> <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> </refmeta> <refnamediv> <refname>generate.handoutnotes</refname> <refpurpose>Specifies whether handoutnotes are generated</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="generate.handoutnotes.frag"> <xsl:param name="generate.handoutnotes">0</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies whether handoutnotes shall be generated to the output.</para> </refsection> </refentry> <refentry version="5.0" xml:id="generate.pubdate"> <refmeta> <refentrytitle>generate.pubdate</refentrytitle> <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> </refmeta> <refnamediv> <refname>generate.pubdate</refname> <refpurpose>Specifies whether the pubdate is generated</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="generate.pubdate.frag"> <xsl:param name="generate.pubdate">1</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies whether the publication date is generated in the footer area.</para> </refsection> </refentry> <refentry version="5.0" xml:id="generate.speakernotes"> <refmeta> <refentrytitle>generate.speakernotes</refentrytitle> <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> </refmeta> <refnamediv> <refname>generate.speakernotes</refname> <refpurpose>Specifies whether speakernotes are generated</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="generate.speakernotes.frag"> <xsl:param name="generate.speakernotes">0</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies whether speakernotes shall be generated to the output.</para> </refsection> </refentry> <refentry version="5.0" xml:id="generate.titlepage"> <refmeta> <refentrytitle>generate.titlepage</refentrytitle> <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> </refmeta> <refnamediv> <refname>generate.titlepage</refname> <refpurpose>Specifies whether titlepage is generated</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="generate.titlepage.frag"> <xsl:param name="generate.titlepage">1</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies whether titlepage is generated for the presentation.</para> </refsection> </refentry> <refentry version="5.0" xml:id="mml.embedding.mode"> <refmeta> <refentrytitle>mml.embedding.mode</refentrytitle> <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> <refmiscinfo class="other" otherclass="value">inline</refmiscinfo> <refmiscinfo class="other" otherclass="value">object</refmiscinfo> <refmiscinfo class="other" otherclass="value">image</refmiscinfo> <refmiscinfo class="other" otherclass="value">link</refmiscinfo> <refmiscinfo class="other" otherclass="value">iframe</refmiscinfo> <refmiscinfo class="other" otherclass="value">embed</refmiscinfo> </refmeta> <refnamediv> <refname>mml.embedding.mode</refname> <refpurpose>Specifies how inline MathML is processed</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="mml.embedding.mode.frag"> <xsl:param name="mml.embedding.mode">inline</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies how inline MathML formulas are embedded into the output document.</para> <variablelist> <varlistentry> <term>inline</term> <listitem> <para>Content is copied over inline with its namespace.</para> </listitem> </varlistentry> <varlistentry> <term>object</term> <listitem> <para>Content is extracted into an externel file and referenced by an <markup>object</markup> element.</para> </listitem> </varlistentry> <varlistentry> <term>image</term> <listitem> <para>Content is extracted into an externel file and referenced by an <markup>img</markup> element.</para> </listitem> </varlistentry> <varlistentry> <term>link</term> <listitem> <para>Content is extracted into an externel file and referenced by an <markup>a</markup> element.</para> </listitem> </varlistentry> <varlistentry> <term>iframe</term> <listitem> <para>Content is extracted into an externel file and referenced by an <markup>iframe</markup> element.</para> </listitem> </varlistentry> <varlistentry> <term>embed</term> <listitem> <para>Content is extracted into an externel file and referenced by an <markup>embed</markup> element.</para> </listitem> </varlistentry> </variablelist> </refsection> </refentry> <refentry version="5.0" xml:id="svg.embedding.mode"> <refmeta> <refentrytitle>svg.embedding.mode</refentrytitle> <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> <refmiscinfo class="other" otherclass="value">inline</refmiscinfo> <refmiscinfo class="other" otherclass="value">object</refmiscinfo> <refmiscinfo class="other" otherclass="value">image</refmiscinfo> <refmiscinfo class="other" otherclass="value">link</refmiscinfo> <refmiscinfo class="other" otherclass="value">iframe</refmiscinfo> <refmiscinfo class="other" otherclass="value">embed</refmiscinfo> </refmeta> <refnamediv> <refname>svg.embedding.mode</refname> <refpurpose>Specifies how inline SVG is processed</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="svg.embedding.mode.frag"> <xsl:param name="svg.embedding.mode">object</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies how inline SVG graphics are embedded into the output document.</para> <variablelist> <varlistentry> <term>inline</term> <listitem> <para>Content is copied over inline with its namespace.</para> </listitem> </varlistentry> <varlistentry> <term>object</term> <listitem> <para>Content is extracted into an externel file and referenced by an <markup>object</markup> element.</para> </listitem> </varlistentry> <varlistentry> <term>image</term> <listitem> <para>Content is extracted into an externel file and referenced by an <markup>img</markup> element.</para> </listitem> </varlistentry> <varlistentry> <term>link</term> <listitem> <para>Content is extracted into an externel file and referenced by an <markup>a</markup> element.</para> </listitem> </varlistentry> <varlistentry> <term>iframe</term> <listitem> <para>Content is extracted into an externel file and referenced by an <markup>iframe</markup> element.</para> </listitem> </varlistentry> <varlistentry> <term>embed</term> <listitem> <para>Content is extracted into an externel file and referenced by an <markup>embed</markup> element.</para> </listitem> </varlistentry> </variablelist> </refsection> </refentry> <refentry version="5.0" xml:id="user.css"> <refmeta> <refentrytitle>user.css</refentrytitle> <refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo> </refmeta> <refnamediv> <refname>user.css</refname> <refpurpose>Specifies the path to user-supplied CSS</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="user.css.frag"> <xsl:param name="user.css">user.css</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the path from where the CSS styling is read. This file can be used to add additional styling to the slides.</para> </refsection> </refentry> <refentry version="5.0" xml:id="wrap.slidecontent"> <refmeta> <refentrytitle>wrap.slidecontent</refentrytitle> <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> </refmeta> <refnamediv> <refname>wrap.slidecontent</refname> <refpurpose>Specifies whether the foil content is wrapped into a div</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="wrap.slidecontent.frag"> <xsl:param name="wrap.slidecontent">0</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies whether the foil content is wrapped into a div so that additional styling can be applied.</para> </refsection> </refentry> </reference> <reference xml:id="s5"> <title>XHTML: S5 Params</title> <refentry version="5.0" xml:id="s5.controls"> <refmeta> <refentrytitle>s5.controls</refentrytitle> <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> </refmeta> <refnamediv> <refname>s5.controls</refname> <refpurpose>Specifies whether S5 controls are visible</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="s5.controls.frag"> <xsl:param name="s5.controls">0</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies whether S5 navigation controls are visible by default.</para> </refsection> </refentry> <refentry version="5.0" xml:id="s5.defaultview"> <refmeta> <refentrytitle>s5.defaultview</refentrytitle> <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> <refmiscinfo class="other" otherclass="value">slideshow</refmiscinfo> <refmiscinfo class="other" otherclass="value">outline</refmiscinfo> </refmeta> <refnamediv> <refname>s5.defaultview</refname> <refpurpose>Specifies the default S5 view</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="s5.defaultview.frag"> <xsl:param name="s5.defaultview">slideshow</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies, which is the default view in the generated S5 presentation.</para> </refsection> </refentry> <refentry version="5.0" xml:id="s5.opera.css"> <refmeta> <refentrytitle>s5.opera.css</refentrytitle> <refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo> </refmeta> <refnamediv> <refname>s5.opera.css</refname> <refpurpose>Specifies the name of the S5 Opera-specific CSS file</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="s5.opera.css.frag"> <xsl:param name="s5.opera.css">opera.css</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the name of the S5 Opera-specific CSS file.</para> </refsection> </refentry> <refentry version="5.0" xml:id="s5.outline.css"> <refmeta> <refentrytitle>s5.outline.css</refentrytitle> <refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo> </refmeta> <refnamediv> <refname>s5.outline.css</refname> <refpurpose>Specifies the name of the S5 outline CSS file</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="s5.outline.css.frag"> <xsl:param name="s5.outline.css">outline.css</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the name of the S5 outline CSS file.</para> </refsection> </refentry> <refentry version="5.0" xml:id="s5.path.prefix"> <refmeta> <refentrytitle>s5.path.prefix</refentrytitle> <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo> </refmeta> <refnamediv> <refname>s5.path.prefix</refname> <refpurpose>Specifies the path to S5 files</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="s5.path.prefix.frag"> <xsl:param name="s5.path.prefix">files/s5/ui/default/</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the path where S5 CSS and JavaScript files reside. All the CSS and JavaScript paths will be generated relative to this directory.</para> </refsection> </refentry> <refentry version="5.0" xml:id="s5.print.css"> <refmeta> <refentrytitle>s5.print.css</refentrytitle> <refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo> </refmeta> <refnamediv> <refname>s5.print.css</refname> <refpurpose>Specifies the name of the S5 print CSS file</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="s5.print.css.frag"> <xsl:param name="s5.print.css">print.css</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the name of the S5 print CSS file.</para> </refsection> </refentry> <refentry version="5.0" xml:id="s5.slides.css"> <refmeta> <refentrytitle>s5.slides.css</refentrytitle> <refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo> </refmeta> <refnamediv> <refname>s5.slides.css</refname> <refpurpose>Specifies the name of the S5 slides CSS file</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="s5.slides.css.frag"> <xsl:param name="s5.slides.css">slides.css</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the name of the S5 slides CSS file.</para> </refsection> </refentry> <refentry version="5.0" xml:id="s5.slides.js"> <refmeta> <refentrytitle>s5.slides.js</refentrytitle> <refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo> </refmeta> <refnamediv> <refname>s5.slides.js</refname> <refpurpose>Specifies the name of the S5 slides JavaScript file</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="s5.slides.js.frag"> <xsl:param name="s5.slides.js">slides.js</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the name of the S5 slides JavaScript file.</para> </refsection> </refentry> </reference> <reference xml:id="slidy"> <title>XHTML: Slidy Params</title> <refentry version="5.0" xml:id="slidy.duration"> <refmeta> <refentrytitle>slidy.duration</refentrytitle> <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo> </refmeta> <refnamediv> <refname>slidy.duration</refname> <refpurpose>Specifies the duration of the presentation</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="slidy.duration.frag"> <xsl:param name="slidy.duration">0</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the duration of the presentation in minutes. A JavaScript clock will count down to help the speaker in not running out of time. Can be disabled if set to 0.</para> </refsection> </refentry> <refentry version="5.0" xml:id="slidy.path.prefix"> <refmeta> <refentrytitle>slidy.path.prefix</refentrytitle> <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo> </refmeta> <refnamediv> <refname>slidy.path.prefix</refname> <refpurpose>Specifies the path to Slidy files</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="slidy.path.prefix.frag"> <xsl:param name="slidy.path.prefix">files/slidy/</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the path where Slidy CSS and JavaScript files reside. All the CSS and JavaScript paths will be generated relative to this directory.</para> </refsection> </refentry> <refentry version="5.0" xml:id="slidy.slidy.css"> <refmeta> <refentrytitle>slidy.slidy.css</refentrytitle> <refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo> </refmeta> <refnamediv> <refname>slidy.slidy.css</refname> <refpurpose>Specifies the name of the main Slidy CSS file</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="slidy.slidy.css.frag"> <xsl:param name="slidy.slidy.css">styles/slidy.css</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the name of the main Slidy CSS file.</para> </refsection> </refentry> <refentry version="5.0" xml:id="slidy.slidy.js"> <refmeta> <refentrytitle>slidy.slidy.js</refentrytitle> <refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo> </refmeta> <refnamediv> <refname>slidy.slidy.js</refname> <refpurpose>Specifies the name of the Slidy JavaScript file</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="slidy.slidy.js.frag"> <xsl:param name="slidy.slidy.js">scripts/slidy.js</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the name of the Slidy JavaScript file.</para> </refsection> </refentry> <refentry version="5.0" xml:id="slidy.user.css"> <refmeta> <refentrytitle>slidy.user.css</refentrytitle> <refmiscinfo class="other" otherclass="datatype">filename</refmiscinfo> </refmeta> <refnamediv> <refname>slidy.user.css</refname> <refpurpose>Specifies the name of the Slidy user CSS file</refpurpose> </refnamediv> <refsynopsisdiv> <programlisting xml:id="slidy.user.css.frag"> <xsl:param name="slidy.user.css">styles/w3c-blue.css</xsl:param> </programlisting> </refsynopsisdiv> <refsection><info><title>Description</title></info> <para>This parameter specifies the name of the Slidy user CSS file.</para> </refsection> </refentry> </reference> <appendix xml:id="styleheet"><title>The Stylesheet</title> <para>The <filename>param.xsl</filename> stylesheet is just a wrapper around all these parameters.</para> <programlisting xml:id="top"> <!-- This file is generated from param.xweb --> <xsl:stylesheet exclude-result-prefixes="src" version="1.0"> <!-- ******************************************************************** $Id: param.xweb 6633 2007-02-21 18:33:33Z xmldoc $ ******************************************************************** This file is part of the DocBook Slides Stylesheet distribution. See ../README or http://docbook.sf.net/release/xsl/current/ for copyright and other information. ******************************************************************** --> <src:fragref linkend="disable.collapsible.frag"></src:fragref> <src:fragref linkend="disable.incremental.frag"></src:fragref> <src:fragref linkend="generate.copyright.frag"></src:fragref> <src:fragref linkend="generate.foilgroup.numbered.toc.frag"></src:fragref> <src:fragref linkend="generate.foilgroup.toc.frag"></src:fragref> <src:fragref linkend="generate.handoutnotes.frag"></src:fragref> <src:fragref linkend="generate.pubdate.frag"></src:fragref> <src:fragref linkend="generate.speakernotes.frag"></src:fragref> <src:fragref linkend="generate.titlepage.frag"></src:fragref> <src:fragref linkend="mml.embedding.mode.frag"></src:fragref> <src:fragref linkend="svg.embedding.mode.frag"></src:fragref> <src:fragref linkend="user.css.frag"></src:fragref> <src:fragref linkend="wrap.slidecontent.frag"></src:fragref> <src:fragref linkend="s5.controls.frag"></src:fragref> <src:fragref linkend="s5.defaultview.frag"></src:fragref> <src:fragref linkend="s5.opera.css.frag"></src:fragref> <src:fragref linkend="s5.outline.css.frag"></src:fragref> <src:fragref linkend="s5.path.prefix.frag"></src:fragref> <src:fragref linkend="s5.print.css.frag"></src:fragref> <src:fragref linkend="s5.slides.css.frag"></src:fragref> <src:fragref linkend="s5.slides.js.frag"></src:fragref> <src:fragref linkend="slidy.duration.frag"></src:fragref> <src:fragref linkend="slidy.path.prefix.frag"></src:fragref> <src:fragref linkend="slidy.slidy.css.frag"></src:fragref> <src:fragref linkend="slidy.slidy.js.frag"></src:fragref> <src:fragref linkend="slidy.user.css.frag"></src:fragref> </xsl:stylesheet> </programlisting> </appendix> </book>
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#1 | 26953 | Paul Allen | Move //guest/perforce_software/p4convert to //guest/perforce_software/p4convert/main | ||
//guest/perforce_software/p4convert/docs/docbook-xsl-ns-1.78.1/slides/xhtml/param.xml | |||||
#2 | 14806 | Paul Allen | Update docs and add +w. | ||
#1 | 13920 | Paul Allen | copy part 2 (no errors) | ||
//guest/paul_allen/p4convert-maven/docs/docbook-xsl-ns-1.78.1/slides/xhtml/param.xml | |||||
#1 | 13895 | Paul Allen | Copying using p4convert-docbook | ||
//guest/perforce_software/doc_build/main/docbook-xsl-ns-1.78.1/slides/xhtml/param.xml | |||||
#1 | 12728 | eedwards |
Upgrade ANT doc build infrastructure to assemble PDFs: - remove non-namespaced DocBook source and add namespaced DocBook source. - add Apache FOP 1.1 - copy fonts, images, XSL into _build, establishing new asset structure. The original structure remains until all guides using it can be upgraded, and several other issues can be resolved. - updated build.xml to allow for per-target build properties. - upgraded the P4SAG to use the new infrastructure. - tweaked admonition presentation in PDFs to remove admonition graphics, and resemble closely the presentation used in the new HTML layout, including the same colors. With these changes, building PDFs involves using a shell, navigating into the guide's directory (just P4SAG for now), and executing "ant pdf". Issues still to be resolved: - PDF generation encounters several warnings about missing fonts (bold versions of Symbol and ZapfDingbats), and a couple of locations where the page content exceeds the defined content area. - Due to issues within Apache FOP, PDF generation emits a substantial amount of output that is not easily suppressed without losing important warning information. - Apache FOP's interface to ANT does not expose a way to set the font base directory. The current configuration does work under Mac OSX, but further testing on Windows will need to be done to determine if the relative paths defined continue to work. The workaround is for Windows users to customize the fop-config.xml to provide absolute system paths to the required fonts. - HTML generation needs further browser testing, and exhibits broken navigation on iOS browsers within the TOC sidebar. - A number of PDF and HTML presentation tweaks still need to be made, for example: sidebars, gui* DocBook tags, whitespace, section separation, etc. |