<chapter id="usingdocbooktags">
<title><!--Using DocBook Tags-->DocBook タグの使い方</title>

  <section id="docbookintro">
    <title><!--Introduction-->はじめに</title>

    <!--
    <para>DocBook defines a set of markup elements useful for marking
    up text so that the text can then be transformed into several
    different formats.</para>
    -->
<para>DocBook では、テキストをマークアップ(markup)する一連の便利なマークアップ
エレメント(element)を定義して、テキストをいろいろな異なるフォーマットに変換で
きるようにしています。</para>

    <!--
    <para>It's possible to create documents in different formats
    <acronym>HTML</acronym>, <acronym>XML</acronym>, <acronym>RTF</acronym>,
    TeX, and others.</para>
    -->
<para>DocBook を使うと、<acronym>HTML</acronym> や <acronym>XML</acronym>, 
<acronym>RTF</acronym>, <acronym>TeX</acronym> その他の異なるフォーマット
の文書を生成できます。</para>

    <!--
    <para>The idea is to write just once and reach the largest possible number
    of people with the information.</para>
    -->
<para>これは、つまり、DocBook で文書を作成しておけば、可能な限り最大多数の
ひとたちに情報を伝えることができるということです。</para>

    <!--
    <para>Digital information not stored properly tends to get lost. Due to the
    fact that not containing uncommon characters (such as binary formats) it's
    possible to index and search directly on the documents written on 
    <acronym>SGML</acronym> and
    consequently on DocBook.</para>
    -->
<para>適切に保管されていないデジタル情報は、いざという時に見つからなかったり
するものです。(バイナリフォーマットのような)通常とは異なる文字は含まれて
いないので、<acronym>SGML</acronym> ないし DocBook で書かれた文書
なら、直接索引付けや検索をすることができます。</para>

    <!--
    <para>The <acronym>SGML</acronym> systems use markups to make their
    description. DocBook holds over 300 markup elements each one with several
    attributes which can assume several values, these can be fixed or defined
    by the document / style that the author has used.</para>
    -->
<para><acronym>SGML</acronym> システムでは、マークアップ(markup)を使って、文書
を記述しています。DocBook には 300 以上のマークアップ・エレメント(element)があ
り、個々のエレメントにいくつかの属性があり、属性がいくつかの値を取ります。これ
らをどう活用するかは、作者が使う文書のスタイルによって決まります。</para>

    <!--
    <para>Just to remind if any changes are made on the DocBook's definitions
    <acronym>DTD</acronym>, it's no longer DocBook.</para> 
    -->
<para>DocBook の定義ファイルである <acronym>DTD</acronym> に少しでも変更を
加えると、それはもう DocBook ではなくなることを忘れないでください。</para>

  </section>

  <section id="configurations">
    <title><!--Configuration needed -->必要な設定</title>
    <indexterm zone="configurations">
      <primary>configurations</primary>
    </indexterm>

    <!--
    <para>The identifier systems used by the SGML and by some tools
    are based on catalogues which perform the translation of these
    identifiers over to files holding the necessary definitions.</para>
    -->
<para>SGML やある種のツールなどのように識別子(identifier)を使うシステムでは、
カタログ(catalogue)がベースになっていて、そのカタログが、そうした識別子を
読み取って、必要な定義が書かれたファイルを見つけだします。</para>

    <!--
    <para>The section on tailoring a catalogue (see <xref
    linkend="making-catalogues">) will give more details about these
    files.</para> 
    -->
<para>カタログファイルの内容については、カタログの設定について書かれた
セクション (<xref linkend="making-catalogues"> 参照)で、もう少し詳しく説明
します。</para>

    <!--
    <para>For such tools to be able to find the necessary catalogue(s)
    the value of the environment variable <envar>SGML_CATALOG_FILES</envar>
    should be configured, as shown in the following example:</para> 
    -->
<para>そうしたツールが必要なカタログを見つけられるように、環境変数 <envar>
SGML_CATALOG_FILES</envar> の値を、次のように設定しなければなりません。</para>

    <informalexample id="var-sgml-catalog-files">
      <para>
      <screen><prompt>$</prompt> <command>export</command> <envar>SGML_CATALOG_FILES="/usr/lib/sgml/catalog"</envar></screen></para>
    </informalexample>

    <indexterm zone="var-sgml-catalog-files">
      <primary>configurations</primary>
      <secondary>variables</secondary>
      <tertiary>SGML_CATALOG_FILES</tertiary>
    </indexterm>

    <!--
    <para>This is the only necessary additional configuration for the DocBook,
    tools and the like to work correctly on your platform.</para>
    -->
<para>DocBook やその他のツール類をコンピュータ上で正しく動かすのに必要な
追加設定は、これだけです。</para>

  </section>

  <section id="making-catalogues">
    <title><!--Creating and modifying catalogues-->カタログの作成と修正</title>

    <indexterm zone="making-catalogues">
      <primary>catalogues</primary>
      <secondary>creating</secondary>
    </indexterm>

    <indexterm zone="making-catalogues">
      <primary>catalogue</primary>
      <secondary>modifying</secondary>
    </indexterm>

    <!--
    <para>A catalogue is a text file containing the translation rules of the
    public identifier to system's files.</para>
    -->
<para>カタログ(catalogue)は、公開識別子(public identifier)を解釈してシステム
ファイルを見つけだす際のルールが記述されたテキストファイルです。</para>

    <!--
    <para>They make easy to use the DocBook, for they allow each user to have
    their files installed in a different place (e.g. your home directory, 
    <filename class="directory">/usr/local/sgml</filename> or in any other
    place) though no other change on the document is necessary to be processed
    and <quote>compiled</quote>.</para>
    -->
<para>カタログファイルは、DocBook は使いやすくするためのものです。
個々のユーザは、カタログファイルを(たとえば、ホームディレクトリ、<filename 
class="directory">/usr/local/sgml</filename>、その他の)どこにインストールして
もいいですし、インストールさえすれば、それ以上処理したりコンパイルしたりする
必要もありません。</para>

    <example id="example-catalogue">
      <title><!--Example of catalogue-->カタログの例</title>
      <programlistingco>
        <areaspec>
          <area coords="1" id="ex.catalogue.comment">
          <area coords="5" id="ex.catalogue.definition">
          <area coords="13" id="ex.catalogue.eof">
        </areaspec>
        <programlisting>
-- Catalogue for the Conectiva Styles -- 

OVERRIDE YES
 
PUBLIC "-//Conectiva SA//DTD DocBook Conectiva variant V1.0//EN" 
       "/home/ldp/styles/books.dtd" 

DELEGATE "-//OASIS" 
         "/home/ldp/SGML/dtds/catalog.dtd"

DOCTYPE BOOK /home/ldp/SGML/dtds/docbook/db31/docbook.dtd
 
-- EOF -- 
        </programlisting>
        <calloutlist>
          <callout arearefs="ex.catalogue.comment">
            <!--
            <para> Comment. Comments start with <quote>==</quote> and
            follow to the end of the line. </para> (==はエラー回避のため)
            -->
<para>コメント。コメントは、<quote>--</quote> で始まり、改行で終わります。
</para>
          </callout>
          <callout arearefs="ex.catalogue.definition">
            <!--
            <para> The public type association 
            <parameter class="option">"-//Conectiva SA//DTD books V1.0//EN"
            </parameter>
            with the file <filename>books.dtd</filename> on the directory 
            <filename
            class="directory">/home/ldp/styles</filename>. </para> 
            -->
<para>公開型宣言(public type declaration) <parameter class="option">
"-//Connectiva SA//DTD books V1.0//EN"</parameter> と <filename 
class="directory">/home/ldp/styles</filename> にある <filename>books.dtd
</filename> ファイル。</para>

          </callout>
          <callout arearefs="ex.catalogue.eof">
            <!--
            <para> Comment informing the end of the file.</para>
            -->
<para>ファイルの終了を示すコメント。</para>
          </callout>
        </calloutlist>
      </programlistingco>
      <indexterm zone="example-catalogue">
        <primary>catalogue</primary>
        <secondary>creating</secondary>
        <tertiary>example</tertiary>
      </indexterm>
      <indexterm zone="example-catalogue">
        <primary>catalogue</primary>
        <secondary>modifying</secondary>
        <tertiary>sample</tertiary>
      </indexterm>
    </example>

    <!--
    <para>As in the example above, to associate an identifier to a file just 
    follow the sequence shown:</para>
    -->
<para>上記の例では、識別子をファイルに対応させるために、次のような順序に
従っています。</para>

    <orderedlist>
      <listitem>
        <para><!--Copy the identifier <emphasis>PUBLIC</emphasis>-->
              識別子 <emphasis>PUBLIC</emphasis> をコピーする。</para>
      </listitem>
      <listitem>
        <para><!--Type the identifying text-->
              識別するテキストを書き込む。 </para>
      </listitem>
      <listitem>
        <para><!--Indicate the path to the associated file-->
               対応するファイルへのパスを示す。</para>
      </listitem>
    </orderedlist>

    <section id="catalogue-explaining-terminology">
      <title><!--Explaining the terminology system-->用語の説明 </title>

      <indexterm zone="catalogue-explaining-terminology">
        <primary>catalogue</primary>
        <secondary>creating</secondary>
        <tertiary>terminology</tertiary>
      </indexterm>
      <indexterm zone="catalogue-explaining-terminology">
        <primary>catalogue</primary>
        <secondary>modifying</secondary>
        <tertiary>terminology</tertiary>
      </indexterm>

      <para><!--Notice the identifier-->次の識別子に注目してください。</para>

      <programlisting>"-//Conectiva SA//DTD books V1.0//EN"</programlisting>

      <!--
      <para>Its formation is not random and follows some pre-defined
      conditions.</para>
      -->
<para>この並び方は、ランダムではなく、あらかじめ決められた規則に従っています。
</para>

      <!--
      <para>The token <quote>-</quote> indicates that the used identfier 
      isn't a registered type. Only a few identifiers are registered and 
      those usualy belong to entities like <acronym>ISO</acronym>, 
      <acronym>IEEE</acronym>, and others.</para>
      -->
<para><quote> - </quote> という語句は、使用される識別子が、登録済みのタイプでは
ないことを示しています。登録済み識別子はわずかしかなく、それらは通常、
<acronym>ISO</acronym> や <acronym>IEEE</acronym> といったエンティティ
(entity)に属しています。</para>

      <!--
      <para>The second part of the identfier defines the name of the 
      organization that created it. On the example above, &conectiva; S.A.
      </para>
      -->
<para>識別子の次の部分では、それを作成した組織名が定義されます。
上記の例では、&conectiva; S.A. です。</para>

      <!--
      <para>The one before the last defines the contents (in this case a 
      <acronym>DTD</acronym><footnote>
          <para>Here are valid: <acronym>DTD</acronym>, DOCUMENT, ELEMENTS,
      ENTITIES and NONSGML.</para> </footnote>) and the name of the identified
      text.</para>
      -->
<para>最後からひとつ手前に部分では、コンテント(content)
(本書の場合は、<acronym>DTD</acronym> 
<footnote><para>有効コンテントは、<acronym>DTD</acronym>, DOCUMENT, 
ELEMENTS, ENTITIES, NONSGML です。</para></footnote> です。)
と、識別されているテキスト名が定義されます。</para>

      <!--
      <para>The last element indicates the language in which the document was
      written. Since DocBook is a DTD written in English, the language is
      <literal>EN</literal>. The two letter code recommended is the 
      <acronym>ISO</acronym> identification of the language.</para>
      -->
<para>最後のエレメントは、文書を記述した言語を示しています。DocBook は、
英語で書かれた DTD なので、言語は <literal>EN</literal> となります。
2 文字のコードが推奨されているのは、<acronym>ISO</acronym> の言語識別基準
に従っているからです。</para>

      <!--
      <para>More information can be obtained at <ulink
      url="http://www.oasis-open.org/html/a401.htm">OASIS Technical Resolution
      9401:1997 (Amendment 2 to TR 9401)</ulink>.</para> 
      -->
<para>詳しくは、<ulink
      url="http://www.oasis-open.org/html/a401.htm">OASIS Technical Resolution
      9401:1997 (Amendment 2 to TR 9401)</ulink> をご覧ください。</para>
    </section>

    <section id="making-catalogues-commands">
      <title><!--Useful command for catalogues-->
             カタログ上での便利なコマンド</title>
      <!--
      <para>The most common commands to be used on catalogues are:</para>
      -->
<para>カタログ上で使われるコマンドのうち、代表的なものを以下で説明します。
</para>

      <variablelist>
        <varlistentry>
          <term><literal>PUBLIC</literal></term>
          <listitem>
            <!--
            <para>The keyword <literal>PUBLIC</literal> maps
            public identifiers for identifiers on the system.</para>
            -->
<para>キーワード <literal>PUBLIC</literal> は、公開識別子(public identifier)
をシステム上の識別子にマップします。</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><literal>SYSTEM</literal></term>
          <listitem>
            <!--
            <para>The keyword<literal>SYSTEM</literal> maps
            system identifiers for files on the system.</para>
            -->
<para>キーワード <literal>SYSTEM</literal> は、システム識別子(system 
identifier)をシステム上のファイルにマップします。</para>
            <informalexample>
              <para>
             SYSTEM "http://nexus.conectiva/utilidades/publicacoes/livros.dtd" 
              "publicacoes/livros.dtd"</para>
            </informalexample>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><literal>SGMLDECL</literal></term>
          <listitem>
            <!--
            <para>The keyword <literal>SGMLDECL</literal> designates the
            system identifier of the SGML statement that should be used.
            </para>
            -->
<para>キーワード <literal>SGMLDECL</literal> は、使用されるべき SGML 文言
(SGML statement)のシステム識別子を指示します。</para>
            <informalexample>
              <para>
SGMLDECL "publishings/books.dcl"</para>
            </informalexample>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><literal>DTDDECL</literal></term>
          <listitem>
            <!--
            <para>Similar to the <literal>SGMLDECL</literal> the
            keyword <literal>DTDDECL</literal> identifies the SGML statement
            that should be used. <literal>DTDDECL</literal> makes the 
            association of the statement with a public identifier to a
            <acronym>DTD</acronym>. Unfortunately this association isn't 
            supported by the charge free tools available. The benefits of this
            statement can be achieved somehow with multiple catalogue files.
            </para>
            -->
<para><literal>SGMLDECL</literal> と同様、キーワード <literal>DTDDECL
</literal> は、使用されるべき SGML 文言を指示します。<literal>DTDDECL
</literal> によって、SGML 文言は、<acronym>DTD</acronym> に対する公開識別子に
対応付けられます。残念ながら、この対応付けは、無料で入手できる既存のツール
ではサポートされていません。この文言は、複数のカタログファイルを使うときに
効果があります。
</para>
            <informalexample>
              <para>
DTDDECL "-//Conectiva SA//DTD livros V1.0//EN" "publicacoes/livros.dcl"</para>
            </informalexample>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><literal>CATALOG</literal></term>
          <listitem>
            <!--
            <para>The keyword <literal>CATALOG</literal> allows a catalogue
            to be included inside another. This is a way to make use of several
            different catalogues without the need to alter them.
            </para>
            -->
<para>キーワード <literal>CATALOG</literal> を使うと、あるカタログファイルを
別のカタログファイル内に含めることができます。それによって、カタログファイル
そのものを変更せずに、異なる複数のカタログを利用できるようになります。
</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><literal>OVERRIDE</literal></term>
          <listitem>
            <!--
            <para>The keyword <literal>OVERRIDE</literal> informs whether an 
            identifier has priority over a system identifier.
            The standard on most systems is that the system identifier
            has priority over the public one.</para>
            -->
<para>キーワード <literal>OVERRIDE</literal> は、公開識別子がシステム識別子
に優先するかどうかを指示できます。大部分のシステムでの標準は、システム識別子
が公開識別子に優先しています。</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><literal>DELEGATE</literal></term>
          <listitem>
            <!--
            <para>The keyword <literal>DELEGATE</literal> allows the 
            association of a catalogue to a specific type of public identifier.
            The clause <literal>DELEGATE</literal> is very similar to the
            <literal>CATALOG</literal>, except by the fact that it doesn't do
            anything until a specific pattern is specified.</para>
            -->
<para>キーワード <literal>DELEGATE</literal> を使うと、あるカタログを特定
タイプの公開識別子に対応付けることができます。<literal>DELEGATE</literal> 
コマンドは、<literal>CATALOG</literal> と非常に似ていますが、特定のパターンが
指定されない限り何もしない点で異なっています。</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><literal>DOCTYPE</literal></term>
          <listitem>
            <!--
            <para>In case of a document starts with a type of document, but
            has no public identifier and no system identifier the clause 
            <literal>DOCTYPE</literal> makes the association of this document
            with an specific DTD.</para>
            -->
<para>文書型が最初に書かれていても、公開識別子やシステム識別子が書かれて
いない場合、<literal>DOCTYPE</literal> コマンドが、その文書を特定の DTD に
対応付けます。</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>

  </section>

  <section id="writing-docbook">
    <title><!--Writing with DocBook elements-->
            DocBook エレメントの使い方</title>

    <indexterm zone="writing-docbook">
      <primary>edition</primary>
      <secondary>using DocBook</secondary>
    </indexterm>

    <!--
    <para>An editor capable of inserting an element according with
    <acronym>DTD</acronym> analisys helps a lot since it can allow or
    not the element to be used at the position where the cursor is
    in. This way you can be sure that no invalid element was added
    anywhere in your document.</para>
    -->
<para><acronym>DTD</acronym> を解析して、それに基づいてエレメントを挿入する
機能の付いたエディタを利用すると、カーソル位置で特定のエレメントを使えるか
どうかが分かるのでかなり便利です。これなら、文書のどこにも無効なエレメントを
入れることがなくなります。</para>

    <!--
    <para>In order to ensure future changes are as easy as possible,
    authors should try to keep as much compatibility as possible with
    the<acronym>XML</acronym> version of the DocBook DTD.  This means
    keeping element names in upper case, using double quotes in all
    attributes, not using <quote>markup minimizations</quote>
    (explained below), and not omitting end tags. Most tools that
    automatically insert elements (like psgml+emacs) follow these
    rules automatically or with some fine tuning.</para> 
    -->
<para>将来変更があってもなるべく簡単に移行できるように、文書の作成者は、
DocBook DTD の <acronym>XML</acronym> バージョンとの互換性をできるだけ
保つように心がけたほうがいいでしょう。つまり、エレメント名には大文字を
使い、属性内ではダブルクオートでくくり、<quote>短縮タグ</quote>(下記参照)は
使わないようにして、終了タグも省略しないようにしましょう。(psgml + emacs
のような)自動でタグを挿入するツールの大部分は、こうしたルールに自動的に
従っているか、ちょっと設定するだけで従います。</para>

    <!--
    <para id="markup-minimization">There are several forms of markup 
    minimization. These include empty tags.  One example of tag
    minimization is that instead of
    typing the end tag you simply type <sgmltag
    class="endtag"></sgmltag>. Another example, as said before, is
    ommiting tags. You can see both examples below:</para>
    -->
<para id="markup-minimization">タグの最小化(minimization)にはいくつかのやり方
があります。
空タグ(empty tag)もそれにあたります。タグの最小化の例としては、終了タグを入れ
るかわりに、<sgmltag class="endtag"></sgmltag> とだけ打つことです。以前にも述
べましたが、他にも、タグの省略(tag omission)というのがあります。次にその両方の
例を挙げます。</para>

    <informalexample>
      <programlisting format="linespecific">
<!--
<sgmltag class="starttag">para</sgmltag>I'm using <sgmltag class="starttag">
emphasis</sgmltag>here<sgmltag class="endtag"></sgmltag>, normal text here, 
and <sgmltag class="starttag"></sgmltag>here<sgmltag class="endtag"></sgmltag>
I emphasized the text again, with empty tags.<sgmltag class="endtag">para
</sgmltag>
-->

<sgmltag class="starttag">para</sgmltag>強調タグを例にとると、まず、<sgmltag class="starttag">emphasis</sgmltag>ここ<sgmltag class="endtag"></sgmltag>では終了タグが省略され、
さらに、<sgmltag class="starttag"></sgmltag>ここ<sgmltag class="endtag"></sgmltag>では空タグも使われています。<sgmltag class="endtag">para</sgmltag>

</programlisting>
    </informalexample>

    <!--
    <para>Each type of document created has a specific structure and example of
    documents can found afterwards on this document. (see
    <xref linkend="examples-documents">).</para>
    -->
<para>個々の文書型には特定の構造があるので、そうした文書の例はのちほど紹介
します。(<xref linkend="examples-documents">参照)</para>

    <!--
    <para>Considering the explanation above we can proceed to instructions on 
    how to write a document using DocBook.</para>
    -->
<para>上記の説明を考慮した上で、次に DocBook を使って文書を書く方法を説明して
いきます。</para>

    <section id="writing-docbook-commands">
      <title><!--Useful commands-->便利なコマンド</title>

      <indexterm>
        <primary>edition</primary>
        <secondary>using DocBook</secondary>
        <tertiary>commands</tertiary>
      </indexterm>

      <!--
      <para>The <xref linkend="table-useful-commands"> shows some commands 
      which 
      are useful to generate generic documents. Remember that some elements are
      valide only on some contexts.</para>
      -->
<para><xref linkend="table-useful-commands">では、一般的な文書を作成する
際に便利なコマンドを一覧表示しています。ただ、いくつかのエレメントは、
特定の文脈でのみ有効であることを忘れないでください。</para>

<para>(訳注: 下記 <xref 
linkend="table-useful-commands"> では、<sgmltag class="starttag">to</sgmltag>
<sgmltag class="endtag">to</sgmltag> と書かれた部分がありましたが、そのまま使うとエラーに
なり紛らわしいので、<sgmltag class="starttag">para</sgmltag><sgmltag class="endtag">
para</sgmltag> に修正しています。)</para>

      <tip>
        <!--
        <para>Sometimes the appearance of a particular tag changes
        from one format to another. As a beginner in DocBook writing,
        you may wish to see how your document looks in several formats
        before you publish them.</para>
        -->
<para>変換するフォーマットが変わると、特定のタグでの表示結果も変わることが
ときどきあります。DocBook で初めて文書を作成する場合は、公開前に、いくつかの
フォーマットで作成した文書がどういう体裁になるのかを確認したほうがよいで
しょう。</para>
      </tip>

      <note>
        <!--
        <para>Since the formatting depends on the output style chosen, it's
        recommended to use as much markup as possible. Even if the appearance
        of the output doesn't seem to change with the standard output
        style, there may be specific output formats that will make
        these tags stand out.</para>
        -->
<para>変換結果は、変換の際に使ったスタイルシートに依存するので、マークアップ
はできるだけたくさん使うことをお薦めします。標準のスタイルシートでは
出力結果にあまり違いが見えないときでも、そうしたタグを目立たせる特定の
出力フォーマットがあるかもしれないからです。</para>
      </note>

      <table id="table-useful-commands">
        <title><!--Useful commands-->便利なコマンド</title>
        <tgroup cols="3">
          <thead>
            <row>
              <entry><!--Description-->用途</entry>
              <entry><!--Command-->コマンド</entry>
              <entry><!--Result-->出力結果</entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry><!--E-mail address-->メールアドレス</entry>
              <entry><sgmltag class="starttag">email</sgmltag>
              address@domain<sgmltag
              class="endtag">email</sgmltag></entry>
              <entry><email>address@domain</email></entry>
            </row>
            <row>
              <entry><!--About the author-->著者について</entry>
              <entry><sgmltag class="starttag">author</sgmltag>...<sgmltag
              class="endtag">author</sgmltag></entry>
              <entry>(<!--see example below-->下記の例を参照)</entry>
            </row>
            <row>
              <entry><!--Author's name-->著者名</entry>
              <entry><programlisting>
<sgmltag class="starttag">firstname</sgmltag>First_Name<sgmltag class="endtag">firstname</sgmltag>
<sgmltag class="starttag">othername</sgmltag>Middle_Name<sgmltag class="endtag">othername</sgmltag>
<sgmltag class="starttag">surname</sgmltag>Surname<sgmltag class="endtag">surname</sgmltag>
              </programlisting></entry> 
              <entry><author>
                  <firstname>First Name</firstname>
                  <othername>Middle Name</othername>
                  <surname>Surname</surname>
                </author></entry>
            </row>
            <row>
              <entry><!--Keys' name (printings on the keyboard)-->
               キー名(キーボード上の表記)</entry>
              <entry><sgmltag class="starttag">keycap</sgmltag>F1<sgmltag
              class="endtag">keycap</sgmltag></entry>
              <entry><keycap>F1</keycap></entry>
            </row>
            <row>
              <entry><!--Symbol represented by the keys-->
               キーのシンボル名</entry>
              <entry><sgmltag class="starttag">keysym</sgmltag>KEY_F1<sgmltag
              class="endtag">keysym</sgmltag></entry>
              <entry><keysym>KEY_F1</keysym></entry>
            </row>
            <row>
              <entry><!--Key's code-->キーのコード</entry>
              <entry><sgmltag class="starttag">keycode</sgmltag>0x3B<sgmltag
              class="endtag">keycode</sgmltag></entry>
              <entry><keycode>0x3B</keycode></entry>
            </row>
            <row>
              <entry><!--Combinations or sequences of keys-->キー入力</entry>
              <entry><programlisting>
<sgmltag class="starttag">keycombo</sgmltag>
   <sgmltag class="starttag">keycap</sgmltag>Ctrl<sgmltag class="endtag">keycap</sgmltag>
   <sgmltag class="starttag">keycap</sgmltag>S<sgmltag class="endtag">keycap</sgmltag>
<sgmltag class="endtag">keycombo</sgmltag>
              </programlisting></entry> 
              <entry><keycombo>
                  <keycap>Ctrl</keycap>
                  <keycap>S</keycap>
                </keycombo></entry>
            </row>
            <row>
              <entry><!--Programs Menu-->プログラムメニュー</entry>
              <entry><sgmltag class="starttag">guimenu</sgmltag><!--File-->
              ファイル<sgmltag
              class="endtag">guimenu</sgmltag></entry>
              <entry><guimenu><!--File-->ファイル</guimenu></entry>
            </row>
            <row>
              <entry><!--Menu Items-->メニューアイテム</entry>
              <entry><sgmltag
              class="starttag">guimenuitem</sgmltag><!--Save-->保存<sgmltag
              class="endtag">guimenuitem</sgmltag></entry> 
              <entry><guimenuitem><!--Save-->保存</guimenuitem></entry>
            </row>
            <row>
              <entry><!--Menu Sequences-->メニュー選択</entry>
              <entry><programlisting>
<sgmltag class="starttag">menuchoice</sgmltag>
   <sgmltag class="starttag">shortcut</sgmltag>
      <sgmltag class="starttag">keycombo</sgmltag>
         <sgmltag class="starttag">keycap</sgmltag>Ctrl<sgmltag class="endtag">keycap</sgmltag>
         <sgmltag class="starttag">keycap</sgmltag>S<sgmltag class="endtag">keycap</sgmltag>
      <sgmltag class="endtag">keycombo</sgmltag>
   <sgmltag class="endtag">shortcut</sgmltag>
   <sgmltag class="starttag">guimenu</sgmltag><!--File-->ファイル<sgmltag class="endtag">guimenu</sgmltag>
   <sgmltag class="starttag">guimenuitem</sgmltag><!--Save-->保存<sgmltag class="endtag">guimenuitem</sgmltag>
<sgmltag class="endtag">menuchoice</sgmltag>
              </programlisting></entry>
              <entry><menuchoice>
                  <shortcut>
                    <keycombo>
                      <keycap>Ctrl</keycap>
                      <keycap>S</keycap>
                    </keycombo>
                  </shortcut>
                  <guimenu><!--File-->ファイル</guimenu>
                  <guimenuitem><!--Save-->保存</guimenuitem>
                </menuchoice></entry>
            </row>
            <row>
              <entry><!--Mouse Button-->マウスボタン</entry>
              <entry><sgmltag
              class="starttag">mousebutton</sgmltag>left<sgmltag
              class="endtag">mousebutton</sgmltag></entry> 
              <entry><mousebutton>left</mousebutton></entry>
            </row>
            <row>
              <entry><!--Command Names-->コマンド名</entry>
              <entry><sgmltag class="starttag">command</sgmltag>comando<sgmltag
              class="endtag">command</sgmltag></entry>
              <entry><command>command</command></entry>
            </row>
            <row>
              <entry><!--Application Names-->アプリケーション名</entry>
              <entry><sgmltag
              class="starttag">application</sgmltag>application<sgmltag
              class="endtag">application</sgmltag></entry> 
              <entry><application>application</application></entry>
            </row>
            <row>
              <entry><!--Text Bibliographical Reference-->
                     参考文献表示</entry>
              <entry><sgmltag
              class="starttag">citation</sgmltag>reference<sgmltag
              class="endtag">citation</sgmltag></entry> 
              <entry><citation>reference</citation></entry>
            </row>
            <row>
              <entry><!--Quote-->引用</entry>
              <entry><programlisting>
<sgmltag class="starttag">blockquote</sgmltag>
   <sgmltag class="starttag">attribution</sgmltag><!--Text Author-->著者名<sgmltag class="endtag">attribution</sgmltag>
   <sgmltag class="starttag">para</sgmltag><!--Quote Text.-->引用文<sgmltag class="endtag">para</sgmltag>
<sgmltag class="endtag">blockquote</sgmltag>
              </programlisting></entry>
              <entry><para><blockquote>
                    <attribution><!--Text Author-->著者名</attribution>
                    <para><!--Quote Text.-->引用文</para>
                  </blockquote></para></entry>
            </row>
            <row>
              <entry><!--Index-->索引</entry>
              <entry><!--(NA)-->右記参照</entry>
              <entry><!--See--> <xref linkend="encoding-index">参照</entry>
            </row>
            <row>
              <entry><!--File Names-->ファイル名</entry>
              <entry><programlisting>
<sgmltag class="starttag">filename</sgmltag>file<sgmltag class="endtag">filename</sgmltag></programlisting></entry>
              <entry><filename>file</filename></entry>
            </row>
            <row>
              <entry><!--Directories-->ディレクトリ</entry>
              <entry><programlisting>
<sgmltag class="starttag">filename id="directory"</sgmltag>directory<sgmltag class="endtag">filename</sgmltag></programlisting></entry>
              <entry><filename class="directory">directory/</filename></entry>
            </row>
            <row>
              <entry><!--Emphasize Text-->強調<footnote>
                  <!--
                  <para>The text can be enphasized in a few ways. The most 
                  common ways are italics and bold. DocBook, however, supports
                  only
                  italics. The use of bold requires additional settings on the 
                  stylesheet used.</para>
                  -->
<para>強調表示にはいつくかの方法があります。斜体の太字が最も一般的ですが、
DocBook では斜体しかサポートしていません。太字を使うには、利用している
スタイルシートに設定を追加する必要があります。</para>
                </footnote>
</entry>
              <entry><programlisting>
<sgmltag class="starttag">emphasis</sgmltag>text<sgmltag class="endtag">emphasis</sgmltag></programlisting></entry>
              <entry><emphasis>text</emphasis></entry>
            </row>
            <row>
              <entry><!--Footnotes-->脚注</entry>
              <entry><programlisting>
<sgmltag class="starttag">footnote</sgmltag>
   <sgmltag class="starttag">to</sgmltag><!--Footnote text-->脚注文<sgmltag class="endtag">to</sgmltag>
<sgmltag class="endtag">footnote</sgmltag></programlisting></entry>
              <entry><!--(See note at the end of this table)-->
               (この表組に最後を参照)</entry>
            </row>
            <row>
              <entry><!--URLs-->URL</entry>
              <entry><programlisting>
<sgmltag class="starttag">ulink url="http://www.conectiva.com</sgmltag>Conectiva S.A.<sgmltag class="endtag"></sgmltag></programlisting></entry> 
              <entry><ulink url="http://www.conectiva.com">Conectiva S.A.</ulink></entry>
            </row>
            <row>
              <entry><!--Markups List-->マーク付き箇条書き</entry>
              <entry><programlisting>
<sgmltag class="starttag">itemizedlist</sgmltag>
   <sgmltag class="starttag">listitem</sgmltag>
      <sgmltag class="starttag"><!--to-->para</sgmltag><!--item-->アイテム<sgmltag class="endtag"><!--to-->para</sgmltag>
   <sgmltag class="endtag">listitem</sgmltag>
   <sgmltag class="starttag">listitem</sgmltag>
      <sgmltag class="starttag"><!--to-->para</sgmltag><!--item-->アイテム<sgmltag class="endtag"><!--to-->para</sgmltag>
   <sgmltag class="endtag">listitem</sgmltag>
<sgmltag class="endtag">itemizedlist</sgmltag>
</programlisting></entry>
              <entry><itemizedlist>
                  <listitem>
                    <para><!--item-->アイテム</para>
                  </listitem>
                  <listitem>
                    <para><!--item-->アイテム</para>
                  </listitem>
                </itemizedlist></entry>
            </row>
            <row>
              <entry><!--Numbered List-->番号付き箇条書き</entry>
              <entry><programlisting>
<sgmltag class="starttag">orderedlist</sgmltag>
   <sgmltag class="starttag">listitem</sgmltag>
      <sgmltag class="starttag"><!--to-->para</sgmltag><!--item-->アイテム<sgmltag class="endtag"><!--to-->para</sgmltag>
   <sgmltag class="endtag">listitem</sgmltag>
   <sgmltag class="starttag">listitem</sgmltag>
      <sgmltag class="starttag"><!--to-->para</sgmltag><!--item-->アイテム<sgmltag class="endtag"><!--to-->para</sgmltag>
   <sgmltag class="endtag">listitem</sgmltag>
<sgmltag class="endtag">orderedlist</sgmltag>
</programlisting></entry>
              <entry><orderedlist>
                  <listitem>
                    <para><!--item-->アイテム</para>
                  </listitem>
                  <listitem>
                    <para><!--item-->アイテム</para>
                  </listitem>
                </orderedlist></entry>
            </row>
            <row>
              <entry><!--Segmented List-->書き分けた箇条書き</entry>
              <entry><programlisting>
<sgmltag class="starttag">segmentedlist</sgmltag>
   <sgmltag class="starttag">title</sgmltag><!--Binary to decimal conversion-->2 進数から 10 進数への変換表<sgmltag class="endtag">title</sgmltag>
   <sgmltag class="starttag">segtitle</sgmltag><!--Binary--> 2 進数<sgmltag class="endtag">segtitle</sgmltag>
   <sgmltag class="starttag">segtitle</sgmltag><!--Decimal-->10 進数<sgmltag class="endtag">segtitle</sgmltag>
   <sgmltag class="endtag">seglistitem</sgmltag><sgmltag class="starttag">seg</sgmltag>00<sgmltag class="endtag">seg</sgmltag><sgmltag class="starttag">seg</sgmltag>0<sgmltag class="endtag">seg</sgmltag>
   <sgmltag class="endtag">seglistitem</sgmltag>
   <sgmltag class="starttag">seglistitem</sgmltag><sgmltag class="starttag">seg</sgmltag>01<sgmltag class="endtag">seg</sgmltag><sgmltag class="starttag">seg</sgmltag>1<sgmltag class="endtag">seg</sgmltag>
   <sgmltag class="endtag">seglistitem</sgmltag>
   <sgmltag class="starttag">seglistitem</sgmltag><sgmltag class="starttag">seg</sgmltag>10<sgmltag class="endtag">seg</sgmltag><sgmltag class="starttag">seg</sgmltag>2<sgmltag class="endtag">seg</sgmltag>
<sgmltag class="endtag">segmentedlist</sgmltag>
</programlisting></entry>
              <entry><segmentedlist>
                  <title><!--Binary to Decimal Conversion-->2 進数から 10 進数への変換表</title>
                  <segtitle><!--Binary-->&nbsp;2 進数</segtitle>
                  <segtitle><!--Decimal-->10 進数</segtitle>
                  <seglistitem>
                    <seg>00</seg>
                    <seg>0</seg>
                  </seglistitem>
                  <seglistitem>
                    <seg>01</seg>
                    <seg>1</seg>
                  </seglistitem>
                  <seglistitem>
                    <seg>10</seg>
                    <seg>2</seg>
                  </seglistitem>
                </segmentedlist></entry>
            </row>
            <row>
              <entry><!--Variable List-->見出し付き箇条書き</entry>
              <entry><programlisting>
<sgmltag class="starttag">variablelist</sgmltag>
   <sgmltag class="starttag">varlistentry</sgmltag>
      <sgmltag class="starttag">term</sgmltag><!--Entry 1-->見出し 1<sgmltag class="endtag">term</sgmltag>
      <sgmltag class="starttag">listitem</sgmltag>
         <sgmltag class="starttag"><!--to-->para</sgmltag><!--Description-->説明<sgmltag class="endtag"><!--to-->para</sgmltag>
      <sgmltag class="endtag">listitem</sgmltag>
   <sgmltag class="endtag">varlistentry</sgmltag>
   <sgmltag class="starttag">varlistentry</sgmltag>
      <sgmltag class="starttag">term</sgmltag><!--Entry 2-->見出し 2<sgmltag class="endtag">term</sgmltag>
      <sgmltag class="starttag">listitem</sgmltag>
         <sgmltag class="starttag"><!--to-->para</sgmltag><!--Description-->説明<sgmltag class="endtag"><!--to-->para</sgmltag>
      <sgmltag class="endtag">listitem</sgmltag>
   <sgmltag class="endtag">varlistentry</sgmltag>
<sgmltag class="endtag">variablelist</sgmltag>
</programlisting></entry>
              <entry><variablelist>
                  <varlistentry>
                    <term><!--Entry 1-->見出し 1</term>
                    <listitem>
                      <para><!--Description-->説明</para>
                    </listitem>
                  </varlistentry>
                  <varlistentry>
                    <term><!--Entry 2-->見出し 2</term>
                    <listitem>
                      <para><!--Description-->説明</para>
                    </listitem>
                  </varlistentry>
                </variablelist></entry>
            </row>
            <row>
              <entry><!--Simple Lists-->シンプルな箇条書き</entry>
              <entry><programlisting>
<sgmltag class="starttag">simplelist type="horiz" columns="3"</sgmltag>
   <sgmltag class="starttag">member</sgmltag>1<sgmltag class="endtag">member</sgmltag>
   <sgmltag class="starttag">member</sgmltag>2<sgmltag class="endtag">member</sgmltag>
   <sgmltag class="starttag">member</sgmltag>3<sgmltag class="endtag">member</sgmltag>
   <sgmltag class="starttag">member</sgmltag>4<sgmltag class="endtag">member</sgmltag>
   <sgmltag class="starttag">member</sgmltag>5<sgmltag class="endtag">member</sgmltag>
   <sgmltag class="starttag">member</sgmltag>6<sgmltag class="endtag">member</sgmltag>
<sgmltag class="endtag">simplelist</sgmltag>
<sgmltag class="starttag">simplelist type="inline"</sgmltag>
   <sgmltag class="starttag">member</sgmltag>A<sgmltag class="endtag">member</sgmltag>
   <sgmltag class="starttag">member</sgmltag>B<sgmltag class="endtag">member</sgmltag>
   <sgmltag class="starttag">member</sgmltag>C<sgmltag class="endtag">member</sgmltag>
   <sgmltag class="starttag">member</sgmltag>D<sgmltag class="endtag">member</sgmltag>
   <sgmltag class="starttag">member</sgmltag>E<sgmltag class="endtag">member</sgmltag>
   <sgmltag class="starttag">member</sgmltag>F<sgmltag class="endtag">member</sgmltag>
<sgmltag class="endtag">simplelist</sgmltag>
</programlisting></entry>
              <entry><simplelist columns="3" type="horiz">
                  <member>1</member>
                  <member>2</member>
                  <member>3</member>
                  <member>4</member>
                  <member>5</member>
                  <member>6</member>
                </simplelist><simplelist type="inline">
                  <member>A</member>
                  <member>B</member>
                  <member>C</member>
                  <member>D</member>
                  <member>E</member>
                  <member>F</member>
                </simplelist></entry>
            </row>
            <row>
              <entry><!--Pictures-->画像</entry>
              <entry><!--(NA)-->右記参照</entry>
              <entry><!--See --><xref linkend="inserting-pictures">参照</entry>
            </row>
            <row>
              <entry><!--Table-->表組み</entry>
              <entry><!--(NA)-->右記参照</entry>
              <entry><!--See --><xref linkend="tables">参照</entry>
            </row>
            <row>
              <entry><!--Programs List-->プログラムへのコメント挿入</entry>
              <entry><!--(NA)-->右記参照</entry>
              <entry><!--See --><xref linkend="listings">参照</entry>
            </row>
            <row>
              <entry><!--Glossary-->用語集</entry>
              <entry><programlisting>
<sgmltag class="starttag">glossentry</sgmltag>
   <sgmltag class="starttag">glossterm</sgmltag>Term<sgmltag class="endtag">glossterm</sgmltag>
   <sgmltag class="starttag">glossdef</sgmltag>
      <sgmltag class="starttag"><!--to-->para</sgmltag>Definition<sgmltag class="endtag"><!--to-->para</sgmltag>
   <sgmltag class="endtag">glossdef</sgmltag>
<sgmltag class="endtag">glossentry</sgmltag></programlisting></entry>
              <entry><!--(See the glossary at the end of this document)-->
                     この文書の巻末にある用語集参照</entry>
            </row>
            <row>
              <entry><!--Crossed References-->相互参照</entry>
              <entry><programlisting>
<sgmltag class="starttag">section id="secao"</sgmltag>
...
<sgmltag class="endtag">section</sgmltag>
<sgmltag class="starttag">section id="reference the other section"</sgmltag>
...
<sgmltag class="starttag">para</sgmltag>Please, see<sgmltag class="starttag">xref linkend="secao"</sgmltag> for more information.
<sgmltag class="endtag">para</sgmltag></programlisting></entry>
              <entry><!--(NA)-->(画像等の出力結果欄参照)</entry>
            </row>
          </tbody>
        </tgroup>
      </table>

    </section>

  </section>

  <section id="encoding-index">
    <title><!--Encoding Indexes-->索引をつくる</title>

    <indexterm zone="encoding-index"> 
      <primary>edition</primary>
      <secondary>index</secondary>
    </indexterm>

    <!--
    <para>The generation of indexes depends on the markups inserted in
    the text.</para>
    -->
<para>文中にマークアップを挿入することで、索引を生成することができます。</para>

    <!--
    <para>Such markups will be processed afterwards by an external tool and 
    will generate the index. An example of such a tool is the 
    <filename>collateindex.pl</filename> script (see <xref
    linkend="tools-compile">). Details about the process used to generate
    these indexes are shown in <xref linkend="automatic-indexes">.</para>
    -->
<para>そうしたマークアップは、あとで外部ツールによって処理されて、索引を
生成します。そうしたツールの一例に、<filename>collateindex.pl
</filename> スクリプトがあります。索引を生成するための処理は、<xref 
linkend="automatic-indexes">で詳しく述べます。</para>

    <!--
    <para>The indexes have nesting levels. The markup of an index is done by 
    the code <xref
    linkend="example-code-index">.</para>
    -->
<para>索引には、入れ子レベル(nesting level)があります。索引のマークアップ
には、次のコードを使います。<xref linkend="example-code-index"></para>

    <example id="example-code-index">
      <title><!--Code for the generation of an index-->
             索引生成のためのコード</title>
      <programlisting>
<sgmltag class="starttag">indexterm</sgmltag>
   <sgmltag class="starttag">primary</sgmltag>Main level<sgmltag class="endtag">primary</sgmltag>
   <sgmltag class="starttag">secondary</sgmltag>Second level<sgmltag class="endtag">secondary</sgmltag>
   <sgmltag class="starttag">tertiary</sgmltag>Third level<sgmltag class="endtag">tertiary</sgmltag>
<sgmltag class="endtag">indexterm</sgmltag>
      </programlisting>
    </example>

    <!--
    <para>It's possible to refer to chapters, sections and other parts
    of the document using the <glossterm>attribute</glossterm> <sgmltag
    class="attribute">zone</sgmltag>.</para>
    -->
<para><glossterm>属性</glossterm> <sgmltag class="attribute">zone
</sgmltag> を使うことで、文書のチャプターやセクションおよびその他の部分
を参照することができます。</para>

    <example id="index-zone">
      <title><!--Use of the attributte <sgmltag class="attribute">
             zone</sgmltag>-->
             属性 <sgmltag class="attribute">zone</sgmltag> の使い方</title>
      <programlisting>
<sgmltag class="starttag">section id="encoding-index"</sgmltag>
    <sgmltag class="starttag">title</sgmltag>Encoding Indexes<sgmltag class="endtag">title</sgmltag>

    <sgmltag class="starttag">indexterm zone="encoding-index"</sgmltag>
      <sgmltag class="starttag">primary</sgmltag>edition<sgmltag class="endtag">primary</sgmltag>
      <sgmltag class="starttag">secondary</sgmltag>index<sgmltag class="endtag">secondary</sgmltag>
    <sgmltag class="endtag">indexterm</sgmltag>

    <sgmltag class="starttag">para</sgmltag><!--The generation of indexes depend on the inserted markups on the text. -->索引は、文中にマークアップを挿入することで生成されます。<sgmltag class="endtag">para</sgmltag>
      </programlisting>
    </example>

    <!--
    <para>The <xref linkend="index-zone"> has the code used to generate the 
    entry of this edition on the index. In fact, since the attribute 
    <sgmltag class="attribute">zone</sgmltag> is used, the index statement 
    could be located anywhere in the document or even in a separate file.
    </para> 
    -->
<para><xref linkend="index-zone"> のコードは、索引上にこの edition という
エントリーを生成するのに使われているものです。実際、属性 <sgmltag 
class="attribute">zone</sgmltag> を使えば、文書内でも、文書外の別ファイル
にでもどこにでも索引ページを置くことができます。</para>

    <!--
    <para>However, to facilitate maintenance the entries for the index were 
    all placed after the text to which it refers.
    </para> 
    -->
<para>ただ、簡単にメンテナンスができるように、索引のエントリーは、索引付けを
した文書の最後のページにいつも置かれています。</para>

    <example>
      <title><!--Usage of values <sgmltag class="attvalue">startofrange
      </sgmltag> and <sgmltag class="attvalue">endofrange</sgmltag> on the 
      attribute <sgmltag class="attribute">class</sgmltag>-->
      属性 <sgmltag class="attribute">class</sgmltag> で、値 <sgmltag 
      class="attvalue">startofrange</sgmltag> と <sgmltag class="attvalue">
      endofrange</sgmltag> を使う方法
      </title>
      <programlisting>
    <sgmltag class="starttag">PARA</sgmltag><!--Typing the text normally sometimes there's the need of-->普段、文章を打ち込んでいると、ときどき 
   <sgmltag class="starttag">INDEXTERM CLASS="startofrange" ID="example-band-index"</sgmltag>
      <sgmltag class="starttag">PRIMARY</sgmltag>examples<sgmltag class="endtag">PRIMARY</sgmltag>
      <sgmltag class="starttag">SECONDARY</sgmltag>index<sgmltag class="endtag">SECONDARY</sgmltag>
   <sgmltag class="endtag">INDEXTERM</sgmltag>
  <!-- mark large amounts of text.-->長文をごっそりマークする必要が生じることがあります。<sgmltag class="endtag">PARA</sgmltag>

   <sgmltag class="starttag">PARA</sgmltag><!--Keep inserting the paragraphs normally.-->そういう場合でも、いつも通りに書き進めましょう。<sgmltag class="endtag">PARA</sgmltag>

   <sgmltag class="starttag">PARA</sgmltag><!--Until the end of the section intended-->そして、索引付けしたい部分の最後に来たら、次のように締めくくります。<!--to be indexed.-->

   <sgmltag class="starttag">INDEXTERM STARTREF="example-band-index" CLASS="endofrange"</sgmltag>.
   <sgmltag class="endtag">PARA</sgmltag></programlisting>
    </example>

  </section>

  <section id="inserting-pictures">
    <title><!--Inserting Pictures-->画像の挿入</title>

    <indexterm zone="inserting-pictures">
      <primary>graphics</primary>
      <secondary>inserting</secondary>
      <tertiary><sgmltag class="starttag">graphic</sgmltag></tertiary>
    </indexterm>
    <indexterm zone="inserting-pictures">
      <primary>figures</primary>
      <secondary>inserting</secondary>
      <tertiary><sgmltag class="starttag">figure</sgmltag></tertiary>
    </indexterm>


    <!--
    <para>It's necessary to insert pictures for all types of media on which 
    the document will be published.</para>
    -->
<para>画像の挿入は、どういうメディアで文書を公開する場合でも必要なものです。
</para>

    <!--
    <para>If you use the TeX format you'll need the images as a
    PostScript file. For online publishing you can use any kind of
    common image file, such as <acronym>JPG</acronym>, 
    <acronym>GIF</acronym> or <acronym>PNG</acronym>.</para> 
    -->
<para>TeX フォーマットを使うなら、PostScript ファイルのイメージが必要です。
オンラインで公開するなら、<acronym>JPG</acronym> や <acronym>GIF</acronym>、
<acronym>PNG</acronym> といった一般的なイメージファイルが使えます。</para>

    <!--
    <para>The easiest way to insert pictures is the use of the attribute 
    <sgmltag class="attribute">fileref</sgmltag>. Usually pictures are 
    generated
    in <acronym>JPG</acronym> and in PostScript (PS or EPS).</para>
    -->
<para>画像を挿入する一番簡単な方法は、属性 <sgmltag class="attribute">fileref
</sgmltag> を使うことです。通常、画像は、<acronym>JPG</acronym> や PostScript 
(PS もしくは EPS) で生成されます。</para>

    <example id="ex-picture-fileref">
      <title><!--Inserting a picture-->画像の挿入</title>
      <programlisting>
<sgmltag class="starttag">figure</sgmltag>
   <sgmltag class="starttag">title</sgmltag>Picture's Title<sgmltag class="endtag">title</sgmltag>
   <sgmltag class="starttag">graphic fileref="images/file"</sgmltag><sgmltag class="endtag">graphic</sgmltag>
<sgmltag class="endtag">figure</sgmltag>
</programlisting>
    </example>

    <!--
    <para>Replacing <sgmltag class="starttag">figure</sgmltag> by
    <sgmltag class="starttag">informalfigure</sgmltag> eliminates the need to
    insert a title for the picture.</para>
    -->
<para><sgmltag class="starttag">figure</sgmltag> を <sgmltag class="starttag">
informalfigure</sgmltag> に置き換えると、画像のタイトルを入れる必要がなくなり
ます。</para>

    <!--
    <para>There's still the <sgmltag class="attribute">float</sgmltag>
    attribute on which the value <literal>0</literal> indicates that the
    picture should be placed exactly where the text flux appears. The
    value <literal>1</literal> allows the picture to be moved to a more
    convenient location (this location can be described on the style
    sheet used or even can be controlled by the application being
    used).</para> 
    -->
<para>さらに、属性 <sgmltag class="attribute">float</sgmltag> があり、
この値として <literal>0</literal> を指定すると、画像は、文の流れに沿った
正確な位置に置かれます。値として <literal>1</literal> を指定すると、
より適切と考えられるところに画像が動かされて、その位置に置かれます。
(この位置は、スタイルシートに記述されている場合があるし、もしくは使用する
アプリケーションによって管理されている場合もあります。)</para>

    <section id="inserting-figures-mediaobject">
      <title><!--Alternative Methods-->上記以外の方法</title>

      <indexterm zone="inserting-figures-mediaobject">
        <primary>graphics</primary>
        <secondary>inserting</secondary>
        <tertiary><sgmltag class="starttag">mediaobject</sgmltag></tertiary>
      </indexterm>
      <indexterm zone="inserting-figures-mediaobject">
        <primary>figures</primary>
        <secondary>inserting</secondary>
        <tertiary><sgmltag class="starttag">mediaobject</sgmltag></tertiary>
      </indexterm>

      <!--
      <para>The first alternative to <xref linkend="ex-picture-fileref"> is
      the elimination of elements <sgmltag class="starttag">figure</sgmltag> or
      <sgmltag class="starttag">informalfigure</sgmltag>.</para>
      -->
<para><xref linkend="ex-picture-fileref"> 以外の方法として、<sgmltag 
class="starttag">figure</sgmltag> や <sgmltag class="starttag">
informalfigure</sgmltag> を使わない方法もあります。</para>

      <!--
      <para>Another interesting alternative when it's the decision to publish 
      the text on media and pictures aren't accepted, is the use of a
      wrapper <sgmltag class="starttag">imageobject</sgmltag>.</para>
      -->
<para>他にも、画像が使えないメディアで公開しようとする場合、興味深い代替
措置として、<sgmltag class="starttag">imageobject</sgmltag> ラッパーを
使う方法があります。</para>

      <example id="former-figure-imageobject">
        <title><!--Using--> 
        <sgmltag class="starttag">imageobject</sgmltag>の使い方</title>
        <programlisting>
<sgmltag class="starttag">figure</sgmltag>
   <sgmltag class="starttag">title</sgmltag>Title<sgmltag class="endtag">title</sgmltag>
   <sgmltag class="starttag">mediaobject</sgmltag>
      <sgmltag class="starttag">imageobject</sgmltag>
         <sgmltag class="starttag">imagedata fileref="images/file.eps" format="eps"</sgmltag>
      <sgmltag class="endtag">imageobject</sgmltag>
      <sgmltag class="starttag">imageobject</sgmltag>
         <sgmltag class="starttag">imagedata fileref="images/file.jpg" format="jpg"</sgmltag>
      <sgmltag class="endtag">imageobject</sgmltag>
      <sgmltag class="starttag">textobject</sgmltag>
         <sgmltag class="starttag">phrase</sgmltag><!--Here there's an image of this example-->この部分には、この例での画像が置かれています。<sgmltag class="endtag">phrase</sgmltag>
      <sgmltag class="endtag">textobject</sgmltag>
      <sgmltag class="starttag">caption</sgmltag><sgmltag class="starttag">para</sgmltag><!--Image Description. Optional. -->画像による説明(オプション)<sgmltag class="endtag">para</sgmltag><sgmltag class="endtag">caption</sgmltag>
   <sgmltag class="endtag">mediaobject</sgmltag>
<sgmltag class="endtag">figure</sgmltag>
</programlisting>
      </example>

      <para><!--Files on the following formats are available -->
      次のようなフォーマットのファイルが使えます。
      <simplelist type="inline">
        <member>BMP</member>
        <member>CGM-BINARY</member>
        <member>CGM-CHAR</member>
        <member>CGM-CLEAR</member>
        <member>DITROFF</member>
        <member>DVI</member>
        <member>EPS</member>
        <member>EQN</member>
        <member>FAX</member>
        <member>GIF</member>
        <member>GIF87A</member>
        <member>GIF89A</member>
        <member>IGES</member>
        <member>JPEG</member>
        <member>JPG</member>
        <member>LINESPECIFIC</member>
        <member>PCX</member>
        <member>PIC</member>
        <member>PS</member>
        <member>SGML</member>
        <member>TBL</member>
        <member>TEX</member>
        <member>TIFF</member>
        <member>WMF</member>
        <member>WPG</member>
      </simplelist>.</para>

      <!--
      <para>This method presents an advantage: a better control of the 
      application. The elements <sgmltag class="starttag">imageobject</sgmltag>
      are consecutively tested until one of them is accepted. In case of the
      output format doesn't support images the element <sgmltag
      class="starttag">textobject</sgmltag> will be used. However, the biggest
      advantage in usage of the format <xref
      linkend="former-figure-imageobject"> is that on the release
      <literal>5.0</literal> of the DocBook the element <sgmltag
      class="starttag">graphic</sgmltag> will cease to exist.</para> 
      -->
<para>この方法には、より適切にアプリケーションを管理できるという利点があり
ます。<sgmltag class="starttag">imageobject</sgmltag> エレメントは、利用可能な
フォーマットが見つかるまで順番にテストされ、出力フォーマットとして画像を
サポートしていない場合は、<sgmltag class="starttag">textobject</sgmltag> 
エレメントが使用されます。しかし、<xref linkend="former-figure-imageobject"> 
形式を使う最大の利点は、DocBook のリリース <literal>5.0</literal> では、
<sgmltag class="starttag">graphic</sgmltag> エレメントは存在しなくなるという
点です。
</para>

      <!--
      <para>As a disadvantage there's the need for more than one representation
      code of the same information. It's up to the author to decide which 
      method
      he will implement illustrations and pictures on his or hers document, but
      for compatibility reasons with future versions <emphasis>I
      recommend</emphasis> the use of this method for pictures and
      graphics.</para> 
      -->
<para>欠点としては、同じひとつの情報を表現するためにいくつものコードを必要と
するという点です。文書内にイラストや写真を入れるのにどちらを使うかは文書
制作者しだいですが、将来のバージョンとの互換性からすると、<emphasis>僕として
は</emphasis>、画像の挿入方法としてこちらを推奨します。</para>

    </section>

  </section>

  <section id="tables">
    <title><!--Tables-->表組</title>

    <indexterm zone="ex-tables">
      <primary>tables</primary>
      <secondary>inserting</secondary>
    </indexterm>

    <!--
    <para>Many information are best represented when formatted as tables.
    </para>
    -->
<para>表にすると情報の意味が明瞭になるケースは数多くあります。</para>

    <!--    
    <para>A primitive way to create tables was already presented on the <xref
    linkend="table-useful-commands"> with the use of <sgmltag
    class="starttag">simplelist</sgmltag>, however, the DocBook has more 
    sophisticated methods to deal with this information.</para>
    -->
<para>表を作成する簡単な方法は、<sgmltag class="starttag">simplelist</sgmltag> 
を使った <xref linkend="table-useful-commands"> でも既に紹介しましたが、DocBook 
には、この種の情報を扱うもっと洗練された方法があります。</para>


    <example id="ex-tables">
      <title><!--Inserting tables-->表の挿入</title>

      <programlisting>
&example-table;
      </programlisting>
    </example>

    <indexterm zone="ex-tables">
      <primary>tables</primary>
      <secondary>inserting</secondary>
      <tertiary>example</tertiary>
    </indexterm>

    <table frame="all">
      <title><!--Example Table-->表の例</title>
      <tgroup cols="5">
        <colspec colname="column1">
        <colspec colname="column2">
        <colspec colname="column3">
        <colspec colnum="5" colname="column5">
        <spanspec namest="column1" nameend="column2" spanname="span-horiz" align="center">
        <spanspec namest="column2" nameend="column3" spanname="span-horiz-vert" align="center">
        <thead>
          <row>
            <entry spanname="span-horiz"><!--Horizontal Span-->水平方向のスパン</entry>
            <entry><!--Heading 2-->ヘッダ 2</entry>
            <entry><!--Heading 3-->ヘッダ 3</entry>
            <entry><!--Heading 4-->ヘッダ 4</entry>
          </row>
        </thead>
        <tfoot>
          <row>
            <entry><!--Footing 1-->フッタ 1</entry>
            <entry><!--Footing 2-->フッタ 2</entry>
            <entry><!--Footing 3-->フッタ 3</entry>
            <entry><!--Footing 4-->フッタ 4</entry>
            <entry><!--Footing 5-->フッタ 5</entry>
          </row>
        </tfoot>
        <tbody>
          <row>
            <entry><!--Data11-->データ 1-1</entry>
            <entry><!--Data12-->データ 1-2</entry>
            <entry><!--Data13-->データ 1-3</entry>
            <entry><!--Data14-->データ 1-4</entry>
            <entry><!--Data15-->データ 1-5</entry>
          </row>
          <row>
            <entry><!--Data21-->データ 2-1</entry>
            <entry><!--Data22-->データ 2-2</entry>
            <entry><!--Data23-->データ 2-3</entry>
            <entry><!--Data24-->データ 2-4</entry>
            <entry morerows="1" valign="middle"><!--Vertical Span-->垂直方向のスパン</entry>
          </row>
          <row>
            <entry><!--Data31-->データ 3-1</entry>
            <entry spanname="span-horiz-vert" morerows="1" valign="bottom"><!--Double Span-->ダブルスパン</entry>
            <entry><!--Data34-->データ 3-4</entry>
          </row>
          <row>
            <entry><!--Data41-->データ 4-1</entry>
            <entry><!--Data44-->データ 4-4</entry>
            <entry><!--Data45-->データ 4-5</entry>
          </row>
        </tbody>
      </tgroup>
    </table>

  </section>

  <section id="listings">
    <title><!--Listings and program codes-->プログラムコードとコメント</title>

    <indexterm zone="listings">
      <primary>listings</primary>
      <secondary>inserting</secondary>
    </indexterm>

    <!--
    <para>An interesting feature is to show parts of code and the possibility 
    to comment on them. The DocBook allows the insertion of the program code 
    and also callouts to specific lines of this code.</para> 
    -->
<para>面白い機能として、コードの一部を指定して、それにコメントを付ける
というのがあります。DocBook を使えば、プログラムコードを文書に挿入して、
そのコードの特定の行に「しるし(callout)」を付けることができます。</para>

    <!--
    <para>Such a feature was used, for example, to demonstrate how a catalogue
    file is configured (see <xref linkend="making-catalogues">).</para>
    -->
<para>この機能は、例えば、カタログファイルの設定方法を説明した際に、使用して
います。(<xref linkend="making-catalogues"> 参照)</para>

    <!--
    <para>The used code was demonstrated below. In case the callout feature 
    isn't desired, it's possible to eliminate the areas between 
    <sgmltag class="starttag">areaspec</sgmltag> and <sgmltag
    class="starttag">calloutlist</sgmltag>.</para>
    -->
<para>その際に使ったコードを以下に示します。「しるし(callout)」機能の使用が
望ましくないケースでは、<sgmltag class="starttag">areaspec</sgmltag> と 
<sgmltag class="starttag">calloutlist</sgmltag> に挟まれた空間を消去する
こともできます。</para>

<!--訳注-->
<para>(訳注: <xref linkend="table-useful-commands">同様、<sgmltag class="starttag">to</sgmltag>
<sgmltag class="endtag">to</sgmltag> は <sgmltag class="starttag">para</sgmltag>
<sgmltag class="endtag">para</sgmltag> に修正しました。)</para>

    <programlisting id="ex-listing">
&lt;example id="sample-catalog"&gt;
  &lt;title&gt;Catalog Sample&lt;/title&gt;
  &lt;programlistingco&gt;
    &lt;areaspec&gt;
      &lt;area coords="1" id="ex.catalogue.comment"&gt;
      &lt;area coords="5" id="ex.catalogue.definition"&gt;
      &lt;area coords="11" id="ex.catalogue.eof"&gt;
    &lt;/areaspec&gt;
        &lt;programlisting&gt;
-- Catalogues for the Conectiva S.A. Style --

OVERRIDE YES
 
PUBLIC "-//Conectiva SA//DTD books V1.0//EN" "/home/ldp/estilos/livros.dtd" 

DELEGATE "-//OASIS" "/home/ldp/SGML/dtds/catalog.dtd"

DOCTYPE BOOK /home/ldp/SGML/dtds/docbook/db31/docbook.dtd
 
-- EOF -- 
        &lt;/programlisting&gt;
    &lt;calloutlist&gt;
      &lt;callout arearefs="ex.catalogue.comment"&gt;
        &lt;<!--to-->para&gt; Comment. Comments begin with &lt;quote&gt;--&lt;/quote&gt; 
        and follows to the end of the line. &lt;/<!--to-->para&gt; 
      &lt;/callout&gt;
      &lt;callout arearefs="ex.catalogue.definition"&gt;
        &lt;<!--to-->para&gt; The public type association 
           &lt;parameter class="option"&gt;"-//Conectiva SA//DTD books V1.0//EN"&lt;/parameter&gt; 
           with the file &lt;filename&gt;books.dtd&lt;/filename&gt; on the directory
           &lt;filename class="directory"&gt;/home/ldp/estilos&lt;/filename&gt;. &lt;/para&gt; 
      &lt;/callout&gt;
      &lt;callout arearefs="ex.catalogue.eof"&gt;
        &lt;para&gt; Comment informing the end of the file. &lt;/para&gt;
      &lt;/callout&gt;
    &lt;/calloutlist&gt;
  &lt;/programlistingco&gt;
&lt;/example&gt;
    </programlisting>

    <indexterm zone="ex-listing">
      <primary>listings</primary>
      <secondary>inserting</secondary>
      <tertiary>example</tertiary>
    </indexterm>

    <!--
    <para>The listings can be directly inserted on the document's body without 
    the need of the element <sgmltag class="starttag">example</sgmltag>
    or <sgmltag class="starttag">para</sgmltag>.</para>
    -->
<para><sgmltag class="starttag">example</sgmltag> や <sgmltag class="starttag">
para</sgmltag> エレメントを使わなくとも、コメント(listing)は、直接本文内に
書くことができます。</para>

    <!--
    <para>The calling coordinates specifications are done with reference to the
    code line which will be commented.</para>
    -->
<para>「しるし」の位置は、コメントが書かれたコード位置に合うように処理され
ます。</para>

  </section>

  <section id="crediting">
    <title><!--Crediting Translators and Converters-->
     翻訳者やコード変換者の氏名を表示する</title>

<!--
    <para>When someone else assists in the production of an LDP document,
    you should give them proper attribution, and there are DocBook tags
    designed to do this. This section will show you the tags you should
    use, as well as other ways of giving credit where credit is due.
    Crediting editors is easy - there is already an
    <sgmltag class="starttag">editor</sgmltag>tag in DocBook.
    But there are two special cases where you need to credit someone,
    but DocBook doesn't provide a special tag. These are <emphasis>translators
    </emphasis> and <emphasis>converters</emphasis>.</para>
-->
<para>誰かが LDP 文書作成の手助けをしてくれたときは、それを文書内で明らかに
すべきですし、DocBook にもそのためのタグがあります。このセクションでは、そう
した何らかの形で貢献者の氏名 (credit) を表示すべき場合に使うタグについて紹介
します。
まず、編集者についてなら簡単です。DocBook にはあらかじめ <sgmltag 
class="starttag">editor</sgmltag> というのがあります。しかし、氏名を表示すべき
でも DocBook に該当するタグのない特別なケースが 2 つあります。<emphasis>翻訳者
</emphasis> と <emphasis>コード変換者</emphasis> です。</para>

<!--
    <para>A <emphasis>converter</emphasis> is someone
    who performs a source code conversion, e.g., from HTML to DocBook SGML.
    Source code conversions help the LDP achieve long term goals for meta-data,
    and allow us to produce documentation in many different output formats.
    </para>
-->
<para><emphasis>コード変換者</emphasis>とは、例えば HTML を DocBook SGML に変換
するなど、ソースコードの変換を行う人のことです。ソースコードの変換が
行われることで、LDP アーカイブは、メタデータの作成というこれからの目標の達成に
より適したものになりますし、文書を多様な出力フォーマットで提供することができる
ようになります。</para>

<!--
    <para>Translators take your original document and translate it into other
    human-readable languages, e.g., from English to Japanese, or from German
    to English. Each translation allows many more people all over the world
    to make use of your document, and helps Linux achieve the ultimate goal -
    Total World Domination(tm)!</para>
-->
<para>翻訳者は、オリジナル文書を、例えば英語から日本語、ドイツ語から英語と
いった別の地域の言語へと移し換えます。個々の翻訳文書によって、世界中のより多く
の人々があなたの文書を利用できるようになりますし、Linux アーカイブの究極の野望
である、「全世界制覇 "Total World Dominion (tm)" 」にまた一歩近づくことができ
ます。</para>

<!--
    <para>As you will see in the following
    sections, there are several ways that these folks, as well as other
    contributors to your document, can be given some recognition for the
    help they've given you.</para>
-->
<para>以下のセクションに示すような方法で、そうした人たちや、あなたの文書作成に
貢献したそれ以外の人たちに対して、その支援内容を明らかにすることができます。
</para>

    <section id="crediting-othercredit">
      <title><!--The--> <sgmltag class="starttag">othercredit</sgmltag> <!--Tag-->タグ</title>

<!--
      <para>All translators and converters should be credited with an
      <sgmltag class="starttag">othercredit</sgmltag> tag entry.
      To properly credit a translator or converter, use the
      <sgmltag class="starttag">othercredit</sgmltag> tag with the <sgmltag 
      class="starttag">
      role</sgmltag>
      attribute set to <quote>converter</quote> or <quote>translator</quote>,
      as indicated in the example below:</para>
-->
<para>翻訳者やコード変換者の氏名を表示する場合には、<sgmltag class="starttag">
othercredit</sgmltag> というタグ・エントリーを使ってください。翻訳やコード変換
といったそれぞれの役割を明示するには、<sgmltag class="starttag">othercredit
</sgmltag> タグの <sgmltag class="starttag">role</sgmltag> 属性に、<quote>
converter</quote> (コード変換者) や <quote>translator</quote> (翻訳者) といった
値を設定します。これは、例えば、次のようになります。</para>

      <programlisting>
<sgmltag class="starttag">othercredit role='converter'</sgmltag>
  <sgmltag class="starttag">firstname</sgmltag>David<sgmltag class="endtag">firstname</sgmltag>
  <sgmltag class="starttag">surname</sgmltag>Merrill<sgmltag class="endtag">surname</sgmltag>
  <sgmltag class="starttag">contrib</sgmltag>Conversion from HTML to DocBook v3.1 (SGML).<sgmltag class="endtag">contrib</sgmltag>
<sgmltag class="endtag">othercredit</sgmltag></programlisting>
    </section>

    <section id="crediting-ack">
      <title><!--The <quote>Acknowledgements</quote> section-->
      <quote>謝辞</quote> (Acknowledgements) の章について</title>

<!--
      <para>Your document should have a section titled <quote>Acknowledgements</quote>,
      in which you mention everyone who has contributed to your document in
      any meaningful way. You should include translators and converters, as well as
      people who have sent you lots of good feedback, perhaps the person who taught
      you the knowledge you are now passing on, and anybody else who was instrumental
      in making the document what it is. Most authors put this section at the end
      of their document.</para>
-->
<para>文書内には、<quote>謝辞</quote> (Acknowledgements) と題したセクションを
作って、そこで、その文書に意味のある貢献をしたすべての人のことを書くようにしま
しょう。翻訳者やコード変換者だけでなく、多くの有意義なフィードバックを送ってく
れた人や、あなたが知ろうとしていた知識を教えてくれた人、あるいは、現在の文書が
出来上がるまでに手足となって手伝ってくれた人たちなどがそれに含まれます。大部分
の著者が、文書の最後にこのセクションを置いています。</para>

    </section>

    <section id="crediting-version">
      <title><!--The--> <sgmltag class="starttag">revremark</sgmltag> <!--tag-->タグ</title>

<!--
      <para>Within the <sgmltag class="starttag">revision</sgmltag> tag hierarchy is
      a tag called <sgmltag class="starttag">revremark</sgmltag>. Within this tag,
      you can make any brief notes you wish about each particular revision of your
      document. We recommend that you acknowledge converters in the comment for the
      initial version released in the new format, and we recommend that you credit
      translators in each version which they have translated.</para>
-->
<para><sgmltag class="starttag">revision</sgmltag> タグには階層があり、その中
に、<sgmltag class="starttag">revremark</sgmltag> というタグがあります。この
タグで囲んだ領域には、文書を改訂した際の簡単な覚え書きを書き込んでおくことが
できます。新しいフォーマットでリリースした最初のバージョンのコメントとして
コード変換者に対する謝辞を書いておいたり、翻訳者の氏名を翻訳したバージョンごと
に書いておいたりすることをお薦めしたいと思います。</para>

    </section>
  </section>

  <section id="tools-hints">
    <title><!--Tools &amp; Hints-->ツールとヒント</title>

    <!--
    <para>The process of producing output and generating indexes is
    repetitive and error prone. To make things easier some scripts are
    included here to facilitate this work. Customize and use them at
    will.</para>
    -->
<para>出力結果を見たり索引を作ったりする処理は、文書作成中に何度も繰り返され
ますし、エラーが出ることも多いはずです。こうした処理を楽に行うために、
いくつかのスクリプトを用意しました。よろしければカスタマイズして使ってくだ
さい。</para>

    <section id="tools-compile">
      <title><!--Compiling the sources-->ソースのコンパイル</title>

    <indexterm>
      <primary>tools</primary>
        <secondary>compiling the sources</secondary>
    </indexterm>

      <!--
      <para>The script compiles-sgml is a set of grouped commands. As 
      parameters the name of the document should be passed
      <glossterm><acronym>SGML</acronym></glossterm> and the output format
      expected.</para> 
      -->
<para>compiles-sgml スクリプトは、一連のコマンドをグループ化したものです。
パラメータとして、<glossterm><acronym>SGML</acronym></glossterm> の
文書名と出力したいフォーマット名を渡す必要があります。</para>

      <!--
      <para>The script version included below supports the formats
      <glossterm><acronym>XML</acronym></glossterm>,
      <glossterm><acronym>HTML</acronym></glossterm>, TeX,
      <glossterm><acronym>RTF</acronym></glossterm>,
      <glossterm>PS</glossterm>, <glossterm>DVI</glossterm> and mirrored PS,
      ideal for the creation of photolithographs.</para>
      -->
<para>下記のバージョンのスクリプトでは、
      <glossterm><acronym>XML</acronym></glossterm>,
      <glossterm><acronym>HTML</acronym></glossterm>, TeX,
      <glossterm><acronym>RTF</acronym></glossterm>,
      <glossterm>PS</glossterm>, <glossterm>DVI</glossterm> および
写像 PS (mirrored PS) フォーマットをサポートしているので、フォトリトグラフ
を生成する場合には理想的です。</para>

      <!--
      <para>The generation of the indices is made automatically by the script
      <filename>collateindex.pl</filename><footnote>
          <para>More information about indexes are available at <ulink
      url="http://nwalsh.com/docbook/dsssl/doc/indexing.html">the page about
      index of Norman Walsh</ulink>.</para> </footnote>, which should be 
      installed in your system. </para>
      -->
<para>索引の生成は、<filename>collateindex.pl</filename><footnote>
<para>索引の詳細は、<ulink 
url="http://nwalsh.com/docbook/dsssl/doc/indexing.html">Norman Walsh のサイト
にある索引関係のページ</ulink>をご覧ください。</para></footnote> スクリプト
が自動的に行うので、左記スクリプトをあらかじめシステムにインストールして
おいてください。</para>

      <!--
      <para>Besides the commands below which generate the outputs in different 
      formats, there are other tools from<trademark>Cygnus</trademark> making
      the direct conversion. Such tools can be obtained in <ulink
      url="http://sourceware.cygnus.com/docbook-tools/">here</ulink>.</para>  
      -->
<para>様々なフォーマットで出力を生成する下記のコマンドとは別に、他にも 
直接変換を行うツールが <trademark>Cygnus</trademark> から提供されています。
そのツールは、<ulink url="http://sourceware.cygnus.com/docbook-tools/">
ここ</ulink>から入手することができます。</para>

      <!--
      <para>The list below is available <ulink
      url="compiles-sgml">here</ulink>.</para>
      -->
<para>以下のスクリプトは、<ulink 
url="http://www.linuxdoc.org/LDP/LDP-Author-Guide/compile-sgml">ここ</ulink>
から手に入れることもできます。</para>

      <!--
      <para>Here is also available a version of <ulink
      url="collateindex.pl"><filename>collateindex.pl</filename></ulink>.
      </para>
      -->
<para>上記の場所には、 <ulink 
url="http://www.linuxdoc.org/LDP/LDP-Author-Guide/collateindex.pl">
<filename>collateindex.pl</filename></ulink> もあります。</para>

      <example id="listing-compile-sgml">
        <title><!--Script compiles-sgml-->compiles-sgml スクリプト</title>
        <programlisting>
&example-compile-sgml;
        </programlisting>
      </example>

      <indexterm>
        <primary>tools</primary>
        <secondary>compiling sources</secondary>
        <tertiary>compile-sgml</tertiary>
      </indexterm>


      <!--
      <para>Obviously such script can be modified forming a
      <filename>Makefile</filename>, optimizing some functions.</para> 
      -->
<para>こうしたスクリプトは、<filename>Makefile</filename> を作って、
関数のいくつかを最適化することで、修正できるのがお分かりになると思います。
</para>

    </section>

    <section id="toc-articles">
      <title><!--Inserting a summary on the initial articles page-->
             article の最初のページに要旨を挿入する</title>

      <indexterm>
        <primary>tools</primary>
        <secondary>articles</secondary>
        <tertiary>summary</tertiary>
      </indexterm>

      <!--
      <para>A feature that might be interesting in some cases is the insertion
      of a summary on the initial page of an article. The DocBook articles 
      does not include it as a standard feature.</para>
      -->
<para>article の最初のページに要旨を表示できる機能が欲しいと思う場合があるかも
しれません。ただ、DocBook の article は、標準では、この機能を持っていません。
(訳注: DocBook の book を使う場合は、問題ありません。)
</para>

      <!--
      <para>To enable this it's necessary to make a modification on
      the stylesheet file used.</para> 
      -->
<para>これを有効にするには、利用しているスタイルシートに修正を加える
必要があります。</para>

      <!--
      <para>The example below describes the process and it's use is shown
      in <xref linkend="listing-compile-sgml">.</para>
      -->
<para>以下の例は、その場合の処理について述べています。使い方は、
<xref linkend="listing-compile-sgml"> をご覧ください。</para>
<!--せんだ。上記の例題が 4.8 であることは意味不明。-->

      <example>
        <title><!--Stylesheet to insert summaries in articles-->
        article で、自動的に要旨を挿入するための stylesheet の設定
        </title>
        <programlisting>
&dsl-example;
        </programlisting>
      </example>

    </section>

    <section id="automatic-indexes">
      <title><!--Inserting indexes automatically-->
             索引を自動的に挿入する</title>

      <indexterm>
        <primary>tools</primary>
        <secondary>indexes</secondary>
        <tertiary>automatic generation</tertiary>
        <seealso>edition, index</seealso>
      </indexterm>

      <!--
      <para>Although DocBook has markups for the composition of indexes, these
      are not generated automatically. The tool <ulink
      url="collateindex.pl">collateindex.pl</ulink> allows the indexes to be 
      generated automatically.</para>
      -->
<para>DocBook には索引付けをするためのマークアップがありますが、それらは
自動的には生成されません。しかし、<ulink 
url="http://www.linuxdoc.org/LDP/LDP-Author-Guide/collateindex.pl">
collateindex.pl</ulink> ツールを使えば、索引生成は自動化できます。</para>

      <!--
      <para>The way to use this script is described bellow and a practical 
      example can be seen previously in this document (see <xref
      linkend="listing-compile-sgml">).</para> 
      -->
<para>次にこのスクリプトの使い方を説明します。実際の例は、この文書で先ほど
ご覧になったと思います。(<xref linkend="listing-compile-sgml">参照)</para>

      <orderedlist>
        <listitem>
          <!--
          <para>Process the document with <application>jade</application>
          using the style to <glossterm><acronym>HTML</acronym></glossterm>
          with the option <option>-V html-index</option>.</para>
          -->
<para><glossterm><acronym>HTML</acronym></glossterm> スタイルシートと、
オプション <option>-V html-index</option> を使って、<application>jade
</application> で文書を処理します。</para>

          <informalexample>
            <screen><prompt>$</prompt> <command>jade</command> <option>-t sgml -d html/docbook.dsl -V html-index document.sgml</option></screen>
          </informalexample>
        </listitem>
        <listitem>
          <!--
          <para>Generate the document <filename>index.sgml</filename> with  
          <ulink
          url="collateindex.pl">collateindex.pl</ulink>.</para>
          -->
<para><ulink 
url="http://www.linuxdoc.org/LDP/LDP-Author-Guide/collateindex.pl">
collateindex.pl</ulink> を使って、<filename>index.sgml</filename> 文書
を生成します。</para>
          <informalexample>
            <screen><prompt>$</prompt> <command>perl</command> <option>collateindex.pl -o index.sgml HTML.index</option></screen>
          </informalexample>
        </listitem>
      </orderedlist>

      <!--
      <para>For the above example to work, it's necessary to define an
      <glossterm>external entity</glossterm> by calling the file
      <filename>index.sgml</filename>.</para> 
      -->
<para>上記の例が機能するには、<glossterm>外部エンティティ(external entity)
</glossterm> を定義して <filename>index.sgml</filename> ファイルを取り込む
必要があります。</para>

      <example id="ex-entity-external-index">
        <title><!--Configuring an external entity to include the index-->
               索引を付けるために外部エンティティを設定する</title>
         <programlisting>
<sgmltag class="starttag">!doctype article PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [

&lt;!-- Insertion of the index --&gt;
&lt;!entity index SYSTEM "index.sgml"&gt;
]</sgmltag>
        </programlisting>
      </example>
      
      <!--
      <para>See also <xref linkend="encoding-index"> for information on how to
	  insert necessary information on the text.</para> 
      -->
<para>文中に必要な情報を取り込む方法については、<xref 
linkend="encoding-index"> もご覧ください。</para>

      <note>
        <!--
        <para>Remember that if you're trying to get Table of Contents
        or Indexes on PS or PDF output you'll need to run <application
        moreinfo="none">jadetex</application> or <application
        moreinfo="none">pdfjadetex</application> at least three
        times. This is a <application
        moreinfo="none">TeX</application> requirement and not a
        DocBook or related application one.</para>
        -->
<para>PS か PDF での出力の際に目次や索引を取り込もうとしている場合は、
<application moreinfo="none">jadetex</application> か <application 
moreinfo="none">pdfjadetex</application> を最低 3 回は実行する必要がある
ことに注意してください。これは、<application moreinfo="none">TeX
</application> が必要とする処理であり、DocBook もしくはそれに関連した
アプリケーションの問題ではありません。</para>
      </note>

    </section>
    
    <section id="tools-writing">
      <title><!--Making notes on the text while it's being written-->
             文書の中の下書き部分を隠す</title> 
       <indexterm zone="tools-writing">
        <primary>entities</primary>
        <secondary>parameters</secondary>
        <tertiary>usage</tertiary>
      </indexterm>
      

      <!--      
      <para>An interesting feature while writing a text is to be able
      to check if such text will be presentable or not on the final
      draft. It's common to have several parts of the text marked as
      drafts, especially when we're updating an already existent
      document.</para> 
      -->
<para>面白い機能として、文書の作成中に、その作成部分を最終稿として
公開するかどうかを簡単なチェックだけで決めることができる機能があります。
既存の文書を更新しようとしている場合などには特に、文書内に草稿として
位置づけられている部分がいくつも存在する場合がよくあります。</para>
      
      <!--
      <para>DocBook allows along with an entity of parameters to
      include or not the insertions of specific parts of text in
      several places on the document based on the context. Sometimes
      for an upgrading we need to see how the document looks like or
      just have sketches of a new session or chapter, but we don't
      want this sketch to appear on the final draft.</para> 
      -->
<para>DocBook では、パラメータ・エンティティ(parameter entity)を使って、
文書内に散らばった特定部分の文章を、状況に応じて隠したり表示したりする
ことができます。文書を更新している場合には、文書がどう見えるのかを確認
したり、新しい章や編のおおまかな出来具合を確認したりする必要がありますが、
その草稿部分を最終稿には表示したくないということがよくあります。</para>
      
      <!--
      <para>With the use of parameter entities we can include or eliminate
      these drafts altering only one line at the beginning of a
      document.</para> 
      -->
<para>パラメータ・エンティティを使うと、文書の冒頭の一行を変更するだけで、
そうした草稿部分を文書内に含めたり、文書から削除したりすることができます。
</para>
      
      <example id="ex-entity-parameters">
        <title><!--Use of parameter entities-->
               パラメータ・エンティティを使う</title>
        <programlisting>
<sgmltag class="starttag">!entity % review "INCLUDE"</sgmltag>
...
<sgmltag class="starttag">![%review;[
<!--
&lt;para&gt;This paragrph will be included on the draft when the entity
"review" is defined with the value "INCLUDE". &lt;/para&gt;
-->
&lt;para&gt;この段落は、上記エンティティ "review" の値が "INCLUDE" と
定義されたときに、文書中の一部となります。&lt;/para&gt;
]]</sgmltag>
        </programlisting>
      </example>
      
      <indexterm zone="ex-entity-parameters">
        <primary>entities</primary>
        <secondary>parameters</secondary>
        <tertiary>exemple</tertiary>
      </indexterm>

      <!--
      <para>The entity <literal>review</literal> might have several
      texts defined as in <xref linkend="ex-entity-parameters">. When
      the changes on the text are considered final, it's necessary
      just to remove parts of the text relative to the
      3<superscript>rd.</superscript> and
      6<superscript>th.</superscript> lines.</para>
      -->
<para>上記エンティティ <literal>review</literal> は、文書内のいろいろな
箇所に書き込むことができます。その部分への変更が終了したら、上記の例ならば、
3 行目と 6 行目を削除するだけです。</para>

      <!--
      <para>To keep the draft definitions and don't show the text on
      the final draft, just alter the specification of the entity from
      <literal>INCLUDE</literal> to <literal>IGNORE</literal>.</para> 
      -->
<para>草稿のままで保持して、最終稿には含めないようにするには、
エンティティの値を <literal>INCLUDE</literal> から <literal>IGNORE
</literal> に書き換えるだけで済みます。</para>

    </section>

    <section id="tools-reuse">
      <title><!--Re-using parts of documents-->
              頻繁に利用する文書を外部から取り込む</title>


      <indexterm zone="tools-reuse">
        <primary>documents</primary>
        <secondary>re-use</secondary>
      </indexterm>

      <!--
      <para>An important characteristic about the <glossterm>external
      entities</glossterm> is about the re-using issue of text and
      documents.</para>
      -->
<para>外部エンティティ(<glossterm>external entity</glossterm>)の重要な
特性は、よく使われるメモや文書を取り扱う際に発揮されます。</para>

      <!--
      <para>With those characteristics it's possible to create files with text
      used several times (e.g. licenses and company policies) and simply
      include those files in the appropriate place.</para>
      -->
<para>この特性を活かして、(例えば、ライセンスや社則などの)頻繁に利用される
文章をファイルにして、そうしたファイルを文書の適切な位置に取り込むことが
できます。</para>
     
      <!--
      <para>An example and application of this characteistic was found 
      previously in <xref linkend="ex-entity-external-index">. Another example
      is the <glossterm>SGML</glossterm> code of this HOWTO.</para> 
      -->
<para>この特性を応用した例に、先ほどの <xref 
linkend="ex-entity-external-index"> があります。また、この HOWTO 文書自体の 
<glossterm>SGML</glossterm> コードもその一例です。</para>
    </section>

  </section>

  <section id="examples-documents">
    <title><!--Document samples-->文書のサンプル</title>

    <indexterm zone="examples-documents">
      <primary>edition</primary>
      <secondary>examples</secondary>
    </indexterm>

    <!--
    <para>As stated before each type of document has a particular heading
    and valid commands structure. The following sub-sections will provide
    heading and valid commands structures on articles and books.</para>
    -->
<para>繰り返しになりますが、個々の文書型には、その文書型特有のヘッダと有効な
コマンドの階層があります。以下のサブセクションでは、article と book に
ついてのヘッダと有効なコマンド階層を紹介します。</para>
   
    <!--
    <para>These examples do not cover all possibilities and they are
    available here only with the intention to serve as generic guides for
    what it's possible to do.</para>
    -->
<para>ここでの例は、あらゆる利用方法をカバーしているわけではないので、
以下では、使い方の一般例を提供する意味で紹介します。</para>

    <section id="examples-documents-article">
      <title><!--Article example-->article の例</title>

      <indexterm zone="examples-documents-article">
        <primary>edition</primary>
        <secondary>examples</secondary>
        <tertiary>article</tertiary>
      </indexterm>

      <programlisting>
&example-article;
      </programlisting>
    </section>

    <section id="examples-documents-book">
      <title><!--Book Example-->book の例</title>

      <indexterm zone="examples-documents-book">
        <primary>edition</primary>
        <secondary>examples</secondary>
        <tertiary>book</tertiary>
      </indexterm>

      <programlisting>
<!-- &example-book; -->
作成中
      </programlisting>

    </section>

  </section>
</chapter>
