<!doctype book public "-//OASIS//DTD DocBook V3.1//EN" [


<!-- 
<!entity header system "header.sgml">
<!entity docbook system "docbook.sgml">
--> 
<!entity conventions SYSTEM "conventions.sgml">
<!entity using-docbook SYSTEM "using-docbook.sgml">
<!entity doc-index SYSTEM "index.sgml">

<!-- Include macros -->
<!entity conventions SYSTEM "conventions.sgml">
<!entity example-article SYSTEM "example-article.sgml">
<!entity example-book SYSTEM "example-book.sgml">
<!entity example-compile-sgml SYSTEM "compiles-sgml.sgml">
<!entity example-table SYSTEM "example-table.sgml">
<!entity dsl-example SYSTEM "dsl-example.sgml">
<!entity glossary SYSTEM "glossary.sgml">
<!entity cvs SYSTEM "cvs.sgml">
<!entity style-guide SYSTEM "style-guide.sgml">
<!-- Text Macros -->
<!entity conectivasa '<ulink url="http://www.conectiva.com">Conectiva S.A.</ulink>'>
<!entity conectiva "Conectiva">

]>


<book>
  <bookinfo>
    <title>LDP Author Guide</title>
    <pubdate>v3.5 4 Dec, 2000</pubdate>
    <author>
      <firstname>Mark</firstname>
      <othername>F.</othername>
      <surname>Komarinski</surname>
      <affiliation>
        <orgname>VA Linux Systems</orgname>
        <address><email>markk@linuxdoc.org</email></address>
      </affiliation>
    </author>
    <author>
      <firstname>Jorge</firstname>
      <surname>Godoy</surname>
      <affiliation>
        <orgname>&conectivasa;</orgname>
        <orgdiv>Publishing Department</orgdiv>
        <address><email>godoy@conectiva.com</email></address>
        <address><email>godoy@metalab.unc.edu</email></address>
      </affiliation>
    </author>
    <author>
      <firstname>David</firstname>
      <othername>C.</othername>
      <surname>Merrill</surname>
      <affiliation>
        <address><email>dcmerrill@mindspring.com</email></address>
      </affiliation>
    </author>
    <othercredit role='translator'>
       <firstname>Yuji</firstname>
       <surname>Senda</surname>
       <contrib>translated into japanese 2000/12/24/</contrib>
     </othercredit>

    <abstract>
      <para><!--List the tools, procedures, and hints to get LDP authors
      up to speed and writing. -->
      LDP 文書の作成者が快適に文書を作成するためのツールや手順、
      およびヒントを、リストアップしました。</para>
    </abstract>
    <revhistory>
      <revision>
        <revnumber>3.5</revnumber>
        <date>Dec 4, 2000</date>
        <authorinitials>mfk</authorinitials>
        <revremark>Changed mailing list pointers to new lists.</revremark>
       </revision>
       <revision>
        <revnumber>3.4</revnumber>
        <date>Dec 1, 2000</date>
        <authorinitials>dcm</authorinitials>
        <revremark>Added Crediting Translators and Converters</revremark>
       </revision>
       <revision>
        <revnumber>3.3</revnumber>
        <date>Nov 11, 2000</date>
        <authorinitials>mfk</authorinitials>
        <revremark>Added links to SGML GPL and FDL</revremark>
      </revision>
      <revision>
        <revnumber>3.1</revnumber>
        <date>Oct 10, 2000</date>
        <authorinitials>mfk</authorinitials>
        <revremark>Spelling changes, changed list of LDP policies to now
        accept DocBook XML.  More information about how to use *jade
        with XML will follow.
        </revremark>
      </revision>
      <revision>
        <revnumber>3.0</revnumber>
        <date>Aug 24, 2000</date>
        <authorinitials>gjf</authorinitials>
        <revremark>Integrated David Merrill's style guide document. Further 
         clean-up and additions.</revremark>
      </revision>
      <revision>
        <revnumber>2.0</revnumber>
        <date>Jul 13, 2000</date>
        <authorinitials>mfk</authorinitials>
        <revremark>Cleaned up using-docbook a bit.  Moved some chapters
        </revremark>
      </revision>
      <revision>
        <revnumber>1.9</revnumber>
        <date>Jun 26, 2000</date>
        <authorinitials>mfk</authorinitials>
        <revremark>Integrated Jorge's using-docbook document.</revremark>
      </revision>
      <revision>
        <revnumber>1.5</revnumber>
        <date>Jun 14, 2000</date>
        <authorinitials>mfk</authorinitials>
        <revremark>Documented sgedit</revremark>
      </revision>
      <revision>
        <revnumber>1.4</revnumber>
        <date>Jun 12, 2000</date>
        <authorinitials>mfk</authorinitials>
        <revremark>Documented vim and sgedit.  Spelling and other
        changes from ldp list.  Also added LDP guidelines under style
        guide.</revremark> 
      </revision>
    </revhistory>
  </bookinfo>

  <chapter id="aboutthisguide">
    <title><!--About this Guide-->この文書について</title>

    <section id="purpose">
      <title><!--Purpose / Scope of this Guide-->
      この文書の目的と射程</title>

      <!--
      <para>This document was started on Aug 26, 1999 by Mark
      F. Komarinski after two day's worth of frustration getting tools
      to work. If even one LDP author is helped by this, then I did my
      job.</para>  
      -->
<para>
この文書の作成は、1999年8月26日、Mark F. Komarinski が文書作成ツールを動かす
のに 2 日もかかったことにイラついたのがきっかけでした。この文書がたとえ一人でも 
LDP 著者の役に立ったとしたら、わたしの務めは果たされます。
</para>      
      <!--<para>
        The newest version of this document can be found at the LDP
        homepage
        <ulink url="http://www.linuxdoc.org/">http://www.linuxdoc.org</ulink>.
        The original DocBook SGML, HTML, and other formats can be found there.
      </para>-->
<para>
この文書の最新バージョンは、LDP のホームページ <ulink 
url="http://www.linuxdoc.org/">http://www.linuxdoc.org</ulink> にあります。
オリジナルの DocBook SGML フォーマットや、その他 HTML 等のフォーマットも
そこにあります。
</para>
      <!--
      <para>There are many ways to contribute to the Linux movement
      without actually writing code.  One of the most important is
      writing documentation, allowing each person to share their
      knowledge with thousands of others around the world.  This Guide
      is designed to help you get familiar with how the LDP works, and
      what tools you'll need to write your own HOWTO.</para>
      -->
<para>
実際にコードを書かずとも、Linux ムーブメントに貢献する方法はたくさんあります。
重要なもののひとつが、文書を書くことです。それによって個々人が世界中の無数の
人々と知識を共有することができます。この文書は、読者に LDP の活動内容を理解し
てもらい、自分で HOWTO を書く際に必要なツールについて知ってもらうために作成され
ています。
</para>
    </section> 

    <section id="aboutldp">
      <title><!--About the LDP-->LDP について</title>
      <blockquote>
        <!--
        <attribution>LDP Manifesto located at <ulink
        url="http://www.linuxdoc.org/manifesto.html">
        http://www.linuxdoc.org/manifesto.html</ulink></attribution>
        -->
<attribution>LDP マニフェスト: <ulink 
url="http://www.linuxdoc.org/manifesto.html">
http://www.linuxdoc.org/manifesto.html</ulink>
</attribution>
        <!--
        <para>The Linux Documentation Project (LDP) is working on
        developing free, high-quality documentation for the GNU/Linux
        operating system. The overall goal of the LDP is to
        collaborate in all of the issues of Linux documentation. This
        includes the creation of "HOWTOs" and "Guides". We hope to
        establish a system of documentation for Linux that will be
        easy to use and search. This includes the integration of the
        manual pages, info docs, HOWTOs, and other documents.</para>
        -->
<para>
Linux Documentation Project は、GNU / Linux オペレーティングシステムについて
の良質でフリーな文書を開発するために活動しています。LDP の最大の
目的は、Linux に関するすべての事柄の文書化を、共同で押し進めることです。
HOWTO や Guide の作成はこれにあたります。さらにわれわれは、簡単に利用と検索
ができる文書システムを構築したいと考えています。man ページや 
info 文書、HOWTO その他の統合はこれにあたります。</para>
      </blockquote>
      <!--<para>
        The human readable version goes more like this:  The LDP consists
        of a large group of volunteers that are working on documentation
        for the Linux OS.  The most visible documentation are the HOWTOs
        located at <ulink url="http://www.linuxdoc.org/">
        http://www.linuxdoc.org/"</ulink>.
        This Guide focues primarily on how to write your own HOWTOs for
        submission to the LDP.
       </para>-->
<para>この後にはだいたい次のようなことが書いてあります。
「LDP ではボランティアが大勢集まって Linux OS 用の文書を作っている。一番目立つ
のが HOWTO で、HOWTO は <ulink url="http://www.linuxdoc.org/">
http://www.linuxdoc.org/</ulink> にある。」
この文書 (LDP Author Guide) の主な目的は、自分で HOWTO を書いて LDP に
寄稿する方法を説明することです。</para>
    </section>

    <section id="feedback">
      <title><!--Feedback-->フィードバック</title>
      <!--
      <para>Comments on this Guide may be directed to the author
      (<email>markk@linuxdoc.org</email>).</para> 
      -->
<para>この文書へのコメントは、著者 (<email>markk@linuxdoc.org</email>) まで
お願いします。</para>
    </section>

    <section id="copyrights">
      <title><!--Copyrights and Trademarks-->著作権と商標</title>
      <para>Copyright 1999-2000 Mark F. Komarinski, David C. Merrill, 
       Jorge Godoy</para>
      <!--
      <para>This manual may be reproduced in whole or in part, without
      fee, subject to the following restrictions:</para>
      -->
<para>この文書は、以下の条件を守る限り、全部あるいは一部を無料で複製
できます。</para>
      <itemizedlist>
        <listitem>
          <!--
          <para>The copyright notice above and this permission notice
          must be preserved complete on all complete or partial copies</para>
          -->
<para>全体もしくは部分を複製する場合、上記著作権表示とこの利用条件とが、
それらの複製上に完全な型で保持されること。</para>
        </listitem>
        <listitem>
          <!--
          <para>Any translation or derived work must be approved by
          the author in writing before distribution.</para>
          -->
<para>翻訳もしくは二次的著作物を作成した場合、配布に先立ち、著者に連絡して
承認を得ること。</para>
        </listitem>
        <listitem>
          <!--
          <para>If you distribute this work in part, instructions for
          obtaining the complete version of this manual must be
          included, and a means for obtaining a complete version
          provided.</para>
          -->
<para>この文書の一部のみを配布する場合、その配布物には、文書全体の入手が可能
であることを明記し、文書全体の入手方法を表示すること。</para>
        </listitem>
        <listitem>
          <!--
          <para>Small portions may be reproduced as illustrations for
          reviews or quotes in other works without this permission
          notice if proper citation is given. Exceptions to these
          rules may be granted for academic purposes: Write to the
          author and ask. These restrictions are here to protect us as
          authors, not to restrict you as learners and educators. Any
          source code (aside from the SGML this document was written
          in) in this document is placed under the GNU General Public
          License, available via anonymous FTP from the GNU
          archive.</para>
          -->
<para>この文書の僅かな部分を、批評や説明の材料として他の著作物に転載する際
は、その引用が正当なものである場合に限り、この利用条件の記載を省略できる。
学術目的での利用については、この利用条件の適用例外となる場合があるので、
著者まで連絡して尋ねること。これらの制限は、著者としてのわれわれの権利を
守るためのものであって、教育者や学習者に制限を課すことを意図していない。
(この文書の作成フォーマットである SGML コードを除いた) この文書内のすべての
ソースコードには、GNU General Public License が適用される。左記ライセンスは、
匿名 FTP 経由で、GNU アーカイブから入手可能である。</para>



        </listitem>
      </itemizedlist>

        <section>
        <title>日本語訳について</title>
        <para><acronym>JF</acronym> Project <sgmltag class="starttag">JF@linux.or.jp</sgmltag></para>
        <para>翻訳 千旦裕司 <sgmltag class="starttag">ysenda@pop01.odn.ne.jp
         </sgmltag></para>
        <para>校正 境真太郎 <sgmltag class="starttag">s_sakai@mxn.mesh.ne.jp
         </sgmltag></para>
        <para>この日本語訳も、上記に従って配布してください。</para>
        </section>

    </section>

    <section id="acknowledgements">
      <title><!--Acknowledgments and Thanks-->謝辞</title>
      <!--
      <para>Thanks to everyone that gave comments as I was writing
      this. This includes David Lawyer, Deb Richardson, Daniel Barlow,
      Greg Ferguson, Mark Craig and other members of the
      <email>ldp-discuss@lists.linuxdoc.org</EMAIL> list. Some
      sections I got from the <ulink
      url="http://www.linuxdoc.org/HOWTO/">HOWTO Index</ulink> and the
      sgmltools documentation. The sections on network access to CVS
      was partially written by Serek
      (<email>ser@serek.arch.pwr.wroc.pl</email>). Sections on DocBook
      were written by Jorge Godoy
      (<email>godoy@conectiva.com</email>). A great deal of thanks
      to both of them for their help.</para> 
      -->
<para>この文書の作成にあたり、コメントをいただいたすべての人々、
David Lawyer, Deb Richardson, Daniel Barlow, Greg Ferguson, Mark Craig, その
他の <email>ldp-discuss@lists.linuxdoc.org</email> メーリングリストの
メンバーに感謝します。<ulink url="http://www.linuxdoc.org/HOWTO/">
HOWTO Index</ulink> と sgmltools の文書からは、いくつかのセクションを抜粋
させていただきました。CVS へのネットワークアクセスに関するセクションの一部
は、Serek (<email>ser@serek.arch.pwr.wror.pl</email>)が書いています。
DocBook に関するセクションは、Jorge Godoy (<email>godoy@conectiva.com</email>) 
が書きました。二人の協力に大変感謝しています。</para>
    </section>

  &conventions;

  </chapter>
  <chapter id="introduction">
    <title><!--Introduction to the LDP and SGML-->LDP と SGML の紹介</title>

    <section id="theldp">
      <title><!--The LDP-->LDP</title>
      <!--
      <para>The Linux Documentation Project (LDP) was started to
      provide new users a way of getting information quickly about a
      particular subject. It not only contains a series of books on
      administration, networking, and programming, but has a large
      number of smaller works on individual subjects, written by those
      who have used it. If you want to find out about printing, you
      get the <ulink
      url="http://www.linuxdoc.org/HOWTO/Printing-HOWTO.html">Printing
      HOWTO</ulink>. If you want to do find out if your Ethernet card
      works with Linux, grab the <ulink
      url="http://www.linuxdoc.org/HOWTO/Ethernet-HOWTO.html">Ethernet
      HOWTO</ulink>, and so on. At first, many of these works were in
      text or HTML. As time went on, there had to be a better way of
      managing these documents. One that would let you read it from a
      web page, a text file on a CD-ROM, or even your hand-held
      PDA. The answer, as it turns out, is SGML.</para>
      -->
<para>Linux Documentation Project (LDP) がスタートしたのは、初心者が、特定の
対象についての情報をすばやく見つけることができるようにするためでした。LDP に
は、システム管理やネットワーク、プログラミングについての一連の文書だけで
なく、個別の分野を対象として、それを使ったことがある人が書いたもっと細かい
事柄に関する文書も無数にあります。印刷について知りたいなら、<ulink 
url="http://www.linuxdoc.org/HOWTO/Printing-HOWTO.html">Printing-HOWTO
</ulink>, (<ulink url="http://www.linux.or.jp/JF/JFdocs/Printing-HOWTO.html">
日本語訳</ulink>) がありますし、手持ちのイーサネットカードが Linux で使えるか
知りたいときは、<ulink 
url="http://www.linuxdoc.org/HOWTO/Ethernet-HOWTO.html">Ethernet HOWTO
</ulink>, (<ulink url="http://www.linux.or.jp/JF/JFdocs/Ethernet-HOWTO.html">
日本語訳</ulink>) を見ればだいたい分かります。はじめの頃、こうした文書は、
テキストか HTML で書かれていましたが、そのうち、文書をもっと上手に管理する必要
が生じてきました。たとえば、
ウェブページ上で閲覧したり、CD-ROM 上からや、さらにはハンド・ヘルドの PDA 上
でテキストファイルとして読めるようにしたいといったことです。最終的に、この問題
を解決したのが、SGML でした。</para>
    </section>

    <section id="sgml">
      <title>SGML</title>
      <!--
      <para>The Standard Generalized Markup Language (SGML) is a
      language that is based on embedding codes within a document. In
      this way, it is similar to HTML, but there is where any
      similarities end. The power of SGML is that unlike WYSIWYG (What
      You See Is What You Get), you don't define things like colors,
      or font sizes, or even some kinds of formatting. Instead, you
      define elements (paragraph, section, numbered list) and let the
      SGML processor and the end program worry about placement,
      colors, fonts, and so on. HTML does the same thing, and is
      actually a subset of SGML. SGML has really three parts that make
      it up. First is the Structure, which is what is commonly called
      the DTD, or Document Type Definition. The DTD defines the
      relationship between each of the elements (or tags). The DocBook
      DTD, used to create this document, is an example of this. The
      DTD lists the rules that the content must follow. Second is the
      DSSSL or Document Style Semantics and Specification Language.
      The DSSSL tells the program doing the rendering how to convert
      the SGML into something that a human can read.  It tells the
      renderer to convert a &lt;title&gt; tag into 14 point bold if it
      is going to RTF format, or to turn it into a &lt;h1&gt; tag if
      you're going to HTML. Finally there is the Content, which is
      what gets rendered by the SGML processor and is eventually seen
      by the user. This paragraph is content, but so would a graphic
      image, table, numbered list, and so on. Content is surrounded by
      tags to separate out each element.</para>
      -->
<para>SGML (Standard General Markup Language) は、文書内にコードを埋め込む
ことで成り立っている言語です。その意味では、HTML と類似していますが、類似点は
それだけです。SGML のパワーは、WYSIWYG (What You See Is What You Get) 
と違って、色やフォントサイズやある種の形式などを定義するわけではないという
ところにあります。その代わり、(パラグラフやセクション、番号付きリストなどの) 
エレメント(element)を定義しておいて、SGML 処理系や後処理用プログラムに
版組や色、フォントなどを任せてしまいます。HTML でも同じことをしていますが、
HTML は実際のところ SGML のサブセットです。</para>
<para>SGML は、文書の生成のために、
本質的に 3 つの部分から成り立っています。1 つ目は、構造 (Structure) で、
これは、
通常、DTD とか文書型定義 (Document Type Definition) とよばれています。
DTD では、個々のエレメント (element) (もしくはタグ(tag)) の関係が定義されて
います。この文書を書くのに使っている DocBook はそのひとつです。DTD は、文書の
内容
であるコンテント (content) が従うべきルールの箇条書きです。2 つ目は、DSSSL 
もしくは、Document Style Semantics and Specification Language です。DSSSL は、
文書をレンダリングするプログラムに対して、SGML を人間が読める形式にする際の
やり方を指示します。たとえば、RTF フォーマットにしたい場合は、&lt;title&gt; 
タグを 14 ポイントのボールド体にするようレンダリングプログラムに指示し、
HTML にする
場合には、それを &lt;h1&gt; に変換するように指示します。最後に、文書の内容 
であるコンテント (Content) があり、これは SGML 処理系によってレンダリングされ
る対象物であり、最終的にユーザが目にする部分です。たとえば、このパラグラフは、
もちろんコンテントですが、画像や表、番号付きリストなんかもコンテントです。
コンテントは、タグ (tag) で囲まれて、個別のエレメントとして区別されます。
</para>
    </section>

    <section id="whysgml">
      <title><!--Why SGML instead of HTML or other formats?-->
       なぜ HTML でなく、SGML なのか？</title>
      <!--
      <para>SGML provides for more than just formatting. You can
      automatically build indexes, table of contents, and links within
      the document or to outside. The Jade and OpenJade packages also
      let you export (I'll call it render from here on) SGML to LaTeX,
      info, text, HTML, and RTF. From these basic formats, you can
      then create other formats such as MS Word, PostScript, PDF and
      so on. Programs like LyX allow you to write in TeX format, then
      export it as SGML and render from SGML to whatever you chose. In
      the end, SGML is more concerned about the way elements work
      instead of the way they look. A big distinction,and one that
      will let you write faster, since you don't have to worry about
      placement of paragraphs, font sizes, font types, and so
      on.</para>
      -->
<para>SGML は、文書のフォーマットを変換するだけではありません。索引や目次、
文書の内外へのリンクも自動的に生成できます。Jade や OpenJade パッケージ 
(以後は、レンダラーと呼びます) を使えば、SGML を LaTeX や info、テキスト、
HTML、RTF にも変換できます。こうした基本フォーマットから、MS Word や 
PostScript,
PDF などのフォーマットの文書を作ることもできますし、LyX のようなプログラムを
使えば、TeX フォーマットで文書を書いて、その後で SGML に変換し、SGML から
好きなフォーマットにレンダリングできます。つまり、SGML は、文書の見た目には
関心がなく、もっぱらエレメントの機能に注目しています。この点から生じる大きな
違いは、パラグラフの位置やフォントサイズ、フォントタイプなどで悩まなくても
いいので、文書を書くスピードが上がるということです。</para>
    </section>

    <section id="sgmlisnotxml">
      <title><!--SGML is not XML-->SGML は XML じゃない</title>
      <!--
      <para>There has been a lot of press recently about XML, and DocBook
      support for XML.  DocBook is a collection of markup tags that follow
      a specified hierarchy.
      XML DocBook v4.1.2 is now officially supported by the LDP.  If you're
      familiar with SGML and want to convert to XML, please keep the following
      in mind (list borrowed from DocBook:  The Definitive Guide):
      </para>
      -->
<para>最近は XML を使いたいという要望が多いので、DocBook では XML がサポート
されています。DocBook は、一定の階層構造を持ったマークアップタグの集まりです。
XML DocBook v4.1.2 は、現在 LDP で正式にサポートされています。SGML については
既に知っていて、XML を使いたい場合は、次のことに注意してください。
(以下は、「DocBook: The Definitive Guide」から拝借しました。)</para>
      <itemizedlist>
        <listitem>
          <!--
          <para>All XML markup is case sensitive.  All element, attribute,
          and entity names have to be in lowercase.  SGML is not case
          sensitive.
          </para>
          -->
<para>すべての XML マークアップは、大文字小文字を区別する。あらゆるエレメント
名、アトリビュート名、エンティティ名は、小文字でなければならない。
この点で、SGML とは異なる。</para>
        </listitem>
        <listitem>
          <!--
          <para>
            All attributes have to be quotes using either straight (') or
            double (") quotes.
          </para>
          -->
<para>すべてのアトリビュートは、シングルクオート (') か、ダブルクオート (") で
囲まれなければならない。</para>
        </listitem>
        <listitem>
          <!--
          <para>
            Empty elements (like xref) have to end with a /: &lt;xref/&gt;.
          </para>
          -->
<para>空エレメント (たとえば、xref) は、/: &lt;xref/&gt; で終了しなければ
ならない。</para>
        </listitem>
        <listitem>
          <!--
          <para>
            Tag minimizations (&lt;/&gt;) are not supported.  The LDP
            discourages their use in SGML as well.
          </para>
          -->
<para>タグの短縮 (&lt;/&gt;) はサポートしない。これは LDP においても、
SGML 内で使用することは推奨されていない。</para>
        </listitem>
      </itemizedlist>
    </section>

    <section id="newauthors">
      <title><!--For New Authors-->初めて寄稿する方へ</title>
      <!--
      <para>If you are a new to the LDP and want to pick up an
      unmaintained HOWTO or write a new HOWTO document, contact the
      HOWTO coordinator at
      <email>discuss@linuxdoc.org</email>. This is to make
      sure the HOWTO coordinator can know who is working on what
      documentation.</para>
      -->
<para>もし、LDP は初めてで、更新されていない HOWTO の管理をしたり、新規に 
HOWTO を書いたりしようと思った場合は、<email>discuss@linuxdoc.org
</email> の HOWTO コーディネータに連絡してください。これは、誰がどの文書を
担当しているのか HOWTO コーディネータに分かるようにするためです。</para>
      <!--
      <para>Once that part is complete, you may write your
      documentation in the format of your choice and submit a draft to
      <email>submit@linuxdoc.org</email> and the draft will
      be reviewed by an LDP volunteer. In a few short days you will
      get the draft and comments from the volunteer.  After applying
      the comments, you may send this version to the ldp-submit list
      again for final submission into the LDP.</para> 
      -->
<para>これが終わると、好きなフォーマットで文書を書いて、そのドラフトを 
<email>submit@linuxdoc.org</email> に送っていただきます。
LDP のボランティアがそれを校正して、数日中にボランティアから草稿とコメントが
返ってきますので、それらのコメントを文書に反映させて、今度は LDP への最終稿
として再度 ldp-submit メーリングリストに新バージョンを投稿します。</para>
      <!--
      <para>At this point, another LDP volunteer will translate your
      document into DocBook and send you the finished DocBook
      document.  From here on, all submissions to the LDP has to be in
      DocBook format.  If you have markup questions, you may ask the
      volunteer who assisted you, or ask the LDP DocBook list.</para>
      -->
<para>この時点で、別のボランティアが投稿された文書を DocBook 形式に変換
して、完成された DocBook 文書として手元に送られてきます。ここから先、LDP への
投稿はすべて DocBook 形式になります。マークアップについて疑問があれば、変換を
担当したボランティアに聞くか、LDP DocBook メーリングリストで質問してください。
</para>
      <!--
      <para>If you choose to start your document off in DocBook, there
      are plenty of templates to get you started:</para>
      -->
<para>はじめから DocBook 形式で書き始める場合は、参考になるテンプレートが
たくさんあります。</para>
      <itemizedlist>
        <listitem><para>
          <ulink 
          url="http://www.linuxdoc.org/authors/template-ld/big-howto-template-ld.sgml">
          http://www.linuxdoc.org/authors/template-ld/big-howto-template-ld.sgml</ulink> - 
          <!--This template is written by Stein Gojen
          and is based off the LinuxDoc template.</para>-->
Stein Gojen が書いたこのテンプレートは、LinuxDoc 形式で書くときのものです。
</para>
        </listitem>
        <listitem><para><ulink 
          url="http://www.linuxdoc.org/authors/template/big-howto-template.sgml">
          http://www.linuxdoc.org/authors/template/big-howto-template.sgml</ulink> - 
      <!--This template is based on Stein's work, but is much larger
      and complicated than the above.  It uses more features of DocBook.</para>
      -->
このテンプレートも Stein が作ったものですが、上記よりもずっと大きくて
複雑になっています。これは、DocBook の豊富な機能を活用したものです。</para>
        </listitem>
      </itemizedlist>
    </section>

    <section id="mailinglists">
      <title><!--Mailing Lists-->メーリングリスト</title>
      <!--
      <para>There are a few mailing lists to subscribe to so you can
      take part in how the LDP works. First is
      <email>discuss@linuxdoc.org</email>, which is the main
      discussion group of the LDP. To subscribe, send a message with
      the subject reading &quot;subscribe&quot; to
      <email>discuss-subscribe@linuxdoc.org</email>. To
      unsubscribe, send an e-mail with the subject of
      &quot;unsubscribe&quot; to
      <email>discuss-unsubscribe@linuxdoc.org</email>.</para>
      -->
<para>メーリングリストがいくつかあるので、登録すれば LDP の活動に参加できます。
まず、<email>discuss@linuxdoc.org</email> は、LDP の中心的な
メーリングリストで、登録するには、subject 欄に &quot;subscribe&quot; と
書いたメールを <email>discuss-subscribe@linuxdoc.org</email> に
お送りください。登録を取り消す場合は、subject 欄に &quot;unsubscribe&quot; と
書いたメールを <email>discuss-unsubscribe@linuxdoc.org</email> まで
送ってください。</para>
      <!--
      <para>Another list is the
      <email>docbook@linuxdoc.org</email> list, which is for
      markup or other questions about DocBook itself.  If you run into
      trouble with a particular markup tag, you can send your question
      here for answers.  You can subscribe to the DocBook list by
      sending a "subscribe"message to
      <email>docbook-subscribe@linuxdoc.org</email>.</para>
      -->
<para>他にも、<email>docbook@linuxdoc.org</email> メーリング
リストは、マークアップや、DocBook 自体に関する質問をするところです。特定の
マークアップタグで困ったときは、ここに質問を送って返事を待ってください。
DocBook 
メーリングリストに登録するには、"subscribe" と書いたメールを <email>
docbook-subscribe@linuxdoc.org</email> にお送りください。</para>
    </section>
  </chapter>


  <chapter id="tools">
    <title><!--The tools-->文書作成ツール</title>
    <!--
    <para>In this section, we will cover some of the tools that you'll
    need or want to use to create your own LDP documentation. I'll
    describe them here, and better define them later on, along with
    how to install them. If you use some other tool to assist in
    writing LDP, please let me know and I'll add a blurb here for
    it.</para>
    -->
<para>このセクションでは、LDP 文書を作成するのに必要なツールや便利なツール
をいくつか紹介します。ここでは、インストール方法とツールの概要を説明して、
詳しい使い方は後で解説することにします。もしあなたがここにあるもの以外のツール
を使って LDP 文書をお書きの場合、このセクションで宣伝しますので、是非その
ツールをお知らせください。
</para>
    <section id="dsssl">
      <title>DSSSL</title>
      <!--
      <para>The Normal Walsh version is required, the LDP is
      optional.</para> 
      -->
<para>通常の Walsh バージョンの DSSSL が必要で、そのオプションとして LDP の 
DSSSL があります。</para>

      <section id="nwdsssl">
        <title>Norman Walsh DSSSL</title>
        <para><ulink
        url="http://nwalsh.com/docbook/dsssl/">
        http://nwalsh.com/docbook/dsssl/</ulink></para> 
        <!--
        <para>The Document Style Semantics and Specification Language
        tells jade how to render a SGML document into print or online
        form. The DSSSL is what converts a title tag into an
        &lt;H1&gt; tag in HTML, or bold, 14 point Times Roman for RTF,
        for example. Documentation for DSSSL is located at the same
        site. Note that modifying the DSSSL doesn't modify DocBook
        itself. It merely changes the way the rendered text looks. The
        LDP uses a modified DSSSL (see below).</para>
        -->
<para>DSSSL (Document Style Semantics and Specification Language) は、
どういう方法で SGML 文書を印刷やオンライン用の文書にするかを jade に
指示するものです。たとえば、DSSSL に従って、title タグが、HTML では 
&lt;H1&gt; タグに変換され、RTF では 14 ポイントの Times Roman ボールド体
に変換されます。DSSSL に関する文書も上記にあります。DSSSL を修正することは、
DocBook 自体を修正することにはならない点に注意してください。レンダリングされた
テキストの見栄えを変えているにすぎません。LDP では、次の修正された DSSSL を
使っています。</para>
      </section>
      

      <section id="ldpdsssl">
        <title>LDP DSSSL</title>
        <para><ulink
        url="http://www.linuxdoc.org/authors/tools/ldp.dsl">
        http://www.linuxdoc.org/authors/tools/ldp.dsl</ulink></para>
        <!--
        <para>The LDP DSSSL requires the Norman Walsh version (see
        above) but is a slightly modified DSSSL to provide things like
        a table of contents.</para>
        -->
<para>LDP DSSSL は、(上記の) Norman Walsh バージョンの DSSSL があることを前提
にして、目次などを生成するために若干の変更を加えたものです。</para>
      </section>
    </section>
    
    <section id="dtd">
      <title>DocBook DTD (version 4.1 <!--or-->か 3.1)</title>
      <para><!--Required - -->必要なのは、<ulink
      url="http://www.oasis-open.org/docbook/sgml/4.1/docbk41.zip">
      http://www.oasis-open.org/docbook/sgml/4.1/docbk41.zip</ulink> 
      <!--or-->か、 
      <ulink url="http://www.oasis-open.org/docbook/sgml/3.1/docbk31.zip">
      http://www.oasis-open.org/docbook/sgml/3.1/docbk31.zip</ulink>。</para> 
      <para><!--The XML DTD is available from -->
      XML DTD を使う場合は、
      <ulink url="http://www.oasis-open.org/docbook/xml/4.1.2">
      http://www.oasis-open.org/xml/4.1.2/</ulink><!--.--> です。
      </para>
      <!--
      <para>The DocBook DTD defines the tags and structure of a
      DocBook SGML document. Modifying the DTD, such as adding a new
      tag, doesn't make it DocBook anymore.</para>
      -->
<para>DocBook DTD は、DocBook SGML 文書のタグと文書構造とを定義しています。
それゆえ、新規タグを加えたりして DTD を修正すると、DocBook ではなくなって
しまいます。
</para>
    </section>

    <section id="jade">
      <title>Jade</title>
      <!--
      <para>Jade and OpenJade are two of the programs that do most of
      the rendering and validation of code based off the DTD and
      DSSSL. One of the following is required and should be installed
      after the DTD and DSSSL have been installed.</para>
      -->
<para>Jade と OpenJade は、ふたつとも、DTD と DSSSL に基づいてコードの
レンダリングや妥当性検査の大半を処理するプログラムです。どちらかが必要なので、
DTD と DSSSL のインストールが終わってから、インストールしてください。 </para>

      <section>
        <title>Jade</title>
        <para><ulink
        url="ftp://ftp.jclark.com/pub/jade/jade-1.2.1.tar.gz">
        ftp://ftp.jclark.com/pub/jade/jade-1.2.1.tar.gz</ulink></para> 
        <!--
        <para>Jade is the front-end processor for SGML. It uses the
        DSSSL and DocBook DTD to perform the verification and
        rendering from SGML into the target format.</para>
        -->
<para>Jade は、SGML のフロント・エンドプロセッサです。DocBook と DSSSL を
使って、妥当性検査や、目的のフォーマットへの SGML ソースのレンダリングを行い
ます。
</para>
        <section id="usingjade">
          <title><!--Using Jade-->Jade を使う</title>
            <!--
            <para>This is the quick and dirty way that should work for all
            distributions, no matter what distribution you're
            using. </para> 
            -->
<para>ここでは、使っているディストリビューションを問わず、どの
ディストリビューションでも、とにかくすぐに使えるようにする方法を紹介します。
</para>
            <orderedlist inheritnum="ignore" continuation="restarts">
            <listitem>
              <!--
              <para>Create a base directory to store everything such as
              <filename moreinfo="none"
              class="directory">/usr/local/sgml/</filename>. We'll call
              this <envar>$_toolroot</envar> from here on.</para>
              -->
<para>いろんなファイルを入れるために、<filename moreinfo="none" 
class="directory">/usr/local/sgml/</filename> といったベース・ディレクトリを
作成します。以下では、そのディレクトリを <envar>$_toolroot</envar> 
と呼びます。</para>
            </listitem>
            <listitem>
              <!--
              <para>Install Jade, DocBook DTD, and DSSSL such that the
              base of each is under <envar>$_toolroot</envar>, creating:
              </para>
              -->
<para>Jade, DocBook DTD, DSSSL を、<envar>$_toolroot</envar> がそれぞれの
ベースディレクトリになるよう、次のようなディレクトリを作成して、インストール
します。</para>
              <itemizedlist>
                <listitem>
                  <para><filename class="directory">$_toolroot/jade-1.2.1
                   </filename>
                  </para>
                </listitem>
                <listitem>
                  <para><filename class="directory">$_toolroot/dtd</filename>
                  </para>
                </listitem>
                <listitem>
                  <para><filename class="directory">$_toolroot/dsssl</filename>
                  </para>
                </listitem>
              </itemizedlist>
            </listitem>
            <listitem>
              <!--
              <para>You'll need to set the
              <envar>SGML_CATALOG_FILES</envar> environment variable to
              the catalogs that you have under<filename moreinfo="none"
              class="directory">$_toolroot</filename>. You can do this
              with the command: 
              -->
<para>環境変数 <envar>SGML_CATALOG_FILES</envar> に <filename moreinfo="none" 
class="directory">$_toolroot</filename> にあるカタログファイル名を設定する
必要があります。それには次のコマンドを使ってください。

              <screen format="linespecific">
<prompt moreinfo="none">bash$</prompt> <command moreinfo="none">
export SGML_CATALOG_FILES=$_toolroot/dtd/docbook.cat:\
$_toolroot/dsssl/docbook/catalog:$_toolroot/jade-1.2.1/dsssl/catalog</command>
              </screen>
              </para>
            </listitem>
            <listitem>
              <!--
              <para>Now you can start using Jade. To create individual
              HTML files: </para>
              -->
<para>これで Jade を使う準備ができました。セクション別の HTML ファイルを作成
するには、次のコマンドを使います。</para>
              <screen format="linespecific">
<command moreinfo="none">$_toolroot/jade-1.2.1/jade/jade -t sgml -i html \
-d $_toolroot/dsssl/docbook/html/docbook.dsl howto.sgml</command>
              </screen>
            </listitem>
            <listitem>
              <!--
              <para>To create one large HTML file, add <emphasis>-V
              nochunks</emphasis> to the jade command.</para>
              -->
<para>一枚の HTML ファイルにまとめるには、上記の Jade コマンドに <emphasis>
-V nochunks</emphasis> を付けてください。</para>

            </listitem>
          </orderedlist>
        </section>
        <section id="jadexml">
          <title><!--Jade in XML mode-->XML モードの Jade</title>
          <!--
          <para>Once configured for XML, jade and openjade will work
            the wame way as for SGML DocBook.
          </para>
          -->
<para>いったん XML 用の設定が済めば、Jade も OpenJade も SGML DocBook と
同じやり方で使えます。</para>

          <!--
          <para>
            After extracting the XML DTD, you may want to make
            a symlink from the docbook.cat file to "catalog", the
            default filename for jade/openjade catalogs.  Replace
            $_xml_root with the location of your XML DTD.
          </para>
          -->
<para>XML DTD を解凍したら、jade/openjade のカタログファイルのデフォルト
ファイル名として、docbook.cat ファイルから "catalog" にシンボリックリンクを
張ることもできます。次の $_xml_root の部分は、インストールした XML_DTD の場所に
置き換えてください。</para>
          <informalexample>
            <screen format="linespecific">
<prompt moreinfo="none">bash$</prompt> <command>cd $_xml_root</command>
<prompt moreinfo="none">bash$</prompt> <command>ln -s docbook.cat catalog
</command>
<prompt moreinfo="none">bash$</prompt> <command>
export SGML_CATALOG_FILES=$_xml_root/catalog:$_toolroot/dsssl/catalog:\
$_toolroot/dtd/docbook/catalog</command> <co id="export">
<prompt moreinfo="none">bash$</prompt> <command>
jade -t sgml -i html -d style $_jade_path/pubtext/xml.dcl foo.xml</command> <co id="jadexmlcmd">
            </screen>
            <calloutlist>
            <callout arearefs="export">
              <!--
              <para>
                You'll need the catalogs for XML, the DSSSL, and DocBook,
                respectively.  $_toolroot was defined above.
              </para>
              -->
<para>XML, DSSSL, DocBook それぞれのカタログファイルが必要です。
$_toolroot は、先ほどの例と同じです。</para>
            </callout>
            <callout arearefs="jadexmlcmd">
              <!--
              <para>
                Replace style with the style you wish to use.  The pointer
                to xml.dcl is requires for jade to work, and it has to be
                listed immediately before the pointer to your XML document.
              </para>
              -->
<para>スタイルファイルは、好みのスタイルファイルに置き換えてください。jade 
が動くには、xml.dcl へのポインタが必要で、これは、XML 文書名の直前に指定され
る必要があります。</para>
              <!--
              <para>
                You may get the following warnings when processing XML
                documents.  They don't impact the output, and the cause
                is being looked into.
              </para>
              -->
<para>XML 文書を処理中に次のような警告が表示されるかもしれません。これは出力
には影響しませんが、原因は調査中です。</para>
              <screen>
&lt;xml_dtd_pth&gt;/ent/iso-lat2.ent:119:18:E: "X0176" is not a function name
&lt;xml_dtd_pth&gt;/ent/iso-lat2.ent:120:17:E: "X0178" is not a function name
              </screen>
            </callout>
            </calloutlist>
          </informalexample>
          <!--
          <para>
            If you want to convert your existing SGML DocBook into
            XML docbook, use this as your declaration (the lines at the
            very start of your document).
          </para>
          -->
<para>既存の SGML DocBook 文書を XML 文書に変換したい場合は、(文書の冒頭の
行の)文書型宣言(declaration)のところで次のように書いてください。</para>
          <screen>
&lt;?xml version='1.0' encoding='ISO-8859-1'?&gt;
&lt;!DOCTYPE article PUBLIC '-//OASIS//DTD DocBook XML V4.1.2//EN'&gt;
          </screen>
          <!--
          <para>
            If you have followed LDP guidelines, there should be no
            other changes required to your document.
          </para>
          -->
<para>LDP の文書規則に従っている場合、これ以外に文書に変更を加える必要は
ありません。
</para>
        </section>
      </section>
      
      <section id="openjade">
        <title>OpenJade</title>
        <para><ulink
        url="http://openjade.sourceforge.net/">
        http://openjade.sourceforge.net/</ulink></para> 
        <!--
        <para>An extension of Jade written by the DSSSL
        community. Some applications require jade, but are being
        updated to support either software package.</para>
        -->
<para>DSSSL コミュニティーが作成した、Jade のエクステンションです。
アプリケーションのなかには jade を必要とするものもありますが、どちらも
サポートできるようにアップデートされつつあります。</para>
      </section>
    </section>

    <section id="jadewrappers">
      <title>Jade wrappers</title>
      <!--
      <para>These tools are optional and may be installed after Jade,
      the DSSSL, and DTD have been installed.</para> 
      -->
<para>オプションで以下のツールがあるので、Jade, DSSSL, DTD のインストール
後に、インストールできます。</para>

      <section id="sgmltools-lite">
        <title>sgmltools-lite</title>
        <para><ulink
        url="http://sgmltools-lite.sourceforge.net/">
        http://sgmltools-lite.sourceforge.net/</ulink></para> 
        <!--
        <para>This is the successor to the sgmltools project, which
        has officially been disbanded for over a year. Since then,
        Cees de Groot has created a slightly different project, which
        acts as a wrapper to the jade SGML processor. It hides much of
        the ugliness of syntax. This author was able to install the
        old sgmltools package followed by the sgmltools-lite and could
        format this document quite easily. There's even a man page for
        sgmltools showing syntax.</para>
        -->
<para>これは、一年以上前に正式に解散した sgmltools プロジェクトを引き継いだ
もので、それ以来、Cees de Groot が若干異なるプロジェクトを立ち上げて、
jade SGML 処理系へのラッパとしてツールを作っています。構文の汚さはかなり解消
されました。作者は、古い sgmltools パッケージをインストールして、そのあとに 
sgml-tools-lite を入れることで、この文書を非常に簡単にフォーマットできた
そうです。
構文を表示する sgmltools 用の man ページもあります。</para>
      </section>

      <section id="cygnus">
        <title>Cygnus DocBook Tools</title>
        <para><!--May be Red Hat specific-->Red Hat 専用ですが  - <ulink
        url="http://www.redhat.com/">http://www.redhat.com/</ulink></para>

        <!--
        <para>Red Hat distributes three packages, starting with the
        6.2 release, that include DocBook support and some tools. The
        tools are easily installed, allowing you to focus more on
        writing than wrestling with the tools. TeTex, Jade, and
        JadeTeX must be installed first.  All three of these packages
        are available on the installation CD.</para>
        -->
<para>Red Hat では、6.2 リリースから、DocBook をサポートするツールその他を
含めた 3 つのパッケージを配布しています。これらのツールは、簡単にインストールで
きるので、ツールと格闘しなくても執筆に専念できます。TeTeX, Jade, JadeTeX をあら
かじめインストールしておくことが必要です。パッケージは 3 つとも、インストール 
CD に入っています。</para>

        <section id="usingcygnus">
          <title><!--Using the Cygnus Tools-->Cygnus Tools の使い方</title>
          <!--
          <para> These tools are provided with Red Hat 6.2. Make sure
          the following packages are installed: </para>
          -->
<para>これらのツールは、Red Hat 6.2 に付属しています。まず、次のパッケージが
インストールされているか確認してください。</para>
          <itemizedlist>
            <listitem><para> sgml-common-0.1-8.noarch </para></listitem>
            <listitem><para> docbook-3.1-4.noarch </para></listitem>
            <listitem><para> stylesheets-1.54.13rh-1.noarch </para></listitem>
          </itemizedlist>
          <para> <!--Red Hat has the latest version on their web site:-->
                  最新バージョンは、Red Hat のウェブサイトにあります: 
          <ulink
        url="http://www.redhat.com/support/errata/RHBA-2000022-01.html">
     http://www.redhat.com/support/errata/RHBA-2000022-01.html</ulink>.</para> 

          <!--
          <para>Download/get/sneaker-net the RPMs to your machine and
          install in the usual manner (become root, then <command
          moreinfo="none">rpm -Uvh filename</command>). Once the RPMs
          are installed, you can use the following commands to render
          DocBook: </para> 
          -->
<para>RPM ファイルをマシンにダウンロードするか、どこかから取ってくるかして、
いつも通りインストールしてください。(root になって、<command moreinfo="none">
rpm -Uhv ファイル名</command>。) RPM がインストールされたら、次のコマンドを
使って DocBook をレンダリングできます。</para>
          <screen>
<prompt>bash$</prompt> <command>db2html</command> <option>filename</option> 
</screen>
          <!--
          <para> Renders DocBook into HTML. A subdirectory with the
          filename (minus the .sgml extension) is created and the HTML
          files are placed there. </para> 
          -->
<para>DocBook を HTML にレンダリングします。( .sgml 拡張子を除いた)ファイル名
と同じ名前でサブディレクトリが作成され、そこに HTML ファイルが置かれます。
</para>
          <screen>
<prompt>bash$</prompt> <command>db2pdf</command> <option>filename</option>
</screen>
          <!--
          <para>Renders DocBook into a PDF file. Note that there is currently a
 	  problem with db2pdf, and pd2ps caused by JadeTeX.  This has been
          <ULINK 
          URL="http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=9670">
          registered as a bug with RedHat</ulink>.</para>
          -->
<para>DocBook を PDF ファイルにレンダリングします。JadeTeX を使った db2pdf と 
pd2ps で、現在問題が生じているのに注意してください。これは、Red Hat にバグと
して
<ulink url="http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=9670">
登録</ulink>されています。</para>
        </section>
      </section>
    </section>

    <section id="editing">
      <title><!--Editing tools-->編集ツール</title>
      <!--
      <para>The following tools may be used to create, edit, or
      validate your HOWTO.</para>
      -->
<para>以下では、HOWTO の作成や編集、妥当性検査に使えるツールを紹介します。
</para>

      <section id="psgml">
        <title>Emacs (PSGML)</title>
        <para><!--Optional-->オプションです。 - <ulink
        url="http://www.lysator.liu.se/~lenst/about_psgml/">
        http://www.lysator.liu.se/~lenst/about_psgml/</ulink></para>
        <!--
        <para>Emacs has an SGML writing mode called psgml that is a
        major mode designed for editing SGML and XML documents. It
        provides <quote>syntax highlighting</quote> or <quote>pretty
        printing</quote> features that make SGML tags stand out, a way
        to insert tags other than typing them by hand, and the ability
        to validate your document while writing.</para> 
        -->
<para>Emacs には、SGML や XML 文書の編集のために作られたメジャーモードとして、
SGML 文書作成用の psgml と呼ばれるモードがあります。これによる <quote>構文強調
(syntax highlighting)</quote> や <quote>きれいな表示 (pretty printing)</quote> 
機能を使うと、SGML タグが強調されたり、手でタイプしなくてもタグを入れることが
できたり、書きながら妥当性検査ができたりします。</para>

        <!--
        <para>For users of Emacs, it's a great way to go, and many
        believe it to allow more versatility than any other SGML
        documentation tool. It works with DocBook,LinuxDoc and other
        DTDs equally well.</para>
        -->
<para>Emacs ユーザにはうれしい機能ですし、他のどんな SGML 編集ツールよりも充実
した機能を備えていると、多くのユーザは思っています。DocBook や LinuxDoc、その他
の DTD でも使えます。</para>
    <section>
      <title> <!--Writing SGML using PSGML-->
              PSGML を使って SGML を書く方法 </title>

      <section><title> <!--Introduction-->はじめに </title>
        <!--
        <para> If you have installed a recent distribution, you may
        already have PSGML installed for use with Emacs. To check,
        start Emacs and look for the PSGML documentation (<keycombo
        moreinfo="none"><keycap moreinfo="none">C</keycap><keycap
        moreinfo="none">h</keycap></keycombo><keycap
        moreinfo="none">i</keycap><keycap
        moreinfo="none">m</keycap><keycap
        moreinfo="none">psgml</keycap>).</para> 
        -->
<para>最近のディストリビューションをインストールしているなら、Emacs で 
使えるように既に PSGML がインストールされていると思います。確認のために、
Emacs を起動して、PSGML 文書を捜してみましょう。(<keycombo
        moreinfo="none"><keycap moreinfo="none">C</keycap><keycap
        moreinfo="none">h</keycap></keycombo><keycap
        moreinfo="none">i</keycap><keycap
        moreinfo="none">m</keycap><keycap
        moreinfo="none">psgml</keycap>)</para>

        <!--
        <para> From here on, we assume you have PSGML installed for
        use with a recent version of GNU Emacs. If that all went by
        too fast for you, see the free chapter from Bob Ducharme's
        SGML CD book: <ulink
        url="http://www.snee.com/bob/sgmlfree/">
        http://www.snee.com/bob/sgmlfree/</ulink>.</para>
        -->
<para>ここからは、比較的新しいバージョンの Emacs に PSGML がインストール
されて使えるように
なっているのを前提にします。話が早く進みすぎると思う方は、Bob Ducharme の
SGML CD book のフリーで公開されている次の章をご覧ください。
<ulink url="http://www.snee.com/bob/sgmlfree/">
http://www.snee.com/bob/sgmlfree/</ulink></para>
      </section>

      <section>
        <title> <!--Updating your .emacs to use PSGML-->
                .emacs をアップデートして PSGML を使う方法 </title>
        <!--
        <para> If you want GNU Emacs to enter PSGML mode when you open
        a <emphasis>.sgml</emphasis> file and be ready for SGML
        editing, make sure PSGML can find the DocBook DTD. If your
        distribution already had PSGML set up for use with GNU Emacs,
        you probably do not have to do anything to get this to
        work. Otherwise, you may need to set an environment variable
        that tells PSGML where to look for the SGML catalog (the list
        of DTDs). </para> 
        -->
<para><emphasis>.sgml</emphasis> ファイルを開いたときに GNU Emacs が PSGML 
モードに入って、SGML を編集できる準備が整うようにしたい場合は、PSGML が 
DocBook DTD を見つけられるようにしなければなりません。
GNU Emacs で PSGML が使える
ようにディストリビューションで既に設定済みなら、何もしなくても多分うまく行く
はずですが、そうでない場合は、環境変数を設定して、SGML カタログ (つまり DTD の
リスト) を捜すべき場所を PSGML に教える必要があります。</para>

        <para> <!--For example: -->たとえば、まず</para>
        <screen format="linespecific">
<prompt>bash$</prompt> <command>
export SGML_CATALOG_FILES=/usr/lib/sgml/catalog</command>
</screen>
        <!--
        <para> Then add something like the following to your .emacs
        file: </para> 
        -->
<para>と打って、次に、.emacs ファイルに次ぎのような内容の行を追加します。
</para>

        <programlisting>
;; *******************************************************************
;; set up psgml mode...
;; use psgml-mode instead of emacs native sgml-mode
;;

(autoload 'sgml-mode "psgml" "Major mode to edit SGML files." t )
(setq auto-mode-alist
  (append
  (list
    '("\\.sgm$" . sgml-mode)
    '("\\.sgml$" . sgml-mode)
    )
  auto-mode-alist))

;; set some psgml variables

(setq sgml-auto-activate-dtd t)
(setq sgml-omittag-transparent t)
(setq sgml-balanced-tag-edit t)
(setq sgml-auto-insert-required-elements t)
(setq sgml-live-element-indicator t)
(setq sgml-indent-step nil)

;; create faces to assign to markup categories

(make-face 'sgml-comment-face)
(make-face 'sgml-start-tag-face)
(make-face 'sgml-end-tag-face)
(make-face 'sgml-entity-face)
(make-face 'sgml-doctype-face) ; DOCTYPE data
(make-face 'sgml-ignored-face) ; data ignored by PSGML
(make-face 'sgml-ms-start-face) ; marked sections start
(make-face 'sgml-ms-end-face) ; end of marked section
(make-face 'sgml-pi-face) ; processing instructions
(make-face 'sgml-sgml-face) ; the SGML declaration
(make-face 'sgml-shortref-face) ; short references

;; view a list of available colors with the emacs-lisp command:
;;
;; list-colors-display
;;
;; please assign your own groovy colors, because these are pretty bad
(set-face-foreground 'sgml-comment-face "coral")
;(set-face-background 'sgml-comment-face "cornflowerblue")
(set-face-foreground 'sgml-start-tag-face "slateblue")
;(set-face-background 'sgml-start-tag-face "cornflowerblue")
(set-face-foreground 'sgml-end-tag-face "slateblue")
;(set-face-background 'sgml-end-tag-face "cornflowerblue")
(set-face-foreground 'sgml-entity-face "lavender")
;(set-face-background 'sgml-entity-face "cornflowerblue")
(set-face-foreground 'sgml-doctype-face "lavender")
;(set-face-background 'sgml-doctype-face "cornflowerblue")
(set-face-foreground 'sgml-ignored-face "cornflowerblue")
;(set-face-background 'sgml-ignored-face "cornflowerblue")
(set-face-foreground 'sgml-ms-start-face "coral")
;(set-face-background 'sgml-ms-start-face "cornflowerblue")
(set-face-foreground 'sgml-ms-end-face "coral")
;(set-face-background 'sgml-ms-end-face "cornflowerblue")
(set-face-foreground 'sgml-pi-face "coral")
;(set-face-background 'sgml-pi-face "cornflowerblue")
(set-face-foreground 'sgml-sgml-face "coral")
;(set-face-background 'sgml-sgml-face "cornflowerblue")
(set-face-foreground 'sgml-shortref-face "coral")
;(set-face-background 'sgml-shortref-face "cornflowerblue")

;; assign faces to markup categories

(setq sgml-markup-faces '
  (
  (comment . sgml-comment-face)
  (start-tag . sgml-start-tag-face)
  (end-tag . sgml-end-tag-face)
  (entity . sgml-entity-face)
  (doctype . sgml-doctype-face)
  (ignored . sgml-ignored-face)
  (ms-start . sgml-ms-start-face)
  (ms-end . sgml-ms-end-face)
  (pi . sgml-pi-face)
  (sgml . sgml-sgml-face)
  (shortref . sgml-shortref-face)
  ))

;; tell PSGML to pay attention to face settings
(setq sgml-set-face t)
;; ...done setting up psgml-mode.
;; *******************************************************************
</programlisting>
        <!--
        <para> Then restart Emacs </para>
        -->
<para>あとは、Emacs を再起動してください。</para>
      </section>
      
      <section>
        <title> <!--SGML Smoke Test-->SGML のちょっとしたテスト </title>
        <!--
        <para> Try the following smoke test. Start a new file,
        <filename moreinfo="none">/tmp/test.sgml</filename> for
        example, and enter the following: </para>
        -->
<para>ちょっとしたテストをしてみましょう。例として、新規ファイル 
<filename moreinfo="none">/tmp/test.sgml</filename> を開いて、次のように
書き込みます。</para>
        
        <programlisting format="linespecific">
<sgmltag class="starttag">!DOCTYPE test [
&lt;!ELEMENT test - - (#PCDATA)&gt;
]</sgmltag>
</programlisting>
        <!--
        <para> Enter <keycombo moreinfo="none"><keycap
            moreinfo="none">C</keycap> <keycap
            moreinfo="none">c</keycap></keycombo><keycombo
            moreinfo="none"><keycap moreinfo="none">C</keycap> 
            <keycap moreinfo="none">p</keycap></keycombo>. If Emacs
            manages to parse your DTD, you will see <emphasis>Parsing
            prolog...done</emphasis> in the minibuffer. Try
            <emphasis>C-c C-e RETURN</emphasis> to insert a
            <emphasis><sgmltag
            class="starttag">test</sgmltag></emphasis> element. If
            things are working correctly, you should see the following
            in Emacs: </para> 
         -->
<para>そして、<keycombo moreinfo="none"><keycap
            moreinfo="none">C</keycap> <keycap
            moreinfo="none">c</keycap></keycombo><keycombo
            moreinfo="none"><keycap moreinfo="none">C</keycap> 
            <keycap moreinfo="none">p</keycap></keycombo> と入力します。
Emacs が DTD を読み込もうとしているなら、ミニバッファに <emphasis>
Parsing prolog....done</emphasis> と表示されます。そしたら、<emphasis>
C-c C-e RETURN</emphasis> と打って、<emphasis><sgmltag class="starttag">
test</sgmltag></emphasis> と入力してみましょう。正しく動いている場合は、
Emacs に次のように表示されます。</para>

        <programlisting format="linespecific">
<sgmltag class="starttag">!DOCTYPE test [
&lt;!ELEMENT test - - (#PCDATA)&gt;
]</sgmltag>
<sgmltag class="starttag">test</sgmltag><sgmltag class="endtag">test</sgmltag>
</programlisting>
      </section>

      <section>
        <title> <!--Writing a New HOWTO in DocBook-->
                DocBook 形式で新規に HOWTO を書く方法 </title>
        <!--
        <para> Start a new file for your HOWTO and enter the
        following: </para> 
        -->
<para>HOWTO 用に新規ファイルを開いて、次のように入力します。</para>

        <programlisting format="linespecific">
<sgmltag class="starttag">
!DOCTYPE ARTICLE PUBLIC "-//OASIS//DTD DocBook V3.1//EN"</sgmltag>
</programlisting>
        <!--
        <para> Enter <keycombo moreinfo="none"><keycap
            moreinfo="none">C</keycap><keycap
            moreinfo="none">c</keycap></keycombo><keycombo
            moreinfo="none"><keycap moreinfo="none">C</keycap> 
            <keycap moreinfo="none">p</keycap></keycombo> and hold
            your breath. If everything goes as planned, you will see
            Emacs chewing for a few seconds and then <emphasis>Parsing
            prolog...done</emphasis> in the minibuffer. </para> 
        -->
<para><keycombo moreinfo="none"><keycap
            moreinfo="none">C</keycap><keycap
            moreinfo="none">c</keycap></keycombo><keycombo
            moreinfo="none"><keycap moreinfo="none">C</keycap> 
            <keycap moreinfo="none">p</keycap></keycombo>
と打って、画面に注目。すべて予定通りなら、数秒間 Emacs が読み込み処理をして、
ミニバッファに <emphasis>Parsing prolog....done</emphasis> と表示されるのが
分かります。</para>
        <!--
        <para> At this point, enter <keycombo moreinfo="none"><keycap
            moreinfo="none">C</keycap> <keycap
            moreinfo="none">c</keycap></keycombo><keycombo
            moreinfo="none"><keycap moreinfo="none">C</keycap><keycap
            moreinfo="none">e</keycap></keycombo><keycap
            moreinfo="none">RETURN</keycap> to insert an
            <emphasis><sgmltag
            class="starttag">article</sgmltag></emphasis> element and
            proceed to write your HOWTO. </para>
         -->
<para>ここで、<keycombo moreinfo="none"><keycap
            moreinfo="none">C</keycap> <keycap
            moreinfo="none">c</keycap></keycombo><keycombo
            moreinfo="none"><keycap moreinfo="none">C</keycap><keycap
            moreinfo="none">e</keycap></keycombo><keycap
            moreinfo="none">RETURN</keycap> 
と打ち、<emphasis><sgmltag class="starttag">article</sgmltag></emphasis> 
エレメントを書き込んで、HOWTO の執筆に取りかかりましょう。</para>
      </section>

      <section>
        <title> <!--Quick Reference for Emacs with PSGML-->
                PSGML を使った Emacs のクイックリファレンス </title>
        <!--
        <para> See Nik Clayton's primer for FreeBSD documentation:
        <ulink
        url="http://www.freebsd.org/tutorials/docproj-primer/psgml-mode.html">
        http://www.freebsd.org/tutorials/docproj-primer/psgml-mode.html</ulink>
        </para>
        -->
<para>FreeBSD 文書にある Nik Clayton の入門書をご覧ください。
 <ulink
        url="http://www.freebsd.org/tutorials/docproj-primer/psgml-mode.html">
        http://www.freebsd.org/tutorials/docproj-primer/psgml-mode.html</ulink>
</para>
      </section>
    </section>
   </section>

      <section id="vim">
        <title>VIM</title>
        <para><ulink
        url="http://www.vim.org">http://www.vim.org</ulink></para>
        <!-- 
        <para>No mention of Emacs is complete without talking about
        vi.  The VIM (Vi IMproved)editor has the functionality of
        regular vi, but also has an SGML mode that will
        color-coordinate your screen to show where tags are.</para>
        -->
<para>Emacs についての話をしましたので、当然、次は vi のお話です。VIM 
(Vi IMproved) 
エディタは、vi の標準機能を持ちながら、タグの位置をスクリーン上で色分けして
教えてくれます SGML モードも持っています。</para>

        <section id="usingvim">
          <title><!--Getting Started-->はじめに</title>
          <!--
          <para>The vim program comes really in multiple parts.  There is
          first the plain vim program, which has compatability with the
          vi program and its commands.  Red Hat users will want the vim-common
          and vim-minimal packages.  Next is the enhanced
          <command>vim</command>, which includes the highlighting and other
          features of vim over regular vi.  Red Hat
          users will want vim-enhanced.  Last, but certainly not least, is the
          X interface, which gives a graphical interface, menus, and mouse
          control.  To separate this from vim or vi, the command for graphical
          access is called <command>gvim</command>.</para>
          -->
<para>vim プログラムは実際に複数の部分から出来ています。まず、素の vim 
プログラム
があって、これは、vi プログラムやそのコマンドと互換性を持っています。Red Hat 
ユーザなら、vim-common と vim-minimal パッケージが必要です。次に、拡張機能を
持った <command>vim</command> で、これは標準の vi に対して、構文強調などの
機能があります。Red Hat ユーザなら、vim-enhanced が必要です。最後の見逃せない
機能
として、 X インターフェイスがあり、これは、グラフィカルインターフェイスや
メニュー、マウス操作などを提供しています。vim や vi からこれを区別する場合、
グラフィカル操作でのコマンドは、<command>gvim</command> と呼ばれています。
</para>
        </section>
        <section>
          <title><!--Loading or starting new documents-->
                 新規文書のロードもしくは作成</title>
          <!--
          <para>In both <command>vim</command> and <command>gvim</command> 
          modes,
          <filename>.sgml</filename> files will be automatically recognized and
          enter into <quote>sgml mode</quote>.  A series of known DocBook tags
          have been entered into <command>vim</command> and will he highlighed
          in brown if a tag is known.  If it isn't, it will appear in light 
          blue. attributes to known tags are in light blue, and values for the
          attributes are in pink. From here on, you can use regular <command>
          vi</command> commands to navigate and edit.</para>
          -->
<para><command>vim</command> と <command>gvim</command> モードでは、
<filename>.sgml</filename> ファイルは自動的に認識されて、<quote>sgml モード
</quote> に入ります。あらかじめ分かっている一連の DocBook タグが <command>vim
</command> に読み込まれると、認識されたタグは茶色で強調されます。認識されない
場合、ライトブルーで表示されます。認識されたタグの属性(attribute)もライトブルー
になり、属性の値(value)は、ピンクになります。ここからは、通常の <command>vi
</command> コマンドを使って、カーソル移動と編集ができます。</para>
        </section>
      </section>

      <section id="wordperfect">
        <title>WordPerfect 9 (Corel Office 2000)</title>
        <para><ulink
        url="http://www.corel.com/">http://www.corel.com/</ulink></para>
        <!-- 
        <para>WordPerfect 9 for the MS Windows platform has support
        for SGML and DocBook 3.0. WordPerfect 9 for Linux has no SGML
        capabilities.</para>
        <para>This is the least expensive of the commercial
        applications that support SGML.</para>
        -->
<para>MS Windows プラットフォームの WordPerfect 9 は、SGML と DocBook 3.0 を
サポートしています。Linux 用 WordPerfect 9 に SGML 機能はありません。</para>
<para>これは、SGML をサポートしている商用アプリケーションとしては一番安価な
ものです。</para>
      </section>

      <section id="sgedit">
        <title>sgedit</title>
        <para><ulink
        url="http://www.tksgml.de/">http://www.tksgml.de/</ulink></para>
        <!--
        <para>The sgedit program allows you to visually edit SGML
        files.  It has the advantages of not needing to know Emacs or
        VI before starting, and is cross-platform, working in both
        Windows and Linux.  It's a commercial application, but pricing
        has not been set.  There will be free licenses for private and
        academic use.</para>
        -->
<para>sgedit は、SGML ファイルをビジュアルに編集できるプログラムです。
このプログラムの長所は、あらかじめ Emacs や VI の使い方を知らなくても
よい点と、クロスプラットフォームなので、Windows でも Linux でも動くという
点です。商用アプリケーションですが、値段は設定されていません。個人や教育
機関での利用については、フリーライセンス版が出るようです。</para>
        <!--
        <para>Along with visual editing, sgedit will also validate
        documents on loading, and on demand by using the <menuchoice
        moreinfo="none"><guimenu
        moreinfo="none">Document</guimenu><guimenuitem
        moreinfo="none">Validate</guimenuitem></menuchoice>
        command.</para> 
        -->
<para>ビジュアル編集の他にも、sgedit は、ロード時や必要な時に、
<menuchoice moreinfo="none"><guimenu moreinfo="none">Document</guimenu>
<guimenuitem moreinfo="none">Validate</guimenuitem></menuchoice> コマンド
を使って、文書の妥当性検査ができます。</para>

        <figure>
          <title><!--sgedit screen shot-->sgedit のスクリーンショット</title>
          <mediaobject>
            <imageobject>
              <imagedata format="eps" fileref="sgeditscreenshot.eps">
            </imageobject>
            <imageobject>
              <imagedata format="jpg" fileref="sgeditscreenshot.jpg">
            </imageobject>
            <textobject>
              <!--
              <phrase>The screen shot of the sgedit program shows a
              tree on the left side that has the SGML document in a
              hierarchy, while the right side shows the document.
              Tags are shown with a grey background.</phrase>
              -->
<phrase>sgedit プログラムのスクリーンショット。左側には、階層を持った 
SGML 文書のツリー構造が表示され、右側には、文書自体が表示されている。
タグは、グレーの背景で表示される。</phrase>
            </textobject>
          </mediaobject>
        </figure>  
      </section>

      <section id="nedit">
        <title>nedit</title>
        <para><ulink
        url="http://nedit.org">http://nedit.org</ulink></para> 
        <!--
        <para>To be fair,
        <indexterm><primary>nedit</primary></indexterm>nedit is more
        for programmers, so it might seem a bit of overkill for new
        users and especially non-programmers.  All that aside, it's
        extremely powerful, allowing for color coding of tags.  Unlike
        sgedit, nedit doesn't allow you to automatically insert tags
        or automatically validate your code.  However, it does allow
        for shell commands to be run against the contents of the
        window (as opposed to saving the file, then checking).  In a
        few minutes, I was able to set up <command>nsgmls</command> to
        validate the SGML and <command>aspell</command> to do my spell
        checking. 
        -->
<para>率直に言って、nedit は、プログラマ向けで、新規ユーザや特にプログラマで
ないユーザにとってはちょっときついかもしれません。それを除けば、タグの色づけ
が自由にできたりして、かなりパワフルです。sgedit と異なり、nedit では、タグを
自動で入れたり、文書の妥当性検査を自動的に行ったりはしません。そのかわり、
ウィンドウ
の内容に対してシェルコマンドが使えるようになっています。(ファイルを保存した後
で、チェックします。) わたしは、SGML の妥当性検査のために <command>
nsgmls</command> を設定し、スペルチェックのために <command>aspell</command> を
設定しましたが、だいたい数分で終わりました。

        <figure>
            <title><!--nedit screen shot-->nedit のスクリーンショット</title>
            <mediaobject>
              <imageobject>
                <imagedata fileref="neditscreenshot.eps" format="eps">
              </imageobject>
              <imageobject>
                <imagedata fileref="neditscreenshot.jpg" format="jpg">
              </imageobject>
              <textobject>
                <!--
                <phrase>The nedit program can provide line numbers
                across the left side of the screen, handy for when
                <command>nsgmls</command> complains of errors</phrase> 
                -->
<phrase>nedit では、画面の左端に行番号が表示されるので、<command>
nsgmls</command> でエラーが出た場合に便利です。</phrase>
              </textobject>
            </mediaobject>
          </figure>
        </para>
        <section id="usingnedit">
          <title><!--Using nedit-->nedit の使い方</title>
                  <!--
                  <para>For writing new documentation, it is recommended that
        you download and use the LDP DocBook template.  Once you have
        the file, you can start up nedit and start editing.  If the
        file is saved with a .sgml extension, nedit will load the file
        up with SGML/HTML tags enabled.  You can turn this on
        explicitly using the
        <menuchoice><guimenu>Preferences</guimenu><guimenuitem>Language
        Mode</guimenuitem><guimenuitem>SGML
        HTML</guimenuitem></menuchoice> command. </para> 
                    -->
<para>新規文書を作るときは、LDP DocBook テンプレートをダウンロードして使う
ことが推奨されています。そのファイルがあれば、nedit を起動してすぐ編集に
取りかかれます。ファイルに .sgml 拡張子を付けて保存しておけば、nedit は、
SGML/HTML タグ機能を有効にしてファイルをロードします。この機能は、 
        <menuchoice><guimenu>Preferences</guimenu><guimenuitem>Language
        Mode</guimenuitem><guimenuitem>SGML
        HTML</guimenuitem></menuchoice> 
コマンドを使って明示的に有効にすることもできます。</para>
      </section> <!-- New Documents -->

      <section id="tipsandtricksnedit">
        <title><!--Tips and tricks with nedit-->nedit の Tips とコツ</title>
        <!--
        <para>Since you can feed the contents of your window to
        outside programs, you can easily extend nedit to perform
        repetitive functions.  The example you'll see here is to
        validate the SGML code using <command>nsgmls</command>.</para> 
        -->
<para>nedit では、ウィンドウの内容を外部プログラムに出力することができるので、
この機能を使って、普段使っている関数を実行できます。ここで取り上げる例題では、
<command>nsgmls</command> を使い、SGML の妥当性検査を行う方法を紹介します。
</para>
        <!--
        <para> Select
        <menuchoice><guimenu>Preferences</guimenu><guimenuitem>Default
        Settings</guimenuitem><guimenuitem>Customize
        Menus</guimenuitem><guimenuitem>Shell
        Menu...</guimenuitem></menuchoice>.  This will bring up the
        Shell Command dialog box, with all the shell commands  nedit
        has listed under the
        <menuchoice><guimenu>Shell</guimenu></menuchoice> menu.  Under
        Menu Entry, enter "SGML Validate".  This will be the entry
        you'll see on the screen.  Under Accelerator, press
        <keycombo><keycap>Alt</keycap><keycap>S</keycap></keycombo>.
        Once this menu item is set up, you can press
        <keycombo><keycap>Alt</keycap><keycap>S</keycap></keycombo>
        to have the SGML Validate automatically run.  Under Command
        Input, select window,  and under Command Output, select
        dialog.  Under Command to Execute, enter  nsgmls -sv.  Note
        that <command>nsgmls</command> has to be in your
        <envar>PATH</envar>  for this to work properly. </para> 
        -->
<para>まず、
        <menuchoice><guimenu>Preferences</guimenu><guimenuitem>Default
        Settings</guimenuitem><guimenuitem>Customize
        Menus</guimenuitem><guimenuitem>Shell
        Menu...</guimenuitem></menuchoice> 
を選択します。すると、<menuchoice><guimenu>Shell</guimenu></menuchoice> 
メニュー
に登録されている全シェルコマンドを表示するダイアログボックスが出てくるので、
その Menu Entry の欄に "SGML validate" と書き込みます。このエントリーは、
スクリーン上で見ることができます。次に、Accelerator の欄で、
<keycombo><keycap>Alt</keycap><keycap>S</keycap></keycombo> を押して、
SGML の妥当性検査が自動で行われるようにします。Command Input の部分では、
window を選択して、Command Output の部分では、dialog を選択します。
Command to Execute では、nsgmls -sv と入力しましょう。これがうまく動くため
には、
<envar>PATH</envar> に <command>nsgmls</command> へのパスが設定されていないと
いけないので注意してください。</para>

        <figure>
          <title><!--Adding shell commands to nedit-->
                 nedit へのシェルコマンドの追加</title>
          <mediaobject>
            <imageobject>
              <imagedata fileref="neditshellcommand.eps" format="eps">
            </imageobject>
            <imageobject>
              <imagedata fileref="neditshellcommand.jpg" format="jpg">
            </imageobject>
            <!--訳者が追加-->
            <textobject>
             <phrase>シェルコマンドを追加する時のダイアログボックス。</phrase>
            <!--訳者の追加終わり-->
            </textobject>
          </mediaobject>
        </figure>

        <!--
        <para> Click <guibutton>OK</guibutton> and you'll now be back
        at the main nedit screen.  Load up an SGML file, and select
        <menuchoice><guimenu>Shell</guimenu><guimenuitem>SGML
        Validate</guimenuitem></menuchoice> or press
        <keycombo><keycap>Alt</keycap><keycap>S</keycap></keycombo>.
        The <command>nedit</command> program will fire up and check
        the contents of the window.  The reason for using -sv is that
        the -v tells <command>nsgmls</command> to output the version
        of the program, so you'll always get ouput and know that
        <command>nsgmls</command> has run.  If all you get is a
        version number, then there are no errors with the document.
        If there are errors, then they'll be listed in the separate
        window for you to see.  If you have line numbers turned on
        (using
        <menuchoice><guimenu>Preferences</guimenu><guimenuitem>Show
        Line Numbers</guimenuitem></menuchoice>) then finding the
        errors is much simpler, as <command>nsgmls</command> will list
        errors by their line number.</para> 
        -->
<para><guibutton>OK</guibutton> をクリックして、これで元のメインスクリーン
に戻ります。SGML ファイルをロードして、<menuchoice><guimenu>Shell</guimenu>
<guimenu>SGML Validate</guimenu></menuchoice> を選択するか、<keycombo>
<keycap>Alt</keycap><keycap>S</keycap></keycombo> を押すと、<command>
nsgmls</command> が起動されて、ウィンドウの内容をチェックします。-sv を使う
理由は、-v を指定すると、<command>nsgmls</command> はプログラムのバージョン
を出力するので、その出力を見れば <command>nsgmls</command> が実行されたこと
が必ず分かるようになるからです。バージョン番号しか出力されない場合は、
文書にエラーがなかったことになります。エラーがあれば、そのエラーが分かる
ように、
別のウィンドウが開いて表示されます。行番号機能を有効にしてあるなら (これには、
<menuchoice><guimenu>Preferences</guimenu><guimenuitem>Show Line Numbers
</guimenuitem></menuchoice> を使います。)、<command>nsgmls</command> はエラーを
行番号で表示するので、エラーを見つけるのがずっと楽になります。</para>

        <figure>
          <title><!--nsgmls output on success-->
                 エラーがない場合の nsgml の出力</title>
          <mediaobject>
            <imageobject>
              <imagedata fileref="neditsuccess.eps" format="eps">
            </imageobject>
            <imageobject>
              <imagedata fileref="neditsuccess.jpg" format="jpg">
            </imageobject>
            <textobject>
              <!--
              <phrase>If nsgmls reports success, it merely reports the version
               of nsgmls</phrase>
              -->
<phrase>nsgmls がエラーを検出しなかった場合は、バージョン番号だけを報告します。
</phrase>
            </textobject>
          </mediaobject>
        </figure>
      </section>
    </section>

    </section>

&cvs;
    
    <section id="other">
      <title><!--Other/Reference-->その他のツールとリファレンス</title>
      <!--
      <para>The items in this section are reference books or other
      utilities that can't quite be categorized (yet).</para> 
      -->
<para>このセクションでは、今のところ分類しきれていないリファレンス本や
ユーティリティを紹介します。</para>

      <section id="docbooktdg">
        <title>DocBook: The Definitive Guide</title>
        <para><ulink
        url="http://www.docbook.org/">http://www.docbook.org/</ulink></para> 
        <!--
        <para>This book was released by O'Reilly in October 1999, and
        is a great reference to DocBook. I have not found it to be a
        great practical book, and much of the emphasis is on XML, but
        the DocBook tags for version 3.1 are all listed in a handy
        format. You can pick it up at the book vendor of choice. The
        entire book is also available online (in HTML and SGML
        formats) at the above URL. </para>
        -->
<para>これは、1999年10月に O'Reilly から出版された、DocBook についての
すばらしいリファレンス本です。それほど実用的ではないように思われるし、
XML に重点が置かれてはいますが、バージョン 3.1 の DocBook タグはすべて
分かりやすく一覧表示されています。書店で買うこともできるし、本のすべての内容を
上記 URL からオンラインで (HTML と SGML フォーマットにおいて) 読むことも
できます。</para>
      </section>

      <section id="templates">
        <title><!--SGML templates-->SGML テンプレート</title>
        <!--
        <para>Optional - <ulink 
        url="http://www.linuxdoc.org/authors/index.html#resources">
        http://www.linuxdoc.org/authors/index.html#resources</ulink></para>
        <para>Contains links to SGML templates and their resulting HTML output
        to help you see what your document will look like. Many of the tags
        just need to be replaced with information unique to your HOWTO.
        </para>
        -->
<para>オプションです。- <ulink 
        url="http://www.linuxdoc.org/authors/index.html#resources">
        http://www.linuxdoc.org/authors/index.html#resources</ulink>
        (<ulink url="../../authors/index.html#resources">日本語訳</ulink>)
        </para>
<para>SGML テンプレートと、変換した後の HTML 出力についてのリンクがある
ので、文書の体裁を理解する手助けになります。タグの多くは、作成する文書の内容に
合わせて置き換えることが必要です。</para>
      </section>

      <section id="aspell">
        <title>Aspell</title>
        <para><!--Optional-->オプションです。 - <ulink
        url="http://aspell.sourceforge.net/">
        http://aspell.sourceforge.net/</ulink></para> 
        <!--
        <para>This spell checking application can work around SGML
        tags, and only spell check the content within the
        tags. Default spell checkers like ispell will try to spell
        check the tags, causing errors at every new tag.</para>
        -->
<para>スペルチェック用のこのアプリケーションは、SGML タグを避けて、
タグに挟まれた内容だけをチェックすることができます。ispell のような
デフォルトのスペルチェッカーだと、タグ自体もチェックしようとする
ので、新規タグがあると、いつもエラーになってしまいます。</para>
      </section>
      <section id="ispell">
        <title>ispell</title>
        <para><!--Optional-->オプションです。 - <ulink 
         url="http://www.cs.hmc.edu/~geoff/ispell.html">
         http://www.cs.hmc.edu/~geoff/ispell.html</ulink></para>
        <!--
        <para>The ispell program is distributed with RedHat (and possibly other
        distros) and also ignores markup tags.</para>
        -->
<para>この ispell プログラムは、Red Hat (や、おそらく他のディストリビューション
)に同梱されているもので、マークアップタグを無視することができます。</para>
      </section>
   </section>
  </chapter>

&using-docbook;

&style-guide;

  <chapter id="other-style">
    <title> <!--Additional Style-related Items-->
             スタイル関連事項の補足</title>
    <!--
    <para> This section contains additional style-oriented topics to
    consider when preparing your document. </para>
    -->
<para>このセクションでは、文書の作成にあたり、スタイルに関連するトピックの
いくつかを補足しています。</para>

    <section id="accepteddates">
      <title> <!--Date formats-->日付の書き方 </title>
      <!--
      <para> The <sgmltag class="starttag">pubdate</sgmltag> tag in
      your header should be in the following format: </para>
      -->
<para><sgmltag class="starttag">pubdate</sgmltag> タグを文書で使う際には、
次の書式で日付を記入してください。</para> 
      <programlisting format="linespecific">v1.0, 21 April 2000</programlisting>
    </section>

    <section id="acceptedgfx">
      <title><!--Graphics formats-->画像フォーマット</title>
      <!--
      <para> When submitting graphics to the LDP, please submit one
      set of graphics in <filename>.eps</filename>, and another in
      either <filename moreinfo="none">.gif</filename> or <filename
      moreinfo="none">.jpg</filename>. Be aware of the patent issues
      with <filename moreinfo="none">.gif</filename>, but it makes
      slightly better pictures than <filename>.jpg</filename>. </para>
      -->
<para>文書に画像を付けて LDP に送る際は、まず <filename>.eps</filename> の
セットと、次に <filename>.gif</filename> もしくは <filename>.jpg</filename> 
のどちらか一方のセットとを送ってください。<filename moreinfo="none">.gif
</filename> の特許の問題は意識しておくべきですが、<filename>.gif</filename> 
のほうが、<filename>.jpg</filename> よりすこしだけ良い画像が作れるようです。
</para>
    </section>

    <section id="acceptedversions">
      <title><!--DocBook Versions-->DocBook のバージョン</title>
      <!--
      <para>
        The LDP supports and accepts documentation in the following formats:
      </para>
      -->
<para>LDP では、以下のフォーマットでの文書をサポートし、受け入れています。
</para>
      <itemizedlist>
        <listitem>
          <para>
            SGML DocBook versions 4.x <!--and-->と 3.1
          </para>
        </listitem>
        <listitem>
          <para>
            SGML LinuxDoc
          </para>
        </listitem>
        <listitem>
          <para>
            XML DocBook version 4.1.2
          </para>
        </listitem>
      </itemizedlist>
      <!--
      <para>When writing your DocBook header, it should look like
      this:</para>
      -->
<para>DocBook のヘッダを書くときは、次のように書いてください。</para>
      <programlisting format="linespecific">
<sgmltag class="starttag">!doctype article public "-//OASIS//DTD DocBook V4.1//EN"</sgmltag>
</programlisting>
    </section>

    <section id="nodeptags">
      <title><!--Depreciated Tags-->利用禁止のタグ</title>
      <!--
      <para>Tags listed in <emphasis>DocBook: The Definitive
      Guide</emphasis> as depreciated are discouraged for use in LDP
      documentation.  Some ways to use newer tags are listed in the
      tip and tricks section.</para>
      -->
<para>非推奨タグとして <emphasis>DocBook: The Definitive Guide</emphasis> 
のリストに挙がっているタグは、LDP 文書内でも使用しないようにしてください。
新しいタグの使い方については、テクニックとコツのセクションで紹介しています。
</para>
    </section>

    <section id="notagmin">
      <title><!--Tag Minimization-->タグの最小化</title>
      <!--
      <para>Tag minimization is using <sgmltag
      class="endtag"></sgmltag> instead of the full end of a tag (such
      as <sgmltag class="endtag">para</sgmltag>.  Since this makes the
      document more confusing for future authors and LDP members, and
      is not allowed in XML DocBook, please refrain from this
      practice.</para>
      -->
<para>タグの最小化(tag minimization)とは、(たとえば、<sgmltag class="endtag">
para</sgmltag> のような)完全な終了タグのかわりに、<sgmltag class="endtag">
</sgmltag> を使うことです。これを使うと、その文書に将来関わる作者や LDP 
メンバーにとっては文書構造が分かりにくくなりますし、XML DocBook では
認められていない使い方なので、そうした習慣は止めるようにしてください。
</para>
    </section>

    <section id="usingconventions">
      <title><!--Conventions-->文書内での表記法</title>
      <!--
      <para>Conventions for different kinds of text is as
      follows:</para>  
      -->
<para>様々な文書間で守るべき表記法に、次のようなものがあります。</para>
      <!--
      <para>If you're going to show the use of a command, format the
      command so it looks like a user's command line. The prompt must
      contain the shell type (bash, tcsh, zsh, etc) followed by a $
      for commands to be run as a normal (non-root) user or a # for a
      root user.</para> 
      -->
<para>コマンドの使い方を示そうとする場合、ユーザコマンドラインとしての
表示になるよう、コマンド行を書いてください。プロンプトには、まず、シェルの
種類 (bash, tcsh, zsh, など) が表示され、次に、(root でない)通常のユーザ
として実行される場合には $ を、root ユーザとして実行される場合は # を表示
してください。</para>
      <!--
      <para> A command would then look like this: </para>
      -->
<para>それゆえ、コマンドは、次のように表示されます。</para>
      <screen format="linespecific">
<prompt>bash$</prompt> <command>command "run as a normal user"</command>
<prompt>bash#</prompt> <command>command "run as a root user"</command>
<prompt>tcsh#</prompt> <command>setenv DISPLAY :0.0</command>
</screen>
    </section>
  </chapter>


  <chapter id="tips">
    <title><!--Tips and Tricks with DocBook-->
           DocBook のテクニックとコツ</title>
    <!--
    <para>This section covers a few quirks of DocBook that you may run
    into when writing your documents.</para> 
    -->
<para>このセクションでは、文書を書く際の DocBook のちょっとひねった使い方を
いくつか紹介します。</para>

    <section id="images">
      <title><!--Including Images-->画像の挿入</title>
      <!--
      <para>If you plan on including images in your HOWTOs, you can
      now do this, as LinuxDoc didn't support images.  Here's a sample
      way of including an image in your HOWTOS:</para> 
      -->
<para>HOWTO に画像を入れようと思っている場合、LinuxDoc では画像のサポートは
ありませんでしたが、DocBook なら可能です。次に、HOWTO に画像を入れる方法の
一例を紹介します。</para>
      <programlisting format="linespecific">
<sgmltag class="starttag">figure</sgmltag>
   <sgmltag class="starttag">title</sgmltag>LyX screen shot<sgmltag class="endtag">title</sgmltag>
   <sgmltag class="starttag">mediaobject</sgmltag>
      <sgmltag class="starttag">imageobject</sgmltag>
         <sgmltag class="starttag">imagedata fileref="lyx_screenshot.eps" format="eps"</sgmltag>
      <sgmltag class="endtag">imageobject</sgmltag>
      <sgmltag class="starttag">imageobject</sgmltag>
         <sgmltag class="starttag">imagedata fileref="lyx_screenshot.jpg" format="jpg"</sgmltag>
      <sgmltag class="endtag">imageobject</sgmltag>
      <sgmltag class="starttag">textobject</sgmltag>
         <sgmltag class="starttag">phrase</sgmltag>Screen shot of the LyX document processing program<sgmltag class="endtag">phrase</sgmltag>
      <sgmltag class="endtag">textobject</sgmltag>
   <sgmltag class="endtag">mediaobject</sgmltag>
<sgmltag class="endtag">figure</sgmltag>
</programlisting>
      <!--
      <para>This is a better way than using <sgmltag
      class="starttag">graphic</sgmltag> for two reasons.  First, 
      <sgmltag class="starttag">graphic</sgmltag> will be removed in 
      DocBook 5.0 in favor of the <sgmltag
      class="starttag">mediaobject</sgmltag> tag.  So you may as well
      get started with the right way now.  Second, <sgmltag
      class="starttag">mediaobject</sgmltag> allows for different kinds
      of media based on what the output is. In this example, the first
      <sgmltag class="starttag">imageobject</sgmltag> is an encapsulated
      PostScript(eps) file for use with formats derived from TeX such as
      DVI, PS, and PDF. The second <sgmltag
      class="starttag">imageobject</sgmltag> is a JPEG image for visual
      display, mostly for HTML output. The <sgmltag
      class="starttag">textobject</sgmltag> is presented if the output
      doesn't support graphics (TXT).  Think of it as an <sgmltag
      class="starttag">alt</sgmltag> tag.</para> 
      -->
<para>上記は、<sgmltag class="starttag">graphic</sgmltag> を使うよりも、
ふたつの理由ですぐれています。第一に、DocBook 5.0 では、<sgmltag 
class="starttag">mediaobject</sgmltag> に移行するため、<sgmltag 
class="starttag">graphic</sgmltag> は削除されます。それゆえ、今から
正しい方法で使い始めるほうがよいと思われます。第二に、<sgmltag 
class="starttag">
mediaobject</sgmltag> なら、出力形式に従って異なる複数のフォーマットの
画像を扱うことができます。上記の例で言うと、最初の <sgmltag class="starttag">
imageobject</sgmltag> は、DVI, PS, PDF といった TeX から生成されるフォーマット
に利用される EPS (Encapsulated PostScript) 画像で、ふたつ目の <sgmltag 
class="starttag">imageobject</sgmltag> は、ディスプレイ画面用、大部分は 
HTML 用の出力で利用される JPEG 画像です。<sgmltag class="starttag">
textobject</sgmltag> の部分は、出力が画像をサポートしていない場合
に表示されるものです(TXT)。<sgmltag class="starttag">alt</sgmltag> タグの
ようなものとお考えください。</para>
    </section> 
    
    <section id="namedfiles">
      <title><!--Naming separate HTML files-->
             HTML 出力ファイルのファイル名を指定する</title>
      <!--
      <para>By default, when separate HTML files are made, the SGML
      processor will assign arbitrary names to the resulting files.
      This can be confusing to readers who may bookmark a page only to
      have it change, or so you know what files are what.  Whatever
      your reasoning, here's how to make separate files named the way
      you want:</para> 
      <para>In your first <sgmltag class="starttag">article</sgmltag>
      tag (which should be the only one) include an id parameter and
      call it index.  This will make your tag look like this:</para> 
      -->
<para>個別の HTML ファイルを出力する場合、SGML 処理系は、デフォルトで、
恣意的なファイル名しか付けません。これでは、読者がページをブックマーク
しておいてもすぐに変更されてしまいますし、あなたもどれがどのファイルなの
か分からなくなって、紛らわしいでしょう。理由はどうであれ、ここでは、
個別の出力ファイルに好きな名前を付ける方法を紹介します。</para>

<para><sgmltag class="starttag">article</sgmltag> タグを最初に置く場合( 
これはひとつだけのはずです。)、そこに id パラメータを書き込んで、その値を 
index とします。そうすると、タグは次のようになります。</para>

      <programlisting format="linespecific">
<sgmltag class="starttag">article id="index"</sgmltag>
</programlisting>

      <!--
      <para>On the first <sgmltag class="starttag">chapter</sgmltag>
      tag, do not modify it, as it's usually an introduction and you
      want that on the first page.  For each other <sgmltag
      class="starttag">section</sgmltag> tag, include the id parameter
      and name it.  Names should include only alphanumeric characters,
      and it should be short enough to understand what it is.</para> 
      -->
<para>最初に <sgmltag class="starttag">chapter</sgmltag> タグを置く場合、
このタグ内の内容は通常イントロダクションとなるでしょうし、これは文書内の最初
に置きたいと思うでしょうから、修正しないでください
<footnote><para>
(訳注: この文書(原文)の SGML ソースでは、最初に <sgmltag class="starttag">
book</sgmltag> タグを無修正で置き、その中での最初の <sgmltag class="starttag">
chapter</sgmltag> を <sgmltag class="starttag">chapter id="aboutthisguide"
</sgmltag> としています。トップレベル・エレメント( LDP では、比較的短い文書
には <sgmltag class="starttag">article</sgmltag> が、長めの文書には 
<sgmltag class="starttag">book</sgmltag> が使われることが多いようです。)
に応じて適宜読み替えてください。)
</para></footnote>。それ以外の
個々の <sgmltag class="starttag">section</sgmltag> タグについては、
id パラメータとその名前を書き込んでください。名前には、アルファベットと
数字だけを使うようにし、内容が理解できる程度の短い名前にしてください。
</para>

      <programlisting format="linespecific">
<sgmltag class="starttag">chapter id="tips"</sgmltag>
</programlisting>
    </section>

    <section id="usingldpdsssl">
      <title><!--Using ldp.dsl-->ldp.dsl を使う</title>
      <!--
      <para>The LDP uses its own DSSSL file, which adds things like a
      white background and automatic generation of the table of
      contents you see at the beginning of HOWTOs.  You can find the
      latest copy of the file at <ulink
      url="http://www.linuxdoc.org/authors/tools/ldp.dsl">
      http://www.linuxdoc.org/authors/tools/ldp.dsl</ulink>.</para>
      <para>Once you have the file, you may need to do some editing of
      the first few lines based on the location of your DocBook DSSSL
      files.  My example uses the Cygnus tool set.</para>
      <para>Place the <filename moreinfo="none">ldp.dsl</filename>
      file in <filename moreinfo="none"
      class="directory">/usr/lib/sgml/stylesheets</filename> and bring
      it up under your favorite text editor.You should see something
      like this:</para>
      -->
<para>LDP では、独自の DSSSL を使っていて、それによって、背景部分や HOWTO の
最初のページにある目次の自動生成機能を付け加えています。その最新バージョンは、
<ulink url="http://www.linuxdoc.org/authors/tools/ldp.dsl">
http://www.linuxdoc.org/authors/tools/ldp.dsl</ulink> にあります。</para>
<para>ファイルが手に入ったら、DocBook DSSSL ファイルの置き場所に基づいて
先頭の数行を修正する必要があるかもしれません。わたしの例では、Cygnus ツール
セットを使っています。</para>
<para><filename moreinfo="none">ldp.dsl</filename> ファイルを 
<filename moreinfo="none" class="directory">/usr/lib/sgml/stylesheets
</filename> に置いて、それを好きなエディタで開いてください。次のように
なっているのがわかると思います。</para>

      <informalexample>
        <screen format="linespecific">
&lt;!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
&lt;!ENTITY % html "IGNORE">
&lt;![%html;[
&lt;!ENTITY % print "IGNORE">
&lt;!ENTITY docbook.dsl SYSTEM "docbook.dsl<co id="html">" CDATA dsssl&gt;
]]&gt;
&lt;!ENTITY % print "INCLUDE">
&lt;![%print;[
&lt;!ENTITY docbook.dsl SYSTEM "docbook.dsl<co id="print">" CDATA dsssl>
]]&gt;
]>
</screen>
        <calloutlist>
          <callout arearefs="html">
            <!--
            <para>Change the first "docbook.dsl" to read <filename
            moreinfo="none">
            /usr/lib/sgml/stylesheets/nwalsh-modular/html/docbook.dsl
            </filename></para>
            -->
<para>最初の "docbook.dsl" が、<filename moreinfo="none">
/usr/lib/sgml/stylesheets/nwalsh-modular/html/docbook.dsl</filename>
を読むようにしてください。</para> 
          </callout>
          <callout arearefs="print">
            <!--
            <para>Change the second "docbook.dsl" to read <filename
            moreinfo="none">
            /usr/lib/sgml/stylesheets/nwalsh-modular/print/docbook.dsl
            </filename></para> 
            -->
<para>二つ目の "docbook.dsl" が <filename moreinfo="none">
/usr/lib/sgml/stylesheets/nwalsh-modular/print/docbook.dsl</filename> 
を読むようにしてください。</para>
          </callout>
        </calloutlist>
      </informalexample>
      <!--
      <para>If you're using another DSSSL, point those two files to
      the location of the HTML and print DSSSL files.  They're usually
      in directories called html and print.</para> 
      <para>With that complete, you can now generate HTML files:</para>
      -->
<para>もし違う DSSSL を使っているなら、上記ふたつのファイルのところが HTML 用と
プリント用の DSSSL ファイルを指すように変更してください。通常、それらは 
html や print と呼ばれるディレクトリに入っています。</para>
<para>以上が済めば、HTML ファイルの出力ができるようになります。</para>

      <screen format="linespecific">
<prompt>bash$</prompt> <command>mkdir HOWTO-HOWTO ; cd HOWTO-HOWTO</command>
<prompt>bash$</prompt> <command> jade -t sgml -i html -d /usr/lib/sgml/stylesheets/ldp.dsl\#html ../HOWTO-HOWTO.sgml</command>
</screen>

      <!--
      <para>The first command creates a new directory to put your
      files into.  The second command (the jade one) generates
      individual HTML files for each section of your document.  If you
      are going to something like RTF, you can do this:</para> 
      -->
<para>最初のコマンドでは、出力ファイルを入れるディレクトリを作成しています。
次のコマンド(jade を使っている方です)では、文書のセクションごとの個別の 
HTML ファイルを生成しています。RTF などを出力したい場合は、次のように
してください。</para>

      <screen format="linespecific">
<prompt>bash$</prompt> <command>jade -t rtf -d /usr/lib/sgml/stylesheets/ldp.dsl ../HOWTO-HOWTO.sgml</command>
</screen>
    </section>
  </chapter>

  <chapter id="distribution">
    <title> <!--Distributing your documentation-->文書の公開について </title>

    <section id="beforeyoudistribute">
      <title> <!--Before you distribute-->文書公開のまえに </title>
      <!--
      <para> Before you distribute your code to millions of potential
      readers there are a few things you should do. </para> 
      <para> First, be sure to spell-check your document. Most
      utilities that you would use to write SGML have plug-ins to
      perform a spell check. If not, there's always the aspell
      program. </para>
      -->
<para>将来の無数の読者に文書を公開するまえに、やるべきことがいくつかあります。
</para>
<para>第一に、必ずスペルチェックをすることです。SGML を書くのに使われる
ユーティリティには、たいていスペルチェック用のプラグインが付いています。
付いていない場合でも、aspell があります。
</para>
      <!--
      <para> Second, get someone to review your documentation for
      comments and factual correctness. The documentation that is
      published by the LDP needs to be as factually correct as
      possible, as there are millions of Linux users that may be
      reading it. If you're part of a larger mailing list talking
      about the subject, ask others from the list to help you
      out. </para> 
      -->
<para>第二に、他の人に査読してもらい、コメントをもらったり、事実に間違いが
ないか確認してもらってください。LDP が出す文書は、無数の Linux ユーザが
読むことになるので、事実の誤りは極力減らす必要があります。執筆対象に関して
大勢の人が参加するメーリングリストに登録しているなら、そこで他の人に
尋ねて、助けてもらいましょう。</para>
      <!--
      <para> Third, create a web site where you can distribute your
      documentation. This isn't required, but is helpful for people to
      find the original location of your document. </para> 
      -->
<para>第三に、作成した文書を公開するウェブサイトを作ってください。これは必須
ではありませんが、その文書がどこで作成されたのかを知る手がかりになります。
</para>

      <section id="validatecode">
        <title> <!--Validate your SGML code-->SGML コードの妥当性検査 </title>
        <!--
        <para> Using jade, or really the nsgmls command, you can
        validate your .sgml code against the DTD to make sure there
        aren't any errors. </para>
        -->
<para>jade や実際の nsgmls コマンドを使って、作成した .sgml コードが DTD 
に照らして妥当かどうか検査し、エラーのないことを確かめることができます。
</para>

        <screen>
<prompt>bash$</prompt> <command>nsgmls -s HOWTO-HOWTO.sgml</command>
</screen>

        <!--
        <para> If there are no issues, you'll just get your command
        prompt back. </para>
        -->
<para>これで問題がなければ、何事もなくコマンドプロンプトが返ってきます。</para>
      </section>
    </section>
    
    <section id="makingcopyright">
      <title> <!--Copyright and Licensing issues-->
                  著作権とライセンスの問題 </title>
      <!--
      <para> In order for an LDP document to be accepted by the LDP,
      it must be licensed to conform to the "LICENSE REQUIREMENTS"
      section of the LDP Manifesto located at <ulink
      url="http://www.linuxdoc.org/manifesto.html">
      http://www.linuxdoc.org/manifesto.html</ulink>.
      As an author, you may retain the copyright and add other
      restrictions (for example, you must approve any translations or
      derivative works). </para>
      -->
<para>LDP で LDP 文書として認められるには、<ulink 
url="http://www.linuxdoc.org/manifesto.html">
http://www.linuxdoc.org/manifesto.html</ulink> にある LDP マニフェスト
の " ライセンス上の必要事項 " に従ったライセンスが付いていなければなりません。
文書の作成者として、著作権を保持することができますし、ライセンスに他の
制限 (たとえば、翻訳や二次文書を作成したときは、著者の承認を得なければなら
ない、とか) を付け加えることもできます。</para>

      <!--
      <para> We recommend using the <ulink 
      url="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation 
      License (GFDL)</ulink> or the <ulink 
      url="http://opencontent.org/openpub/">Open Publication License 
      (OPL)</ulink> <emphasis>without</emphasis> options A and B.  If
      you choose, you can get DocBook markups up both the GNU GPL
      and the GNU FDL from <ulink 
      url="http://developer.gnome.org/projects/gdp/licenses.html">
      the GNOME Documentation Project</ulink>.  You can then merely
      include the license in its entirety in your document.  Due
      to its length, you may just want to provide a link
      to the source.</para>
      -->
<para>われわれとしては、<ulink url="http://www.gnu.org/copyleft/fdl.html">
GNU Free Documentation License (GFDL)</ulink> か、オプション A と B 
<emphasis>なし</emphasis>の <ulink url="http://opencontent.org/openpub/">
Open Publication License (OPL)</ulink> を使うことをお薦めします。
DocBook 用にマークアップされた GNU GPL と GNU FDL が <ulink 
url="http://developer.gnome.org/projects/gdp/licenses.html">GNOME 
Documentation Project</ulink> にあるので、それを使うこともできます。
その場合、ライセンス全文を文書内に入れるだけです。ただ、全文は長いので、
ライセンスへのリンクを書き込んでおくだけでも結構です。</para>

      <!--
      <para>If you choose to use a boilerplate copyright, simply copy it
      into your source code under a section called <quote>Copyright
      and Licenses</quote> or similar. Also include a copyright
      statement of your own (since you still own it). If you are a new
      maintainer for an already-existing HOWTO, you must include the
      previous copyright statements of the previous author(s) and the
      dates they maintained that document. </para> 
      -->
<para>著作権の「鋳型」を使おうとする場合は、<quote> 著作権とライセンス 
</quote>といったセクションを立てて、そこに文面をそのままコピーしてください。
御自分の名前で著作権の表示も入れてください。(ライセンスのために
著作権が奪われるわけではありません。) 既存の文書の新しい管理者になった
場合は、その文書を管理していた以前の著者名と日付についての著作権も
書かなければなりません。</para>

      <!--
      <para>You'll note that the licensing for the LDP Authoring Guide
      requires notification to the author of any derivative works or
      translations.  I also explicitly place any source code (aside
      from the SGML the Guide was written in) under the GPL. If your
      HOWTO includes bits of source code that you want others to use,
      you may do the same.</para>
      -->
<para>この LDP Author Guide のライセンスでは、二次文書や翻訳を作成する場合に
著者への報告を求めていることに、お気付きかもしれません。また、わたしは、(この
文書を書いた SGML のソースコードを除く) すべてのソースコードを明示的に GPL の
基に置きました。作成した HOWTO にソースコードが含まれていて、それを他の人
にも使ってもらおうと思うときは、同じようにするといいと思います。</para>
    </section>

    <section id="submission">
      <title> <!--Submission to LDP-->LDP への寄稿 </title>
      <!--
      <para> Once your LDP document has been carefully reviewed, you
      can release your document to the LDP. Send an e-mail with the
      SGML source code as an attachment (you may gzip it if you like)
      to <email>submit@linuxdoc.org</email>. </para> 
      -->
<para>LDP 文書のきめ細かい査読が済むと、その文書は LDP でリリースできます。
SGML ソースコードを添付して、(<email>submit@linuxdoc.org</email> 
にメールを送ってください。( gzip で圧縮しても結構です。)</para>

      <!--
      <para> Be sure to include the name of your HOWTO in the subject
      line, and use the body to outline changes you've made and attach
      your HOWTO. This allows the maintainers to do their jobs faster,
      so you don't have to wait for your HOWTO to be updated on the
      LDP web site. If you don't hear anything in 5 calendar days,
      please follow up with an e-mail to make sure things are still in
      process. </para> 
      -->
<para>メールの subject 欄には HOWTO の文書名を入れて、本文にはその HOWTO 
の変更点や書き足した点の概要を書いておくのを忘れないでください。これが
あると文書管理の作業時間が短縮できますし、送った HOWTO が LDP のウェブ
サイト上で更新されるのを待たなくて済みます。5 日間何の知らせもないときは、
もう一度メールを送って、まだ作業中なのかどうか確認してください。</para>

      <!--
      <para>If your HOWTO contains extras, such as graphics or a
      special catalog, create a.tar.gz file with all the files in it
      including the .sgml source code and mail it as an attachment to
      the ldp-submit list.</para>
      -->
<para>HOWTO にテキスト以外の画像や特別なカタログが含まれる場合、.sgml 
ソースコードを含む全ファイルを .tar.gz ファイルに固めて、メールに添付して 
submit メーリングリストまで送ってください。</para>

      <!--
      <para>If you are using the LDP CVS tree while developing
      your document, the LDP will still need to be notified when your
      document is ready to be published. E-mail should be sent to
      <email>submit@linuxdoc.org</email>. Indicate
      the title of your document and the relative path to the
      file(s) in the LDP CVS tree within your message. </para>
      -->
<para>文書の作成中に LDP CVS ツリーを使っている場合は、文書を公開する準備が
整ったときに再度 LDP へ報告する必要があります。その際は、<email>
submit@linuxdoc.org</email> にメールをお送りください。タイトルに
文書名を入れて、本文に LDP CVS ツリー内での相対パスを書いておいてください。
</para>
    </section>
    
    <section id="maintentance">
    <title><!--Maintaining Your HOWTO-->作成した文書の管理</title>

    <!--<para>
      Just because your HOWTO has now been published doesn't mean your
      job is done. HOWTOs need regular maintenance, to make sure they
      are up to date, and to improve them in response to readers' ideas
      and suggestions. A HOWTO is a living, growing body of knowledge,
      not just a publish-and-forget-it static document.
    </para>-->
<para>作成した HOWTO が公開されたからといって、仕事が全部終わったわけでは
ありません。HOWTO の情報を更新し、読者のアイデアや提案に応えて HOWTO を確実に
改善していくためには、定期的なメインテナンスが不可欠です。HOWTO には、
活発に成長する生きた知識が詰まっているので、公開したらそれで終わりという
固定的なものではありません。
</para>

    <!--<para>
      You put your email address in the HOWTO, and politely requested
      feedback from your readers, right? Once you are officially published,
      you will begin to receive notes with suggestions. Some will be
      very valuable; others will request personal assistance. You should
      feel free to decline personal assistance if you cannot spare the
      time. Writing a HOWTO for the LDP doesn't commit you to a lifetime
      of free support for anyone on the net. It is polite to refer
      questioners to another resource, if you can. And, if you see a
      pattern in the questions you receive, it might indicate a topic
      you should add to your HOWTO.
    </para>-->
<para>HOWTO に自分のメールアドレスを書いて、読者からのフィードバックを
丁寧にお願いしたでしょうか？ 一旦正式に公開されると、提案のメールをいくつも
受け取るようになります。そのなかにはとても貴重なものがありますが、それ以外は
個人的な問題の解決を求めるものだったりします。時間がなければ、個人的な問題に
応える必要は全くありません。LDP で HOWTO を書いたからといって、ネット上の
あらゆる人にフリーサポートを生涯続ける義務を負うわけではないからです。ただ、
もしできるなら、そうした人に別の情報源を教えてあげると、親切ではあります。
また、受け取った質問のパターンが見えてくれば、HOWTO に追加すべきトピックが
分かるかもしれません。
</para>

    </section>
  </chapter>
  
  <chapter id="faq">
    <title> <!--FAQs about the LDP-->LDP についての FAQ </title>

    <qandaset defaultlabel="qanda">
    <qandaentry>
      <question>
        <para><!--I want to help the LDP. How can I do this?-->
              LDP のお手伝いをしたいのですが、どうしたらいいでしょう？
              </para>
      </question>
      <answer>
      <!--
      <para> The easiest way is to find something and document
      it. Also check the unmaintained HOWTOs and see if there is a
      subject there that you know about and can continue
      documenting. </para>
      -->
<para>一番簡単な方法は、何か主題を捜して、それを文書化することです。
もしくは、管理者がいない HOWTO をチェックして、自分がよく知っている
分野で文書化し続けられるものがないか確認することです。</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <!--
        <para> I want to publish a collection of LDP documents in a
        book. How is the LDP content licensed? </para>
        -->
<para>LDP 文書をまとめて、書籍として出版したいのですが、LDP 文書のライセンスは
どういったものになりますか？</para>
      </question>
      <answer> 
        <!--
        <para> Please see <ulink
      url="http://www.linuxdoc.org/COPYRIGHT.html">
      http://www.linuxdoc.org/COPYRIGHT.html</ulink>.
        Note that this is only a guideline to authors. However, the
        licensing cannot be more restrictive than what is listed in that
        URL. </para>
        -->
<para><ulink url="http://www.linuxdoc.org/COPYRIGHT.html">
http://www.linuxdoc.org/COPYRIGHT.html"</ulink> をご覧ください。
ただ、これは個々の著者に対するガイドラインでしかないことに注意してください。
とはいえ、この URL に挙がっているものより厳しい条件を付けることはできません。
</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para><!-- I found an error in an LDP document. Can I fix it? -->
              LDP 文書の中に誤りを見つけたのですが、修正できますか？
       </para>
      </question>
      <answer>
        <!--
        <para> Contact the author of the document, or the LDP
        coordinator at <email>discuss@linuxdoc.org</email> and
        mention the problem and how you think it needs to be
        fixed. </para>
        -->
<para>文書の著者か、LDP コーディネータ <email>discuss@linuxdoc.org
</email> 宛に連絡して、問題の部分と、どういう修正が必要が必要かを報告して
ください。</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <!--
        <para>But I don't know SGML/Can't get the tools working/Don't
        like SGML</para>
        -->
<para>SGML が分かりません。/ ツールが動きません。/ SGML が嫌いです。</para>
      </question>
      <answer>
        <!--
        <para> That's okay.  You have the option of writing your first
        draft of the HOWTO in the format of your choice, then submit
        that to the LDP.  An LDP volunteer will review the document,
        then convert it into DocBook for you.  Once that's done,it will
        be easier for you to maintain the HOWTO.  If you run into
        questions,you can always drop a line to the LDP volunteer or the
        LDP Docbook list
        at <email>docbook@linuxdoc.org</email>.</para> 
        -->
<para>問題ありません。最初の草稿は、お好きなフォーマットで書いていただいて
結構ですので、それを LDP までお送りください。LDP ボランティアが査読して、
その後で DocBook に変換します。それさえ済めば、HOWTO の管理自体は難しく
ないでしょう。疑問があれば、いつでも LDP ボランティアに連絡するか、
LDP DocBook メーリングリスト <email>docbook@linuxdoc.org</email> 
まで連絡してください。</para>
      </answer>
    </qandaentry>
    </qandaset>
  </chapter> 

&glossary;

&doc-index;

</book>
