booky 0.0.4 → 0.0.6

data/lib/stylesheets/params/hyphenate.verbatim.xml

@@ -1,45 +0,0 @@
-<refentry xmlns="http://docbook.org/ns/docbook"
-          xmlns:xlink="http://www.w3.org/1999/xlink"
-          xmlns:xi="http://www.w3.org/2001/XInclude"
-          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
-          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-          version="5.0" xml:id="hyphenate.verbatim">
-<refmeta>
-<refentrytitle>hyphenate.verbatim</refentrytitle>
-<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>hyphenate.verbatim</refname>
-<refpurpose>Should verbatim environments be hyphenated on space characters?</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<src:fragment xml:id="hyphenate.verbatim.frag"><xsl:param name="hyphenate.verbatim" select="0"/></src:fragment>
-</refsynopsisdiv>
-
-<refsection><info><title>Description</title></info>
-
-<para>If the lines of program listing are too long to fit into one
-line it is quite common to split them at space and indicite by hook
-arrow that code continues on the next line. You can turn on this
-behaviour for <tag>programlisting</tag>,
-<tag>screen</tag> and <tag>synopsis</tag> elements by
-using this parameter.</para>
-
-<para>Note that you must also enable line wrapping for verbatim environments and
-select appropriate hyphenation character (e.g. hook arrow). This can
-be done using <parameter>monospace.verbatim.properties</parameter>
-attribute set:</para>
-
-<programlisting>&lt;xsl:attribute-set name="monospace.verbatim.properties" 
-                   use-attribute-sets="verbatim.properties monospace.properties"&gt;
-  &lt;xsl:attribute name="wrap-option"&gt;wrap&lt;/xsl:attribute&gt;
-  &lt;xsl:attribute name="hyphenation-character"&gt;&amp;#x25BA;&lt;/xsl:attribute&gt;
-&lt;/xsl:attribute-set&gt;</programlisting>
-
-<para>For a list of arrows available in Unicode see <uri xlink:href="http://www.unicode.org/charts/PDF/U2190.pdf">http://www.unicode.org/charts/PDF/U2190.pdf</uri> and <uri xlink:href="http://www.unicode.org/charts/PDF/U2900.pdf">http://www.unicode.org/charts/PDF/U2900.pdf</uri> and make sure that
-selected character is available in the font you are using for verbatim
-environments.</para>
-
-</refsection>
-</refentry>

data/lib/stylesheets/params/hyphenate.xml

@@ -1,29 +0,0 @@
-<refentry xmlns="http://docbook.org/ns/docbook"
-          xmlns:xlink="http://www.w3.org/1999/xlink"
-          xmlns:xi="http://www.w3.org/2001/XInclude"
-          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
-          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-          version="5.0" xml:id="hyphenate">
-<refmeta>
-<refentrytitle>hyphenate</refentrytitle>
-<refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
-<refmiscinfo class="other" otherclass="list-type">closed</refmiscinfo>
-<refmiscinfo class="other" otherclass="value">true</refmiscinfo>
-<refmiscinfo class="other" otherclass="value">false</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>hyphenate</refname>
-<refpurpose>Specify hyphenation behavior</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<src:fragment xml:id="hyphenate.frag"><xsl:param name="hyphenate">true</xsl:param></src:fragment>
-</refsynopsisdiv>
-
-<refsection><info><title>Description</title></info>
-
-<para>If true, words may be hyphenated. Otherwise, they may not.
-</para>
-
-</refsection>
-</refentry>

data/lib/stylesheets/params/id.warnings.xml

@@ -1,25 +0,0 @@
-<refentry xmlns="http://docbook.org/ns/docbook"
-          xmlns:xlink="http://www.w3.org/1999/xlink"
-          xmlns:xi="http://www.w3.org/2001/XInclude"
-          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
-          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-          version="5.0" xml:id="id.warnings">
-<refmeta>
-<refentrytitle>id.warnings</refentrytitle>
-<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>id.warnings</refname>
-<refpurpose>Should warnings be generated for titled elements without IDs?</refpurpose>
-</refnamediv>
-<refsynopsisdiv>
-<src:fragment xml:id="id.warnings.frag">
-<xsl:param name="id.warnings" select="0"/>
-</src:fragment>
-</refsynopsisdiv>
-<refsection><info><title>Description</title></info>
-<para>If non-zero, the stylesheet will issue a warning for any element
-(other than the root element) which has a <tag>title</tag> but does not have an
-ID.</para>
-</refsection>
-</refentry>

data/lib/stylesheets/params/ignore.image.scaling.xml

@@ -1,28 +0,0 @@
-<refentry xmlns="http://docbook.org/ns/docbook"
-          xmlns:xlink="http://www.w3.org/1999/xlink"
-          xmlns:xi="http://www.w3.org/2001/XInclude"
-          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
-          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-          version="5.0" xml:id="ignore.image.scaling">
-<refmeta>
-<refentrytitle>ignore.image.scaling</refentrytitle>
-<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>ignore.image.scaling</refname>
-<refpurpose>Tell the stylesheets to ignore the author's image scaling attributes</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<src:fragment xml:id="ignore.image.scaling.frag">
-<xsl:param name="ignore.image.scaling" select="0"/>
-</src:fragment>
-</refsynopsisdiv>
-
-<refsection><info><title>Description</title></info>
-
-<para>If non-zero, the scaling attributes on graphics and media objects are
-ignored.</para>
-
-</refsection>
-</refentry>

data/lib/stylesheets/params/img.src.path.xml

@@ -1,40 +0,0 @@
-<refentry xmlns="http://docbook.org/ns/docbook"
-          xmlns:xlink="http://www.w3.org/1999/xlink"
-          xmlns:xi="http://www.w3.org/2001/XInclude"
-          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
-          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-          version="5.0" xml:id="img.src.path">
-<refmeta>
-<refentrytitle>img.src.path</refentrytitle>
-<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>img.src.path</refname>
-<refpurpose>Path to HTML/FO image files</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<src:fragment xml:id="img.src.path.frag"><xsl:param name="img.src.path"/></src:fragment>
-</refsynopsisdiv>
-
-<refsection><info><title>Description</title></info>
-
-<para>Add a path prefix to the value of the <tag class="attribute">fileref</tag> 
-attribute of <tag>graphic</tag>, <tag>inlinegraphic</tag>, and <tag>imagedata</tag> elements. The resulting 
-compound path is used in the output as the value of the <tag class="attribute">src</tag> 
-attribute of <tag class="element">img</tag> (HTML) or <tag class="element">external-graphic</tag> (FO).
-</para>
-
-<para>
-The path given by <literal>img.src.path</literal> could be relative to the directory where the HTML/FO
-files are created, or it could be an absolute URI.
-The default value is empty.
-Be sure to include a trailing slash if needed.
-</para>
-
-<para>This prefix is not applied to any filerefs that start
-with "/" or contain "//:".
-</para>
-
-</refsection>
-</refentry>

data/lib/stylesheets/params/index.div.title.properties.xml

@@ -1,39 +0,0 @@
-<refentry xmlns="http://docbook.org/ns/docbook"
-          xmlns:xlink="http://www.w3.org/1999/xlink"
-          xmlns:xi="http://www.w3.org/2001/XInclude"
-          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
-          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-          version="5.0" xml:id="index.div.title.properties">
-<refmeta>
-<refentrytitle>index.div.title.properties</refentrytitle>
-<refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>index.div.title.properties</refname>
-<refpurpose>Properties associated with the letter headings in an
-index</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<src:fragment xml:id="index.div.title.properties.frag">
-<xsl:attribute-set name="index.div.title.properties">
-  <xsl:attribute name="margin-{$direction.align.start}">0pt</xsl:attribute>
-  <xsl:attribute name="font-size">14.4pt</xsl:attribute>
-  <xsl:attribute name="font-family"><xsl:value-of select="$title.fontset"/></xsl:attribute>
-  <xsl:attribute name="font-weight">bold</xsl:attribute>
-  <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
-  <xsl:attribute name="space-before.optimum"><xsl:value-of select="concat($body.font.master,'pt')"/></xsl:attribute>
-  <xsl:attribute name="space-before.minimum"><xsl:value-of select="concat($body.font.master,'pt * 0.8')"/></xsl:attribute>
-  <xsl:attribute name="space-before.maximum"><xsl:value-of select="concat($body.font.master,'pt * 1.2')"/></xsl:attribute>
-  <xsl:attribute name="start-indent">0pt</xsl:attribute>
-</xsl:attribute-set>
-</src:fragment>
-</refsynopsisdiv>
-
-<refsection><info><title>Description</title></info>
-
-<para>This attribute set is used on the letter headings that separate
-the divisions in an index.</para>
-
-</refsection>
-</refentry>

data/lib/stylesheets/params/index.entry.properties.xml

@@ -1,33 +0,0 @@
-<refentry xmlns="http://docbook.org/ns/docbook"
-          xmlns:xlink="http://www.w3.org/1999/xlink"
-          xmlns:xi="http://www.w3.org/2001/XInclude"
-          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
-          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-          version="5.0" xml:id="index.entry.properties">
-<refmeta>
-<refentrytitle>index.entry.properties</refentrytitle>
-<refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>index.entry.properties</refname>
-<refpurpose>Properties applied to the formatted entries
-in an index</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<src:fragment xml:id="index.entry.properties.frag">
-<xsl:attribute-set name="index.entry.properties">
-  <xsl:attribute name="start-indent">0pt</xsl:attribute>
-</xsl:attribute-set>
-</src:fragment>
-</refsynopsisdiv>
-
-<refsection><info><title>Description</title></info>
-
-<para>This attribute set is applied to the block containing
-the entries in a letter division in an index.  It can be used to set the
-font-size, font-family, and other inheritable properties that will be
-applied to all index entries.</para>
-
-</refsection>
-</refentry>

data/lib/stylesheets/params/index.links.to.section.xml

@@ -1,76 +0,0 @@
-<refentry xmlns="http://docbook.org/ns/docbook"
-          xmlns:xlink="http://www.w3.org/1999/xlink"
-          xmlns:xi="http://www.w3.org/2001/XInclude"
-          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
-          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-          version="5.0" xml:id="index.links.to.section">
-<refmeta>
-<refentrytitle>index.links.to.section</refentrytitle>
-<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>index.links.to.section</refname>
-<refpurpose>HTML index entries link to container section title</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<src:fragment xml:id="index.links.to.section.frag">
-<xsl:param name="index.links.to.section" select="1"/>
-</src:fragment>
-</refsynopsisdiv>
-
-<refsection><info><title>Description</title></info>
-
-<para>If zero, then an index entry in an index links
-directly to the location of the
-generated <tag>anchor</tag> that is output
-for the indexterm. If two identical indexterm elements
-exist in the same section, then both entries appear
-in the index with the same title but link to different
-locations.</para>
-
-<para>If non-zero, then an index entry in an index links to the
-section title containing the <tag>indexterm</tag>, rather than
-directly to the <tag>anchor</tag> output for the indexterm.
-Duplicate indexterm entries in the same section are dropped.
-</para>
-
-<para>The default value is 1, so index entries link to
-section titles by default.</para>
-
-<para>In both cases, the link text in an index entry is the
-title of the section containing the indexterm.
-That is because HTML does not have numbered pages.
-It also provides the reader with context information
-for each link.</para>
-
-<para>This parameter lets you choose which style of
-index linking you want. </para>
-
-<itemizedlist>
-<listitem>
-<para>When set to 0, an index entry takes you 
-to the precise location of its corresponding indexterm.
-However, if you have a lot of duplicate
-entries in sections, then you have a lot of duplicate
-titles in the index, which makes it more cluttered.
-The reader may not recognize why duplicate titles
-appear until they follow the links. Also, the links
-may land the reader in the middle of a section where the
-section title is not visible, which may also be
-confusing to the reader.</para>
-</listitem>
-<listitem>
-<para>When set to 1, an index entry link is
-less precise, but duplicate titles in the
-index entries are eliminated. 
-Landing on the section title location may confirm the reader's
-expectation that a link that
-shows a section title will take them to that section title,
-not a location within the section.
-</para>
-</listitem>
-</itemizedlist>
-
-</refsection>
-</refentry>

data/lib/stylesheets/params/index.method.xml

@@ -1,162 +0,0 @@
-<refentry xmlns="http://docbook.org/ns/docbook"
-          xmlns:xlink="http://www.w3.org/1999/xlink"
-          xmlns:xi="http://www.w3.org/2001/XInclude"
-          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
-          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-          version="5.0" xml:id="index.method">
-<refmeta>
-<refentrytitle>index.method</refentrytitle>
-<refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
-<refmiscinfo class="other" otherclass="value">basic</refmiscinfo>
-<refmiscinfo class="other" otherclass="value">kosek</refmiscinfo>
-<refmiscinfo class="other" otherclass="value">kimber</refmiscinfo>
-</refmeta>
-<refnamediv>
-<refname>index.method</refname>
-<refpurpose>Select method used to group index entries in an index</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
-<src:fragment xml:id="index.method.frag">
-<xsl:param name="index.method">basic</xsl:param>
-</src:fragment>
-</refsynopsisdiv>
-
-<refsection><info><title>Description</title></info>
-
-<para>This parameter lets you select which method to use for sorting and grouping
- index entries in an index.
-Indexes in Latin-based languages that have accented characters typically
-sort together accented words and unaccented words.
-Thus <quote>Á</quote> (U+00C1 LATIN CAPITAL LETTER A WITH ACUTE) would sort together
-with <quote>A</quote> (U+0041 LATIN CAPITAL LETTER A), so both would appear in the <quote>A</quote>
-section of the index.
-Languages using other alphabets (such as Russian,  which is written in the Cyrillic alphabet)
-and languages using ideographic chararacters (such as Japanese)
-require grouping specific to the languages and alphabets.
-</para>
-
-<para>The default indexing method is limited.
-It can group accented characters in Latin-based languages only.
-It cannot handle non-Latin alphabets or ideographic languages.
-The other indexing methods require extensions of one type or
-another, and do not work with
-all XSLT processors, which is why they are not used by default.</para>
-
-<para>The three choices for indexing method are:</para>
-<variablelist>
-<varlistentry>
-<term><literal>basic</literal></term>
-<listitem>
-<para>
-(default)  Sort and groups words based only on the Latin alphabet.
-Words with accented Latin letters will group and sort with
-their respective primary letter, but
-words in non-Latin alphabets will be
-put in the <quote>Symbols</quote> section of the index.
-</para>
-</listitem>
-</varlistentry>
-<varlistentry>
-<term><literal>kosek</literal></term>
-<listitem>
-<para>
-This method sorts and groups words based on letter groups configured in
-the DocBook locale file for the given language.
-See, for example, the French locale file <filename>common/fr.xml</filename>.
-This method requires that the XSLT processor
-supports the EXSLT extensions (most do).
-It also requires support for using 
-user-defined functions in xsl:key (xsltproc does not).
-</para>
-<para>This method is suitable for any language for which you can
-list all the individual characters that should appear
-in each letter group in an index.
-It is probably not practical to use it for ideographic languages
-such as Chinese that have hundreds or thousands of characters.
-</para>
-
-<para>To use the kosek method, you must:</para>
-
-<orderedlist>
-<listitem>
-<para>Use a processor that supports its extensions, such as
-Saxon 6 or Xalan (xsltproc and Saxon 8 do not).
-</para>
-</listitem>
-<listitem>
-<para>Set the index.method parameter's value to <quote>kosek</quote>.
-</para>
-</listitem>
-<listitem>
-<para>Import the appropriate index extensions stylesheet module
-<filename>fo/autoidx-kosek.xsl</filename> or 
-<filename>html/autoidx-kosek.xsl</filename> into your
-customization.
-</para>
-</listitem>
-</orderedlist>
-
-</listitem>
-</varlistentry>
-<varlistentry>
-<term><literal>kimber</literal></term>
-<listitem>
-<para>
-This method uses extensions to the Saxon processor to implement
-sophisticated indexing processes. It uses its own 
-configuration file, which can include information for any number of
-languages. Each language's configuration can group
-words using one of two processes. In the
-enumerated process similar to that used in the kosek method,
-you indicate the groupings character-by-character.
-In the between-key process, you specify the
-break-points in the sort order that should start a new group.
-The latter configuration is useful for ideographic languages
-such as Chinese, Japanese, and Korean.
-You can also define your own collation algorithms and how you
-want mixed Latin-alphabet words sorted.</para>
-<itemizedlist>
-<listitem>
-<para>For a whitepaper describing the extensions, see:
-<link xlink:href="http://www.innodata-isogen.com/knowledge_center/white_papers/back_of_book_for_xsl_fo.pdf">http://www.innodata-isogen.com/knowledge_center/white_papers/back_of_book_for_xsl_fo.pdf</link>.
-</para>
-</listitem>
-<listitem>
-<para>To download the extension library, see
-<link xlink:href="http://www.innodata-isogen.com/knowledge_center/tools_downloads/i18nsupport">http://www.innodata-isogen.com/knowledge_center/tools_downloads/i18nsupport</link>.
-</para>
-</listitem>
-</itemizedlist>
-
-<para>To use the kimber method, you must:</para>
-
-<orderedlist>
-<listitem>
-<para>Use Saxon (version 6 or 8) as your XSLT processor.
-</para>
-</listitem>
-<listitem>
-<para>Install and configure the Innodata Isogen library, using
-the documentation that comes with it.
-</para>
-</listitem>
-<listitem>
-<para>Set the index.method parameter's value to <quote>kimber</quote>.
-</para>
-</listitem>
-<listitem>
-<para>Import the appropriate index extensions stylesheet module
-<filename>fo/autoidx-kimber.xsl</filename> or 
-<filename>html/autoidx-kimber.xsl</filename> into your
-customization.
-</para>
-</listitem>
-</orderedlist>
-
-</listitem>
-</varlistentry>
-</variablelist>
-
-</refsection>
-</refentry>