Re: [docbook-apps] invalid EPUB file when using a glossary

From
Peter Lavin <>
Date
2014-07-31T13:55:30+00:00
ID
CALSHAaFjKXY-fe-oVhU44t2G7thDt4E7+TBfu_0fSvt4yYh=
Thread
Re: [docbook-apps] invalid EPUB file when using a glossary
<!DOCTYPE glossary
[
<!ENTITY % all.entities SYSTEM "all-entities.ent">
%all.entities;
]>
<glossary xmlns="http://docbook.org/ns/docbook"
  xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0"
   xml:id="db.gloss">

  <info>

    <title>Glossary</title>

  </info>

<!-- Add an id for items with acronyms so that an acronym entry can be
created. -->

  <!--glossentry xml:id="db.gloss.">

    <glossterm></glossterm>

    <acronym></acronym>

    <indexterm>
      <primary></primary>
    </indexterm>

    <glossdef>
      <para></para>
    </glossdef>

  </glossentry-->

  <glossentry xml:id="db.gloss.css">

    <glossterm>Cascading Style Sheets</glossterm>

    <acronym>CSS</acronym>

    <indexterm>
      <primary>Cascading Style Sheets</primary>
    </indexterm>

    <glossdef>
      <para>...</para>
    </glossdef>

  </glossentry>

  <glossentry xml:id="db.gloss.epub">

    <glossterm>EPUB (3.0)</glossterm>

    <indexterm>
      <primary>EPUB</primary>
    </indexterm>

    <glossdef>
      <para>
        The EPUB specification is an industry standard for defining how
        an ebook is packaged as a single file. Some ebook vendors,
        Google, Apple and Kobo, for example, require that any books
        submitted for sale must conform to this standard. There are
        DocBook style sheets for creating files compliant with EPUB 3.0.
        See also <xref linkend="db.gloss.idpf"/>.
      </para>
    </glossdef>

  </glossentry>

  <glossentry xml:id="db.gloss.idpf">

    <glossterm>International Digital Publishing Forum</glossterm>

    <acronym>IDPF</acronym>

    <indexterm>
      <primary>International Digital Publishing Forum</primary>
    </indexterm>

    <glossdef>
      <para>
        The IDPF is a "standards organization dedicated to the
        development and promotion of electronic publishing and content
        consumption." This organization is responsible for defining the
        <xref linkend="db.gloss.epub"/> standard
      </para>
      <para>
        For more information see
        <link xl:href="http://idpf.org/about-us">International Digital
        Publishing Forum</link>.
      </para>
    </glossdef>

  </glossentry>

  <glossentry xml:id="db.gloss.json">

    <glossterm>JavaScript Object Notation</glossterm>

    <acronym>JSON</acronym>

    <indexterm>
      <primary>JSON</primary>
    </indexterm>

    <glossdef>
      <para>
        JavaScript Object Notation is ...
      </para>
    </glossdef>

  </glossentry>

  <glossentry xml:id="db.gloss.ocf">

    <glossterm>Open Container Format</glossterm>

    <acronym>OCF</acronym>

    <indexterm>
      <primary>Open Container Format (OCF)</primary>
    </indexterm>

    <glossdef>
      <para>
        The file format and process that defines the resources that make
        up one or more EPUB publications. This standard was created by
        the <xref linkend="db.gloss.idpf"/> and facilitates the
        distribution of ebooks in a single-file format.
      </para>
      <para>
        For more information see
        <link xl:href="http://www.idpf.org/epub/30/spec/epub30-ocf.html">EPUB
        Open Container Format (OCF) 3.0</link>.
      </para>
    </glossdef>

  </glossentry>

  <glossentry xml:id="db.gloss.pandoc">

    <glossterm>Pandoc</glossterm>

    <indexterm>
      <primary>pandoc</primary>
    </indexterm>

    <glossdef>
      <para></para>
    </glossdef>

  </glossentry>

  <glossentry xml:id="db.gloss.profile">

    <glossterm>Profiling</glossterm>

    <indexterm>
      <primary>profiling</primary>
    </indexterm>

    <glossdef>
      <para>
        One of the advantages of using DocBook to create documents is
        the ability to use profiling. With profiling you can select
        portions of a document for output rather than the complete
        contents. Profiling is used to create different documents from
        the same DocBook files depending upon the values passed to the
        <literal>profile.condition</literal> parameter. Creating more
        than one document from the same source files can greatly reduce
        maintenance.
      </para>
      <para>
        To use profiling follow these steps:
      </para>
      <orderedlist>

        <listitem>
          <para>
            Add appropriate <literal>condition</literal> attributes to
            your DocBook file or files
          </para>
        </listitem>

        <listitem>
          <para>
            Apply the profile style sheet being sure that the right
            values are associated with the
            <literal>profile.condition</literal> string.
          </para>
        </listitem>

        <listitem>
          <para>
            Process the file output by step two.
          </para>
        </listitem>

      </orderedlist>
    </glossdef>

  </glossentry>

  <glossentry xml:id="db.gloss.xsl">

    <glossterm>Extensible Stylesheet Language</glossterm>

    <acronym>XSL</acronym>

    <indexterm>
      <primary>xsl</primary>
    </indexterm>

    <glossdef>
      <para>Extensible Stylesheet Language </para>
    </glossdef>

  </glossentry>

</glossary>