<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article id="index">

<artheader>

<!--O
   <title>A Practical Introduction to DocBook</title>
-->
   <title>実用 DocBook 入門</title>

   <authorgroup>
      <author>
        <firstname>Deb</firstname>
        <surname>Richardson</surname>
      <affiliation>
         <orgname>Open Source Writers Group</orgname>
         <address>
            <email>deb@oswg.org</email>
         </address>
      </affiliation>
      </author>
      <othercredit role="translator">
        <firstname>The Linux JF Project</firstname>
        <contrib>日本語訳</contrib>
        <affiliation>
          <address>
            <email>JF@linux.or.jp</email>
          </address>
        </affiliation>   
      </othercredit>
   </authorgroup>

   <revhistory>
      <revision>
         <revnumber>0.1</revnumber>
         <date>Nov 14 1999</date>
         <authorinitials>dlr</authorinitials>
         <revremark>Initial, incomplete, draft</revremark>
      </revision>
      <revision>
         <revnumber>0.1.j-1</revnumber>
         <date>Feb 19 2000</date>
         <revremark>First try to translation</revremark>
      </revision>
   </revhistory>

   <abstract>

<para>
<!--O
A practical introduction to using DocBook, written with the new user in
mind.  Over time, this will grow to include a task-based tag reference
and many more examples.
-->
これは DocBook の使い方の実用的な入門書であり，初心者を念頭に置いて
書かれています．将来的にはこの文書は実作業に基づいたタグのリファレンス
や，より多くの例を含むようになるでしょう．
</para>

   </abstract>

</artheader>

<sect1 id="copyright">
<!--O
<title>Copyright and Licensing</title>
-->
<title>著作権とライセンスについて</title>
<para>
Copyright (c) 1999 by Deb Richardson.  This material may be distributed
only subject to the terms and conditions set forth in the Open
Publication License, v0.4 (8 June 1999) or later (the latest version of
which is available at <ulink
url="http://www.opencontent.org/openpub/">http://www.opencontent.org/openpub/</ulink>).
</para>
<para>
<!--O
The current "master" copy of this document can be obtained through the
Open Source Writers Group website at <ulink
url="http://www.oswg.org">http://www.oswg.org</ulink>.
-->
この文書の現在の「マスター」の版は
<ulink url="http://www.oswg.org">http://www.oswg.org</ulink> にある
Open Source Writers Group の WWW サイトから入手できます．
</para>
</sect1>

<sect1 id="introduction">
<!--O
<title id="introduction.title">Introduction</title>
-->
<title id="introduction.title">はじめに</title>
<para>
<!--O
The Open Source Writers Group (OSWG - <ulink
url="http://www.oswg.org">http://www.oswg.org</ulink>) uses the DocBook
SGML Document Type Definition (DTD) as its standard "source" format for
all documentation, including books, articles, papers, FAQs, HOWTOs,
mini-HOWTOs, and more.
-->
Open Source Writers Group (OSWG - <ulink
url="http://www.oswg.org">http://www.oswg.org</ulink>) では，
DocBook という SGML Document Type Definition (DTD, 文書型定義) を
全ての文書の標準の「ソース」形式として使っています．ここでいう文書には
書籍，記事，論文，FAQ, HOWTO 文書，mini-HOWTO 文書などが含まれます．
</para>
<para>
<!--O
DocBook was chosen for a number of reasons -/- it's a very verbose DTD,
it covers almost every possible requirement for technical and other
forms of documentation, and it is quickly becoming the standard DTD for
open-source and open-content information.  There are also a number of
open-source tools available for processing DocBook instances, some of
which work quite well.  Additionally, Norman Walsh's modular DocBook
stylesheets are freely available, very complete, and under active
development.  All of these things make DocBook a compelling choice as a
standard SGML DTD. 
-->
DocBook が使われる理由はいろいろあります――DocBook は表現力のある DTD 
であり，技術文書やその他の文書に対するほとんど全ての要件を満たしており，
オープンソースやオープンコンテントの情報のための標準の DTD の地位を
急速に獲得しつつあります．また，DocBook のインスタンスを処理する
オープンソースのツールもたくさんあり，その中には非常にうまく動作するも
のもあります．さらに，Norman Walsh が作成した modular DocBook
stylesheets はフリーに入手できる上に非常に完成度が高く，開発も活発です．
これらの事情により，DocBook は標準の SGML DTD として注目すべき選択肢と
なっています．
</para>
<para>
<!--O
This document is a quick introduction to using DocBook to markup
documentation that is intended to be kept in the Open Source Writers
Group Concurrent Versions System (CVS).  This CVS is freely available
for any writer or group of writers who are working on free open-content
documentation of any sort.  For more information about the CVS system
and the OSWG documentation licensing policies, please visit the OSWG
website at <ulink url="http://www.oswg.org">http://www.oswg.org</ulink>.
-->
この文書は DocBook を使って文書をマークアップするための簡単な入門であ
り，Open Source Writers Group の CVS (協調バージョン管理システム) に入っ
ています．いかなる種類であれフリーのオープンコンテントな文書に関する
作業を行っている全ての著者や著者グループは，この CVS を自由に入手でき
ます．CVS システムと OSWG の文書ライセンスの方針について詳しく知りたけ
れば，<ulink url="http://www.oswg.org">http://www.oswg.org</ulink> に
ある OSWG の WWW サイトをご覧になってください．
</para>
<para>
<!--O
For a far more complete DocBook reference, visit <ulink
url="http://www.docbook.org">http://www.docbook.org</ulink>,
the home of the electronic versions of Norman Walsh's <citetitle>DocBook: The
Definitive Guide</citetitle> (published by O'Reilly <ulink
url="http://www.oreilly.com">http://www.oreilly.com</ulink>).  Better
yet, head on over to your local (real or virtual) bookshop and order a
printed version. If you're going to delve into the wonderful world of
DocBook, you will definitely get your money's worth out of Norman's
book.  
-->
より完全な DocBook のリファレンスについては
<ulink url="http://www.docbook.org">http://www.docbook.org</ulink> 
をご覧ください．このサイトは
Norman Walsh の
<citetitle>DocBook: The Definitive Guide</citetitle>
(O'Reilly <ulink url="http://www.oreilly.com">http://www.oreilly.com</ulink> 発行)
の電子版の一次サイトです．どうせなら近所の書店(実際の書店でも
バーチャルな書店でも)に行って書籍版を注文するとよいでしょう．DocBook 
の素晴らしい世界を深く知ろうと思っているなら，お金を払って Norman の本
を買う価値は絶対にあります．
</para>
<para>
<!--O
If you're new to markup languages, I recommend you read at least the
first two chapters of <citetitle>DocBook: The Definitive
Guide</citetitle>, as these give an overview of HTML, SGML, and XML, as
well as an introduction to the major concepts involved in doing
structural and semantic markup.
-->
マークアップ言語の初心者であれば，
<citetitle>DocBook: The Definitive Guide</citetitle>
の少なくとも最初の 2 つの章は読んでおくことをお勧めします．これらの章
では HTML, SGML, XML の概要と構造的・意味的なマークアップに関係する
主な概念の入門的な説明が書かれています．
</para>
</sect1>

<sect1 id="tools">
<!--O
<title>Tools</title>
-->
<title>ツール</title>
<para>
<!--O
There are two different types of tool related to SGML -/- the tools you
use to create SGML documents, and the tools you use to process SGML
documents.  These tools are very different, because they do completely
different things.
-->
SGML に関連するツールは大きく分けて 2 種類あります――SGML 文書を作る
ためのツールと，SGML 文書を処理するためのツールです．両者は大きく異な
る種類のツールです．というのも，まったく違うことをするツールだからです．
</para>

<sect2 id="authoringtools">
<!--O
<title>Authoring tools</title>
-->
<title>オーサリング用ツール</title>
<para>
<!--O
As mentioned in the <link linkend=introduction
endterm=introduction.title></link>, you don't really need any special
tools for creating or authoring DocBook documents.  In fact, at the
moment, your best bet is to use your favourite text editor.  DocBook
documents must be in plaintext ASCII, not in any special binary format.
Thus, you can use vi, emacs, notepad, textpad, or any other text editor
that allows you to produce plain ASCII output.
-->
「<link linkend=introduction endterm=introduction.title></link>」の節
で述べたように，DocBook の文書を作成するための特殊なツールは実は必要あ
りません．実際のところ，今の時点ではお気に入りのテキストエディタを使う
のがもっとも確実な方法です．DocBook の文書はプレーンテキストの ASCII 
ファイルでなければならず，特殊なバイナリフォーマットであってはなりませ
ん．したがって，vi, emacs, notepad, textpad が使えますし，プレーン 
ASCII ファイルが出力できればその他のどんなテキストエディタでも使えます．
</para>
<para>
<!--O
There are some tools being developed that will allow you to create
DocBook and other types of SGML documents without having to manually
type in all the markup tags.  At the moment, however, those tools are
not available, or if they are available, they're not all that reliable.
For now, it's recommended that you just use a text editor, and add your
own markup tags by hand.  It's a bit of a bother, but it's not
difficult.  The end result is definitely worth the time invested.
-->
手動でタグを打つことなく DocBook や他の種類の SGML 文書を作成できるよ
うなツールがいくつか開発中です．しかし現時点では，これらのツールは入手
できないか，あるいは入手可能であっても十分な信頼性を持っていません．
今のところは単にテキストエディタを使い，マークアップのタグは手動で追加
する方法がお勧めです．これは多少面倒ではありますが，難しくはありません．
得られる結果はきっと費した時間に見合うだけのものになります．
</para>
</sect2>

<sect2 id="processingtools">
<!--O
<title>Processing tools - DocBook Tools</title>
-->
<title>処理ツール ―― DocBook Tools</title>
<para>
<!--O
SGML processing tools are sets of scripts and programs that are used to turn
SGML documents into other output formats.  It is during this processing
that all formatting is added and the final versions of the documents are
created.
-->
SGML 処理ツールは，SGML 文書を他の形式に変換するために使うスクリプトと
プログラムのセットです．整形処理が行われて文書の最終版が生成されるのは，
この処理の段階です．
</para>
<para>
<!--O
The OSWG uses a package called "DocBook Tools" to process the DocBook
instances that are part of its documentation set.  This package includes
a set of scripts that simplify the use of a number of different
programs, making it very easy to create a variety of different output
formats, including HTML, PDF, PS, RTF, DVI, and TEX.
-->
OSWG では「DocBook Tools」というパッケージを使って文書群の一部の 
DocBook インスタンスを処理しています．このパッケージには
たくさんのプログラムの使用を簡略化するためのスクリプト群が含まれており，
HTML, PDF, PS, RTF, DVI, TeX を含む各種出力形式のファイルを簡単に作成
できます．
</para>

<sect3>
<!--O
<title>Getting DocBook Tools</title>
-->
<title>DocBook Tools の入手</title>
<para>
<!--O
You can get all the packages necessary for DocBook Tools at <ulink
url="http://sourceware.cygnus.com/docbook-tools/">http://sourcware.cygnus.com/docbook-tools/</ulink>.
-->
DocBook Tools に必要なパッケージ全ては
<ulink url="http://sourceware.cygnus.com/docbook-tools/">http://sourcware.cygnus.com/docbook-tools/</ulink>
から入手できます．
</para>
</sect3>

<sect3>
<!--O
<title>Installing DocBook Tools</title>
-->
<title>DocBook Tools のインストール</title>
<para>
<!--O
Unfortunately, installing and configuring DocBook Tools is (currently)
outside the scope of this document.  Refer to the DocBook Tools website
for help and documentation.  If you have problems, there is a DocBook
Tools mailing list called "docbook-tools-discuss" where you can get help
from other DocBook Tools users.  Subscription information is available
on the site.
-->
残念ながら，DocBook Tools のインストールと設定は(今のところ)この文書の
対象ではありません．作業の補助と文書については DocBook Tools の WWW ペー
ジを参照してください．何か問題があれば，"docbook-tools-discuss" という 
DocBook Tools のメーリングリストを利用してください．他の DocBooks
Tools ユーザからの手助けが得られることでしょう．購読に関する情報はこの
サイトにあります．
</para>
<para>
<!--O
If you cannot get the help you need on the docbook-tools-discuss list,
you can join the oswg-docbook mailing list, and ask there.  To
subscribe, send a message to the following address with "subscribe" in
the subject line of the message:
-->
docbook-tools-discuss メーリングリストで必要な手助けが得られなければ，
oswg-docbook メーリングリストに参加して，ここで質問してください．この
メーリングリストを購読するにはメールの Subject 行に "subscribe" と書い
たメールを以下のアドレス宛に送ってください:

<address><email>oswg-docbook-request@oswg.org</email></address>

</para>
</sect3>

<sect3>
<!--O
<title>Using DocBook Tools</title>
-->
<title>DocBook Tools の利用</title>
<para>
<!--O
Using DocBook Tools is exceedingly simple.  When you install the
packages, a series of scripts are added to <filename
class="directory">/usr/bin</filename>.  Each script turns your DocBook
document into a different output format.  The scripts are called:
-->
DocBook Tools の利用はとても簡単です．パッケージをインストールすると
パッケージ群が <filename class="directory">/usr/bin</filename> に
インストールされます．パッケージに含まれる各スクリプトは DocBook 文書
を別の出力形式に変換します．スクリプトには以下のようなものがあります:
</para>

<!--O
<itemizedlist>
<listitem>
<para><command>db2html</command> - DocBook to HTML</para>
</listitem>
<listitem>
<para><command>db2dvi</command> - DocBook to DVI</para>
</listitem>
<listitem>
<para><command>db2pdf</command> - DocBook to PDF</para>
</listitem>
<listitem>
<para><command>db2ps</command> - DocBook to PS</para>
</listitem>
<listitem>
<para><command>db2rtf</command> - DocBook to RTF</para>
</listitem>
</itemizedlist>
-->
<itemizedlist>
<listitem>
<para><command>db2html</command> - DocBook から HTML に変換</para>
</listitem>
<listitem>
<para><command>db2dvi</command> - DocBook から DVI に変換</para>
</listitem>
<listitem>
<para><command>db2pdf</command> - DocBook から PDF に変換</para>
</listitem>
<listitem>
<para><command>db2ps</command> - DocBook から PS に変換</para>
</listitem>
<listitem>
<para><command>db2rtf</command> - DocBook から RTF に変換</para>
</listitem>
</itemizedlist>

<para>
<!--O
Using these scripts is very simple, just type the script name on the
command line followed by the name of the DocBook file you want to
process.  For example:
-->
これらのスクリプトの使用方法は非常に簡単で，スクリプト名と処理したい 
DocBook ファイル名を単にコマンドライン上で指定するだけです．
たとえば以下のように指定します:
</para>

<programlisting>
$ db2html my-document.sgml
</programlisting>

<para>
<!--O
If you have any problems with this, you can ask for help on either of
the mailing lists mentioned above.
-->
これで何か問題があれば，先に紹介したどちらかのメーリングリストで質問す
るとよいでしょう．
</para>
</sect3>

</sect2>

</sect1>


<sect1 id="gettingstarted">
<!--O
<title>Getting Started</title>
-->
<title>はじめてみよう</title>
<para>
<!--O
Using the DocBook DTD to mark up your documentation doesn't require any
special tools at all.  An SGML file (usually having a .sgml or .sgm
filename extension) is actually just a plaintext ASCII file that
contains text interspersed with SGML "tags".  I strongly recommend that
you use your favourite text editor (vi, emacs, notepad, what have you)
for doing DocBook markup.  It's very important that the files are
plaintext ASCII, so using a full-blown wordprocessing system is not only
overkill, you might end up creating non-ASCII files.  Use a text editor,
it's still the best and simplest way.
-->
DocBook DTD を使って文書をマークアップするためには特殊なツールはまった
く必要ありません．SGML ファイル(普通は .sgml か .sgm という
ファイル名拡張子が付いています)は実は単なるプレーンテキストの ASCII
ファイルに過ぎず，テキスト中に SGML の「タグ」が散らばっているだけです．
筆者としては，読者の皆さんが DocBook のマークアップを行う際にはお気に
入りのテキストエディタ(vi, emacs, notepad など何でも)を使うことを強く
お勧めします．ファイルが ASCII 形式のプレーンテキストであることは非常
に重要です．したがって，本格的なワープロは機能が余計なだけではなく，
ASCII でないファイルを作ってしまうことがあります．ですからテキストエディタ
を使いましょう．これが最良かついちばん簡単な方法です．
</para>
<para>
<!--O
A document that has been marked up with DocBook looks a lot like HTML in
a lot of ways.  For example, here's a very simple HTML page:
-->
DocBook でマークアップされた文書は色々な点で HTML そっくりに見えます．
例えば，以下にごく簡単な HTML ページを示します:
</para>

<!--O
<programlisting>
<![CDATA[
<html>
<head>
<title>My HTML Page</title>
</head>
<body bgcolor="#000000">
<h1>This is a heading</h1>
<p>
This is the first paragraph of the HTML page.
</p>
<p>
This is the second paragraph of the HTML page.
</p>
</body>
</html>
]]>
</programlisting>
-->
<programlisting>
<![CDATA[
<html>
<head>
<title>HTML ページの例</title>
</head>
<body bgcolor="#000000">
<h1>これは見出しです</h1>
<p>
これは HTML ページの最初の段落です．
</p>
<p>
これは HTML ページの 2 番目の段落です．
</p>
</body>
</html>
]]>
</programlisting>

<para>
<!--O
Markup tags are the things that begin and end with the "<" and ">"
brackets.  A markup "start" tag, which indicates the beginning of an
"element" in the page just has the brackets, while an "end" tag,
indicating the end of an element, begins with a "</" combination.
Anything contained within a start and end tag of the same type is a
complete "element" within the page.
-->
マークアップタグは，"<" と ">" の括弧で括られた部分です．
マークアップの「開始」タグ(ページ内で「要素(element)」の始まりを表す)
は単に "<" と ">" の括弧で括られ，
「終了」タグ(要素の終わりを表す)は  "</" と ">" で括られます．
開始タグとその対になる終了タグに挟まれている部分は全て，
ページ内において完成した「要素」となります．
</para>
<para>
<!--O
So, what's an "element"?  A document element is simply a section of the
document that is defined by the tags which contain it.  For example, the
following is a complete HTML "H1" (heading level 1) element:
-->
では「要素」とは何でしょうか? 文書要素は単に文書内の項目であり，
項目を挟むタグによって定義されます．例えば HTML の完全な "H1" (見出し
レベル 1)要素を以下に示します:
</para>

<!--O
<programlisting>
<![CDATA[
<h1>This is a Level 1 Heading</h1>
]]>
</programlisting>
-->
<programlisting>
<![CDATA[
<h1>これはレベル 1 の見出しです</h1>
]]>
</programlisting>

<para>
<!--O
Elements can contain certain other elements, as defined by the DTD.  For
example, an HTML "body" element can contain headings, paragraphs, lists,
and a wide variety of others.  For example:
-->
要素は他の何らかの要素を含むこともできます．これは DTD によって定義さ
れます．例えば，HTML の "body" 要素は見出し(heading)，段落(paragraph)，
列挙(list)等の様々な要素を含みます．例を示します:
</para>

<!--O
<programlisting>
<![CDATA[
<body>
<h1>This is a Level 1 Heading</h1>
<p>
Here is a paragraph.
</p>
</body>
]]>
</programlisting>
-->
<programlisting>
<![CDATA[
<body>
<h1>これはレベル 1 の見出しです</h1>
<p>
これは段落です．
</p>
</body>
]]>
</programlisting>

<para>
<!--O
You will see that both the "h1" and "p" elements are contained by the
"body" element.
-->
この例では "h1" 要素と "p" 要素が "body" 要素に含まれているのが分かる
と思います．
</para>
<para>
<!--O
The similarities between HTML and DocBook SGML pretty much end here,
however.  HTML is a markup language that is used primarily to define the
formatting or appearance of the page when it is displayed in an HTML
browser.  HTML is also very informal in terms of how the tags fit
together and how strict the tag structure must be.
-->
しかし，HTML と DocBook SGML が似ている点はせいぜいこの程度です．
HTML は主に HTML ブラウザで表示した時のページの整形と見栄えを定義する
ために使われるマークアップ言語です．HTML はタグの組合せやタグが厳密に
持つべき構造についてはかなりいい加減です．
</para>
<para>
<!--O
DocBook SGML, however, is a markup language used to define the structure
of a document, rather than its formatting.  In DocBook there are no tags
that you can use to make an element "bold" or "italic".  Instead, you
mark up the document by defining _what_ is in each element, rather than
how each element should look.  Here's a very simple DocBook example:
-->
これに対して，DocBook SGML は文書の整形の仕方ではなく文書の構造を定義
するために使われるマークアップ言語です．DocBook には，要素を "bold" や 
"italic" にするためのタグはありません．その代わりに，各要素がどのよう
に見えるべきかではなく，各要素に「何が」入っているのかを定義することに
よって文書をマークアップしていきます．DocBook のごく簡単な例を以下に示
します:
</para>

<!--O
<programlisting>
<![CDATA[
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article>

   <artheader>
      <title>This is the Article Title</title>
   </artheader>

   <sect1>
      <title>This is a Level 1 Section Title</title>
      <para>
      This is the first paragraph.
      </para>
      <para>
      This is the second paragraph.
      </para>
   </sect1>

</article>
]]>
</programlisting>
-->
<programlisting>
<![CDATA[
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article>

   <artheader>
      <title>これは文章の題名です</title>
   </artheader>

   <sect1>
      <title>これはレベル 1 の章の題名です</title>
      <para>
      これは最初の段落です．
      </para>
      <para>
      これは 2 番目の段落です．
      </para>
   </sect1>

</article>
]]>
</programlisting>

<para>
<!--O
As you can see, there is no formatting information in this document.
-->
ご覧の通り，整形に関する情報は文書中にはありません．
</para>
<para>
<!--O
The "article" tags tell us that the document is an article.  All other
elements in the document are contained within this "root" element.  The
first pair of "title" tags indicate the article title, which is
contained in the "artheader" (article header) element.  The second set
of "title" tags, contained by the "sect1" element, indicate the title of
that section.
-->
"article" タグはその文書が article (記事)であることを表します．
文書中の他の全ての要素はこの「ルート(root, 根の)」要素に含まれます．
最初の "title" タグのペアは記事のタイトルを示し，このペアは
"artheader(article header)" 要素に含まれます．2 番目の "title" タグの
ペアは "sect1" 要素に含まれており，この節の題名を表します．
</para>
<para>
<!--O
So, what's that "DOCTYPE" tag at the very beginning?  That's the
"document type declaration" which is how we define what type of SGML
document this is and which DTD we're using for the markup.  You don't
have to understand the document type declaration, you just have to make
sure that it's at the top of all the documents you markup using DocBook.
You might have to change the word after "DOCTYPE", depending on what
sort of document you're creating: the example is an "article", but you
might want to create a "book", a "chapter", a "refentry", or something
else.  
-->
さて，一番最初にある "DOCTYPE" タグは何でしょうか? これは
「文書型定義(document type declaration)」といって，その文書が
どんな種類の SGML 文書であるかを定義する方法であり，マークアップのため
にどの DTD を使うかを示します．しかし，文書型定義の何たるかを理解しな
ければならないわけではなく，DocBook を使ってマークアップする全ての文書
の先頭に必ず置けばそれで十分です．作成する文書の種類によっては 
"DOCTYPE" の次の単語は変更する必要があるかもしれません――この例では 
"article" ですが，"book", "chapter", "refentry" その他を書いてもかまい
ません．
</para>
<para>
<!--O
In terms of the OSWG documentation set, the most common type of document
is an "article".  Articles include HOWTOs, mini-HOWTOs, magazine
articles, papers, and such.  An "article" is actually a general class of
document that has a certain length and structural complexity.  Unless
you're doing a manual page ("man" page) or a proper book, chances are
that your OSWG document will be an "article".  
-->
OSWG の文書群について見ると，もっとも多い文書の型は "article" です．
article は HOWTO, mini-HOWTO, 雑誌の記事，論文などを含みます．
"article" は実際には，ある程度決まった文章量と構造の複雑さをもった文書
に使うための一般的なクラスです．マニュアルページ("man" ページ)や普通の
書籍を書くのでなければ，あなたが OSWG の文書を書く時には "article" を
使う機会がいちばん多いでしょう．
</para>
</sect1>

<sect1 id="stepbystep">
<!--O
<title>Step by Step Example</title>
-->
<title>例題をステップ・バイ・ステップで学ぼう</title>
<para>
<!--O
Now we'll walk through the process of creating a simple DocBook article.
This example includes some of the most commonly used DocBook elements,
and is here mostly to show you what a document marked up with DocBook
looks like.
-->
さて，これから簡単な DocBook の文書を作成する手順を一通り眺めてみましょ
う．この例にはよく使われる DocBook の要素がいくつか含まれていますし，
DocBook でマークアップされた文書がどう見えるかもだいたいわかります．
</para>
<para>
<!--O
If you're looking for a more complete list of DocBook elements and their
uses, see the <link linkend=elementref endterm="elementref.title"></link>, or
Norman Walsh's <citetitle>DocBook: The Definitive Guide</citetitle>,
available at <ulink
url="http://www.docbook.org">http://www.docbook.org</ulink>.
-->
DocBook の要素とその使い方のもっときちんとした一覧が欲しければ，
<link linkend=elementref endterm="elementref.title"></link>
または
Norman Walsh の <citetitle>DocBook: The Definitive Guide</citetitle>
を見てください．後者は
<ulink url="http://www.docbook.org">http://www.docbook.org</ulink>
で入手できます．
</para>

<sect2 id="step1">
<!--O
<title>Step 1: Including the Document Type Declaration</title>
-->
<title>ステップ 1: 文書型定義(DTD)を含める</title>
<para>
<!--O
Assuming that you're marking up an "article", the first thing you have
to have in your document is the document type declaration:
-->
"article" をマークアップするものとして，文書に最初に入れるべきものは文
書型定義です．
</para>

<programlisting>
<![CDATA[
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
]]>
</programlisting>
</sect2>

<sect2 id="step2">
<!--O
<title>Step 2: Adding a "root" element</title>
-->
<title>ステップ 2: 「ルート」要素の追加</title>
<para>
<!--O
After that, you have to define the "root" element, which will contain
all the other elements in your document.  For an article, the root
element is simply "article".  So, add that, and its end tag after the
document type declaration:
-->
その次は，「ルート」要素を定義しなければなりません．ルート要素は
文書中の他の要素を全て含みます．article の場合は，ルート要素はそのまま
"article" となります．したがって，文書型定義の後に "article" タグと
その終了タグを追加します．
</para>

<programlisting>
<![CDATA[
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article>

</article>
]]>
</programlisting>

<para>
<!--O
Everything else you add to your document will be contained within the
"article" tags, so when you're done, the last tag in your document
should be "<literal><![CDATA[</article>]]></literal>".
-->
文書に追加される他の全ての要素は "article" タグに含まれるので，
文書が完成した時には，文書の最後のタグは
"<literal><![CDATA[</article>]]></literal>" 
になるはずです．
</para>
</sect2>

<sect2 id="step3">
<!--O
<title>Step 3: Adding an article header</title>
-->
<title>ステップ 3: article ヘッダの追加</title>
<para>
<!--O
Next, you'll want to add some "header" information.  Header information
includes the article's title, the author's name and email address, the
revision history of the document, and lots of other stuff.  For now,
we'll just add the article title and the author name.
-->
次は「ヘッダ」情報をいくつか追加するとよいでしょう．ヘッダ情報には文書
の題名，著者の名前やメールアドレス，文書の版の履歴などが含まれます．
今のところは，文書の題名と著者の名前を追加するだけにしておきましょう．
</para>

<!--O
<programlisting>
<![CDATA[
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article>

<artheader>
   <title>How I Spent My Summer Vacation</title>
   <author>
      <firstname>Deb</firstname>
      <surname>Richardson</surname>
   </author>
</artheader>

</article>
]]>
</programlisting>
-->
<programlisting>
<![CDATA[
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article>

<artheader>
   <title>夏休みの思い出</title>
   <author>
      <firstname>Deb</firstname>
      <surname>Richardson</surname>
   </author>
</artheader>

</article>
]]>
</programlisting>
</sect2>

<sect2 id="step4">
<!--O
<title>Step 4: Adding a first level sectioin</title>
-->
<title>ステップ 4: 最初のレベルの節の追加</title>
<para>
<!--O
So, now that we have some header information added, lets actually add
some content in a level 1 section with a title:
-->
ヘッダ情報の追加ができたら，次はレベル 1 セクションの内容を題名付きで
書き加えましょう．
</para>

<!--O
<programlisting>
<![CDATA[
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article>

<artheader>
   <title>How I Spent My Summer Vacation</title>
   <author>
      <firstname>Deb</firstname>
      <surname>Richardson</surname>
   </author>
</artheader>

<sect1>
<title>The Month of May</title>
<para>
My summer vacation started on May 14th, right after graduation.  Being a
new, unemployed, and highly-debt-ridden university graduate, I decided
that I should probably get a job.  I spent the vast majority of May
padding my resume with all sorts of impressive-sounding yet terribly
obscure skills and accomplishments, and sending those out to any company
whose name appeared in the phone book.
</para>
</sect1>

</article>
]]>
</programlisting>
-->
<programlisting>
<![CDATA[
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article>

<artheader>
   <title>夏休みの思い出</title>
   <author>
      <firstname>Deb</firstname>
      <surname>Richardson</surname>
   </author>
</artheader>

<sect1>
<title>5 月</title>
<para>
ぼくの夏休みは 5 月 14 日に始まった．卒業式のすぐ後だ．
大学を卒業したのはいいけれど仕事がなく，かなり借金もあったので，ぼくは
たぶん就職しなきゃいけないと思った．5 月のほとんどは，すごそうに聞こえ
るけれどひどく曖昧な技術や業績を履歴書に書き連ね，それを電話帳に載って
いる会社に片っ端から送り付けて過ごした．
</para>
</sect1>

</article>
]]>
</programlisting>

<para>
<!--O
I think you're probably getting the hang of it at this point.  
-->
たぶん，そろそろコツが分かってきたのではないかと思います．
</para>
</sect2>

<sect2 id="step5">
<!--O
<title>Step 5: Adding subsections and sub-subsections</title>
-->
<title>ステップ 5: サブセクションとサブサブセクションの追加</title>
<para>
<!--O
Adding subsections and sub-subsections is also simple.  A second level
section starts and ends with "sect2" tags, third level with "sect3", and
so on.  The standard DocBook DTD only supports up to a level 5 section,
so there are no "sect6", "sect7" or higher tags.  Unless you're doing a
massively long and professional book, however, you probably won't need
more than 5 section levels.  
-->
サブセクションやサブサブセクションの追加も簡単です．2 レベルの
セクションは "sect2" タグで開始・終了し，3 レベルのセクションは
"sect3" タグで開始・終了します．それ以降も同じです．
標準の DocBook DTD は 5 レベルまでのセクションにしか対応していないので，
"sect6", "sect7" やそれ以降のタグはありません．しかし，非常に長くて専
門的な本を書かない限りは，5 レベルを超えるセクションが必要になることは
たぶんないでしょう．
</para>
<para>
<!--O
Each section level should be contained within a higher level, so level 2
sections should be contained by level 1 sections, and so on.  Here's an
example:
-->
各レベルのセクションは自身より高いレベルのセクションに含まれていなけれ
ばなりません．したがって，レベル 2 セクションはレベル 1 のセクションに
含まれていなければなりません．他も同じです．以下に例を示します:
</para>

<!--O
<programlisting>
<![CDATA[
<sect1>
<title>The Month of May</title>
<para>
My summer vacation started on May 14th, right after graduation.  Being a
new, unemployed, and highly-debt-ridden university graduate, I decided
that I should probably get a job.  I spent the vast majority of May
padding my resume with all sorts of impressive-sounding yet terribly
obscure skills and accomplishments, and sending those out to any company
whose name appeared in the phone book.
</para>

<sect2>
<title>My Resume</title>
<para>
My resume was 4 pages long, and mostly contained notes about my
education and employment history, which was sparse, at best.
</para>

<sect3>
<title>Employment History</title>
<para>
Most of the jobs I've ever had have been in the food service industry.
Like most aspiring writers, I spent most of my formative years wiping
tables and grumbling about lousy tips.
</para>
</sect3>

</sect2>

</sect1>
]]>
</programlisting>
-->
<programlisting>
<![CDATA[
<sect1>
<title>5 月</title>
<para>
ぼくの夏休みは 5 月 14 日に始まった．卒業式のすぐ後だ．
大学を卒業したのはいいけれど仕事がなく，かなり借金もあったので，ぼくは
たぶん就職しなきゃいけないと思った．5 月のほとんどは，すごそうに聞こえ
るけれどひどく曖昧な技術や業績を履歴書に書き連ね，それを電話帳に載って
いる会社に片っ端から送り付けて過ごした．
</para>

<sect2>
<title>ぼくの履歴書</title>
<para>
ぼくの履歴書は 4 ページで，主にぼくの学歴と職歴を書いていた．
この履歴書はどう見ても貧弱だった．
</para>

<sect3>
<title>職歴</title>
<para>
ぼくがしたことがある仕事はほとんどが外食産業だった．
志の高い作家の多くと同じように，ぼくは成長期のほとんどを机を拭くことと
ケチなチップに文句を言うことで過ごした．
</para>
</sect3>

</sect2>

</sect1>
]]>
</programlisting>

<para>
<!--O
As you can see, this example ends with three end tags -/- each section
level is contained or "nested" within the higher level.
-->
見ての通り，この例は 3 つの終了タグで終わっています――各レベルの
セクションは，高いレベルのセクションに含まれています．つまり「入れ子」
になっています．
</para>
</sect2>

</sect1>

<sect1 id="elementref">
<!--O
<title id="elementref.title">Element Reference</title>
-->
<title id="elementref.title">要素のリファレンス</title>
<para>
<!--O
The following is a short and incomplete guide to the most commonly used
DocBook elements.  I'm adding to this list as I find I need the
elements, so expect this section to grow and evolve over time.  Keep in
mind that I'm pretty new to this whole DocBook thing, too, and I cannot
guarantee that I'm using all of the elements as intended.  In other
words: everything in this book may be wrong ;>
-->
DocBook 要素のうちよく使われるものを以下で説明します．ただし，説明は
簡単かつ不十分です．必要と思うタグが見つかればリストに追加するつもりな
ので，この節はこの先大きくなっていくことでしょう．筆者自身もまだ 
DocBook の初心者であり，全ての要素を思った通りに使えている保証はない点
に注意してください．言い換えれば，この文書の内容は全部間違っているか
もしれません ;->
</para>

<sect2 id="artheader">
<!--O
<title>Article header elements</title>
-->
<title>article ヘッダ要素</title>
<para>
<!--O
Any DocBook "article" should include an article header.  The article
header contains information such as the article title, author, revision
history, abstract, and so forth.  
-->
DocBook の全ての "article" 文書は article ヘッダを含んでいなければなり
ません．article ヘッダには文書の題名，著者，版の履歴や文書の概要などが
含まれます．
</para>

<sect3>
<!--O
<title>Article header</title>
-->
<title>article ヘッダ</title>
<para>
<!--O
<sgmltag class="element">artheader</sgmltag>: the "artheader"
element contains all of the other elements that make up the article
header.
-->
<sgmltag class="element">artheader</sgmltag>: "artheader" 要素には，
article ヘッダを構成する他の要素が全て含まれています．
</para>
</sect3>

<sect3>
<!--O
<title>Article title</title>
-->
<title>article の題名</title>
<para>
<!--O
<sgmltag class="element">title</sgmltag>: the "title" element contained
in the article header defines the article title.  So, if you're writing
an article called <emphasis>101 Stupid Ferret Tricks</emphasis>, your
article header would look like this:
-->
<sgmltag class="element">title</sgmltag>: article ヘッダに含まれる 
"title" 要素は文書の題名を定義します．したがって，
<emphasis>101 Stupid Ferret Tricks</emphasis>
という文書を書いているのであれば，article ヘッダは以下のようになるでしょ
う:
</para>

<programlisting>
<![CDATA[
<article>
   <artheader>
      <title>101 Stupid Ferret Tricks</title>
   </artheader>

...

</article>
]]>
</programlisting>
</sect3>

<sect3>
<!--O
<title>Author information</title>
-->
<title>著者に関する情報</title>
<para>
<!--O
<sgmltag class="element">author</sgmltag> is the element which contains
all of your author-related information, including first name, surname,
email address, organizational affiliation, etc.  Each of these pieces of
information is marked up separately within the "author" element, which
might seem like a bit of a pain, but it's worth it.  The more
comprehensive the markup, the more we can do with the information when
processing the document.
-->
<sgmltag class="element">author</sgmltag> は著者に関連する全ての情報を
含む要素です．この情報には著者の姓や名前，メールアドレス，所属組織など
が含まれます．これらの情報は別々の "author" 要素としてマークアップされ
ます．これはちょっと面倒に見えますが，そうする価値はあります．
マークアップが包括的になればなるほど，文書を処理した時に得られる情報も
多くなります．
</para>
<para>
<!--O
All that aside, here's an example of an article header that contains an
author's first name, surname, organizational affiliation, and email
address.  Usually all you need is the name and email address, and
there's other stuff you can add.  For now, we'll keep it simple:
-->
とりあえず著者の姓と名前，所属組織，メールアドレスを含む article ヘッ
ダの例を示しましょう．普通必要なのは名前とメールアドレスだけですが，
他の情報があってもかまいません．今のところは簡単に行きましょう:
</para>

<programlisting>
<![CDATA[
<article>
   <artheader>
      
      ...

      <author>
         <firstname>Deb</firstname>
         <surname>Richardson</surname>
         <affiliation>
            <orgname>Open Source Writers Group</orgname>
            <address>
               <email>deb@oswg.org</email>
            </address>
         </affiliation>
      </author>

      ...
   
   </artheader>

...

</article>
]]>
</programlisting>
</sect3>

<sect3>
<!--O
<title>Revision information</title>
-->
<title>文書の版に関する情報</title>
<para>
<!--O
Most technical documentation goes through a series of revisions as the
writer improves and updates the document.  In order that readers know
which version of a document s/he is reading, technical documentation
often includes a revision number and other information.  In a DocBook
article, the revision information is part of the article header, and is
contained in the <sgmltag class="element">revhistory</sgmltag> element.
Here's an example:
-->
ほとんどの技術文書は，著者が文書を改善・更新するたびに版が増えていきま
す．読者に文書の版が分かるようにするため，技術文書には版数やその他の
情報が含まれていることがよくあります．DocBook の article では
版に関する情報は article ヘッダの一部であり，
<sgmltag class="element">revhistory</sgmltag> 要素に含まれます．
以下に例を示します:
</para>

<programlisting>
<![CDATA[
<article>
   <artheader>

      ...

      <revhistory>

         <revision>
            <revnumber>0.1</revnumber>
            <date>19 June 1999</date>
            <authorinitials>dr - deb@oswg.org</authorinitials>
            <revremarks>
               First draft, incomplete
            </revremarks>
         </revision>

         <revision>
            <revnumber>0.2</revnumber>
            <date>20 Sept 1999</date>
            <authorinitials>dr</authorinitials>
            <revremarks>
               Updated section 14, added section 11.5
            </revremarks>
         </revision>
   
      </revhistory>

      ...

   </artheader>

...

</article>
]]>
</programlisting>

</sect3>

<sect3>
<!--O
<title>Article abstract</title>
-->
<title>文書の要約</title>
<para>
<!--O
Many people write abstracts for their articles, which are short
summaries, usually no more than a paragraph long, that tell the reader
just what the article is about.  In a DocBook article, the abstract is
part of the article header, contained in an <sgmltag
class="element">abstract</sgmltag> element.  
-->
多くの人は文章に要約を付けます．要約は普通は 1 段落の長さを超えること
がない短いまとめであり，文書の内容を読者に示します．DocBook の article 
では要約は article ヘッダの一部であり，
<sgmltag class="element">abstract</sgmltag> 要素に含まれます．
</para>

<!--O
<programlisting>
<![CDATA[
<article>
   <artheader>

   ...

      <abstract>
         <para>
            This article describes the steps that are performed to boot
            the Linux kernel. While this kind of information is not
            relevant to the system's functionality, it's interesting to
            see how the different architectures bring the system up.
         </para>
      </abstract>

   ...

   </artheader>

...

</article>
]]>
</programlisting>
-->
<programlisting>
<![CDATA[
<article>
   <artheader>

   ...

      <abstract>
         <para>
            この文書は Linux カーネルを起動する際に行われる手順を説明
            します．この種の情報はシステムの機能には関係ありませんが，
            様々なアーキテクチャにおいてシステムを起動させる方法は興味
            深いと思われます．
         </para>
      </abstract>

   ...

   </artheader>

...

</article>
]]>
</programlisting>

</sect3>
   
</sect2>

<sect2 id="code">
<!--O
<title>Marking up code, filenames, commands, and the like</title>
-->
<title>プログラム，ファイル名，コマンド等のマークアップ</title>
<para>
<!--O
If you're doing computer-related documentation or writing, chances are
that you're going to have to use code samples, filenames, commands, and
other computer-centric things in your document.  DocBook, being designed
for doing technical documentation, provides tags for marking each of
these up as a specific type of element.
-->
コンピュータ関連の書類や文書を書く際には，プログラムの例やファイル名，
コマンド，その他のコンピュータ関係の言葉を文書内で書かなければならない
ことがよくあるでしょう．DocBook は――技術文書を書くために設計されてい
るので――こういった言葉を専用の要素としてマークアップするためのタグを
持っています．
</para>

<sect3>
<!--O
<title>Code samples</title>
-->
<title>プログラムの例</title>
<para>
<!--O
When you want to include a multiple-line code example in your document,
you should use the <sgmltag class="element">programlisting</sgmltag>
tag.  Here's an example that's part of a level 1 section:
-->
複数行に渡るプログラムの例を文書に入れる時は
<sgmltag class="element">programlisting</sgmltag> タグを使います．
レベル 1 セクションの一部として使う例を示します:
</para>

<!--O
<programlisting>
<![CDATA[
<sect1>
<para>
Here's an example:
</para>

<programlisting>
if [ $# -eq 1 ]
then
  if [ ! -r $1 ]
  then
    echo Cannot read \"$1\".  Exiting. >&2
    exit 1
  fi
fi
</programlisting>

</sect1>
]]>
</programlisting>
-->
<programlisting>
<![CDATA[
<sect1>
<para>
例を示します:
</para>

<programlisting>
if [ $# -eq 1 ]
then
  if [ ! -r $1 ]
  then
    echo Cannot read \"$1\".  Exiting. >&2
    exit 1
  fi
fi
</programlisting>

</sect1>
]]>
</programlisting>

<para>
<!--O
The <sgmltag class="element">programlisting</sgmltag> tag is usually
processed so the output will be rendered with all whitespace and
formatting preserved, done in a fixed-width font, such as courier.
-->
<sgmltag class="element">programlisting</sgmltag> タグは普通，
空白文字や整形の状態が保存されたままレンダリングされるように処理されま
す．また，クーリエ等の固定幅フォントが使われます．
</para>
<para>
<!--O
If you want to include an example of SGML, XML, or HTML in your
document, you have to use a special bit of markup that tells the parser
to ignore any tags it contains.  This special bit of markup is a CDATA
marker, the beginning of which appears directly after the <sgmltag
class="element">programlisting</sgmltag> start tag, and which ends just
before the <sgmltag class="element">programlisting</sgmltag> end tag:
-->
SGML, XML, HTML の例を文書に入れる場合には，その中に含まれるタグを
パーザが無視するように少し特殊なマークアップを行う必要があります．
この特殊なマークアップとは CDATA マーカといって，
<sgmltag class="element">programlisting</sgmltag> 開始タグの後に直接表
れて <sgmltag class="element">programlisting</sgmltag> 終了タグの直前で
終わります．
</para>

<!--O
<programlisting>
<![CDATA[

<programlisting>
<![CDATA[

<html>
<head>
<title>Web Page Title</title>
</head>

<body bgcolor="#ffffff">
Web Page Content
</body>
</html>
]]>

]]<!>>
<![CDATA[
</programlisting>

]]>
</programlisting>
-->
<programlisting>
<![CDATA[

<programlisting>
<![CDATA[

<html>
<head>
<title>WWW ページのタイトル</title>
</head>

<body bgcolor="#ffffff">
WWW ページの内容
</body>
</html>
]]>

]]<!>>
<![CDATA[
</programlisting>

]]>
</programlisting>

<para>
<!--O
Note that the beginning of the CDATA marker is
"<literal><<!>![CDATA[</literal>", and the end of the CDATA marker is
"<literal>]]<!>></literal>".  Any markup contained between the beginning
and end bits of a CDATA marker will be ignored by the processing tools
and treated as if it were just part of the regular text.
-->
CDATA マーカの始まりは "<literal><<!>![CDATA[</literal>" であり，CDATA 
マーカの終わりは "<literal>]]<!>></literal>" である点に注意してください．
始まりと終わりの CDATA マーカに挟まれた全てのマークアップは処理ツール
に無視され，単に普通のテキストの一部であるかのように扱われます．
</para>

</sect3>

<sect3>
<!--O
<title>Filenames and directories</title>
-->
<title>ファイル名とディレクトリ</title>
<para>
<!--O
Appropriately enough, in DocBook you markup filenames with a <sgmltag
class="element">filename</sgmltag> tag.  You mark up directories with
the same tag, only by adding <literal>class="directory"</literal> as
an attribute.  For example:
-->
DocBook 内ではファイル名は <sgmltag class="element">filename</sgmltag> 
を使って十分にマークアップしてください．
ディレクトリも同じタグでマークアップしますが，属性として
<literal>class="directory"</literal> を追加してください．
以下のようにします:
</para>

<!--O
<programlisting>
<![CDATA[

<para>
When you install DocBook Tools a number of files are added to 
<filename class="directory">/usr/bin</filename>, including
<filename>db2html</filename>, and <filename>db2pdf</filename>.
</para>

]]>
</programlisting>
-->
<programlisting>
<![CDATA[

<para>
DocBook Tools をインストールする際には，たくさんのファイルが
<filename class="directory">/usr/bin</filename> にインストールされます．
インストールされるファイルは
<filename>db2html</filename> や <filename>db2pdf</filename>
等です．
</para>

]]>
</programlisting>
</sect3>

<sect3>
<!--O
<title>Commands</title>
-->
<title>コマンド</title>
<para>
<!--O
When you want to mark up a command or command line, use the
intuitively-named <sgmltag>command</sgmltag> tag.  For example:
-->
コマンドやコマンド行をマークアップする時には，見たままの名前の
<sgmltag>command</sgmltag> タグを使います．使い方は以下の通りです:
</para>

<!--O
<programlisting>
<![CDATA[

<para>
When you want to generate HTML output from your DocBook instance, use
the <command>db2html</command> command from the command line.
</para>

]]>
</programlisting>
-->
<programlisting>
<![CDATA[

<para>
HTML 出力を DocBook インスタンスから得たい時には，コマンド行から
<command>db2html</command> コマンドを使ってください．
</para>

]]>
</programlisting>

<para>
<!--O
Often, commands include more than one part, some of which, in
documentation, are actually "replaceable", meaning that they indicate
something that can be replaced or modified by the user who is typing the
command.  For example:
-->
コマンドが複数個の部分からできていて，その一部が実際には文書中で
「置き換え可能」なことがよくあります．つまり，コマンドを入力するユーザ
が置き換えたり変更したりできる文字列を示す場合です．例を以下に示します:
</para>

<!--O
<programlisting>
<![CDATA[

<para>
When you want to generate HTML output from your DocBook instance, type
the following on the command line: <command>db2html
<replaceable>my-filename.sgml</replaceable></command>.
</para>

]]>
</programlisting>
-->
<programlisting>
<![CDATA[

<para>
HTML 出力を DocBook インスタンスから得たい時には，以下のコマンド行を入
力してください:
<command>db2html<replaceable>my-filename.sgml</replaceable></command>
</para>

]]>
</programlisting>

<para>
<!--O
You can also mark up command options or flags separately as well.
-->
コマンドのオプションやフラグも別々にマークアップできます．
</para>

<!--O
<programlisting>
<![CDATA[

<para>
If you want to generate HTML from your DocBook instance using a
different set of stylesheets, you can use the "-d" option on the command
line:
</para>

<programlisting>
<command>db2html <option>-d</option> </command>
</programlisting>

]]>
</programlisting>
-->
<programlisting>
<![CDATA[

<para>
異なるスタイルシート群を使って DocBook インスタンスから HTML を 生成し
たい場合には，コマンド行で "-d" オプションを使ってください:
</para>

<programlisting>
<command>db2html <option>-d</option> </command>
</programlisting>

]]>
</programlisting>

<para>
<!--O
To Be Continued
-->
この節の内容はさらに追加する予定です．
</para>

</sect3>

</sect2>

</sect1>

<sect1 id="wrapup">
<!--O
<title>Wrap-up & Further References</title>
-->
<title>まとめとさらなる参考文献</title>
<para>
<!--O
So, that's the very quick introduction to how DocBook works.  This
document will expand over time to include a reference of various tags
and what you should use them for, etc.  For now, I recommend that you
take a look at some of the <filename>*.sgml</filename> files that are
available through the OSWG website -/- with most things, the easiest way
to learn DocBook is by example.  You can find links to the OSWG
<filename>*.sgml</filename> files here: <ulink
url="http://www.oswg.org/oswg-nightly/">http://www.oswg.org/oswg-nightly</ulink>.
-->
さて，DocBook をどのように使うのかをごく簡単に見てきました．
この文書はこの先拡張し，様々なタグのリファレンスとこれらの使い方などを
増やしていきます．今のところは，OSWG の WWW サイトで入手できる
<filename>*.sgml</filename> をいくつか見ることをお勧めします――大抵の
場合，DocBook を覚える近道は例を見ることです．OSWG が持っている
<filename>*.sgml</filename> ファイルへのリンクは
<ulink url="http://www.oswg.org/oswg-nightly/">http://www.oswg.org/oswg-nightly</ulink>
にあります．
</para>
<para>
<!--O
I also recommend that you take the time to look at Norman Walsh's
<citetitle>Docbook: The Definitive Guide</citetitle>, the online version
of which is available through <ulink
url="http://www.docbook.org">http://www.docbook.org</ulink>.  
-->
また，筆者は Norman Walsh の
<citetitle>Docbook: The Definitive Guide</citetitle> 
を読むことをお勧めします．この書籍のオンライン版は
<ulink url="http://www.docbook.org">http://www.docbook.org</ulink>
から入手できます．
</para>
<para>
<!--O
If you have any questions or need further help, I invite you to
subscribe to the OSWG docbook discussion list.  Subscribe by sending
mail with <command>subscribe</command> in the subject line to:
-->
質問や助けが必要であれば，OSWG の docbook に関する議論用の
メーリングリストに参加するとよいでしょう．サブジェクト行に
<command>subscribe</command> と書いたメールを

<address>
<email>oswg-docbook-request@oswg.org</email>
</address>

宛に送ると購読できます．

</para>
</sect1>

<sect1 id="resources">
<!--O
<title>Other DocBook Resources</title>
-->
<title>DocBook に関する他の情報源</title>

<sect2 id="online">
<!--O
<title>Online Resources</title>
-->
<title>ネットワーク上の情報</title>
<para>
<!--O
TBD -/- list of online DocBook and SGML resources
-->
TBD -- DocBook と SGML に関するネットワーク上のリソースを列挙
</para>
</sect2>

<sect2 id="offline">
<!--O
<title>Offline Resources</title>
-->
<title>ネットワーク以外の情報</title>
<para>
TBD -- DocBook と SGML に関するネットワーク以外のリソースを列挙
</para>
</sect2>

</sect1>

<sect1 id="translation">
<title>日本語訳について</title>

<para>
日本語訳は Linux Japanese FAQ Project が行いました．
翻訳に関するご意見は JF プロジェクト
&lt;JF@linux.or.jp&gt;
宛に連絡してください．
</para>

<para>
改訂履歴を以下に示します．
</para>

<variablelist>
<varlistentry>
  <term>0.1.j-1, Feb 19 2000</term>
  <listitem>
    <variablelist>
    <varlistentry>
    <term>翻訳:</term>
    <listitem>
       <para>藤原 輝嘉 &lt;fujiwara@linux.or.jp&gt;</para>
    </listitem>
    </varlistentry>
    <varlistentry>
    <term>校正:</term>
    <listitem>
      <itemizedlist>
      <listitem>
        <para>武井 伸光 &lt;takei@cc.kochi-u.ac.jp&gt;</para>
      </listitem>
      <listitem>
        <para>佐野 武俊 &lt;kgh12351@nifty.ne.jp&gt;</para>
      </listitem>
      </itemizedlist>
    </listitem>
    </varlistentry>
    </variablelist>
  </listitem>
</varlistentry>
</variablelist>

</sect1>

</article>
