<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.

     Redistribution and use in source (SGML DocBook) and 'compiled' forms
     (SGML, HTML, PDF, PostScript, RTF and so forth) with or without
     modification, are permitted provided that the following conditions
     are met:

      1. Redistributions of source code (SGML DocBook) must retain the above
         copyright notice, this list of conditions and the following
         disclaimer as the first lines of this file unmodified.

      2. Redistributions in compiled form (transformed to other DTDs,
         converted to PDF, PostScript, RTF and other formats) must reproduce
         the above copyright notice, this list of conditions and the
         following disclaimer in the documentation and/or other materials
         provided with the distribution.

     THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
     IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
     OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
     DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
     INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
     (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
     SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
     ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
     POSSIBILITY OF SUCH DAMAGE.

     The FreeBSD Japanese Documentation Project

     Original revision: 1.25
     $FreeBSD$
-->

<!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
<!ENTITY % books.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Books Entity Set//EN">
%books.ent;
<!ENTITY % chapters SYSTEM "chapters.ent"> %chapters;
<!ENTITY % not.published "INCLUDE">
<!-- ENTITY index SYSTEM "index.sgml" -->
]>

<!--
訳:
さとけん@ForUs ken@forus.or.jp
-->

<book>
  <bookinfo>
    <title>新しい貢献者のための FreeBSD ドキュメンテーションプロジェクト入門</title>

    <corpauthor>FreeBSD ドキュメンテーションプロジェクト</corpauthor>

    <copyright>
      <year>1998</year>
      <year>1999</year>
      <year>2000</year>
      <year>2001</year>
      <year>2002</year>
      <year>2003</year>
      <year>2004</year>
      <holder role="mailto:doceng@FreeBSD.org">DocEng</holder>
    </copyright>

    <pubdate role="rcs">$FreeBSD$</pubdate>

    <releaseinfo>$FreeBSD$</releaseinfo>

    &bookinfo.legalnotice;

    <abstract>
      <para>FreeBSD
	ドキュメンテーションプロジェクトに参加してくださってありがとうございます。
	あなたの貢献は非常に価値のあることです。</para>

      <para>この入門では FreeBSD
	ドキュメンテーションプロジェクトへの貢献を始めるにあたって理解する必要のあること、
	すなわち(必須のものだけでなく、推奨されるものも含めた)ツールやソフトウェアの使い方から、
	ドキュメンテーションプロジェクトの方針にわたる内容のすべてを扱っています。</para>

      <para>この文書は発展途上にあり、まだ完成していません。
	まだ完成していない節の名前には
	<literal>*</literal>(アスタリスク) が付けてあります。</para>
    </abstract>
  </bookinfo>

  <preface id="preface">
    <title>まえがき</title>

    <sect1 id="preface-prompt">
      <title>シェルプロンプト</title>

      <para>以下の表は、
	標準のシステムプロンプトとスーパーユーザのプロンプト示しています。
	この文書であげる実例では、
	どちらのユーザでその例を実行すべきか示すためにこれらのプロンプトを使用します。</para>

      <informaltable frame="none">
	<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>ユーザ</entry>

	      <entry>プロンプト</entry>
	    </row>
	  </thead>

	  <tbody>
	    <row>
	      <entry>通常ユーザ</entry>

	      <entry>&prompt.user;</entry>
	    </row>

	    <row>
	      <entry><username>root</username></entry>

	      <entry>&prompt.root;</entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </sect1>

    <sect1 id="preface-convention">
      <title>表記上の慣例</title>

      <para>下の表は、
	この文書で使われる表記上の慣例を示しています。</para>

      <informaltable frame="none">
	<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>意味</entry>

	      <entry>例</entry>
	    </row>
	  </thead>

	  <tbody>
	    <row>
	      <entry>コマンド、ファイル、ディレクトリの名前および、
		コンピュータ画面への出力</entry>

	      <entry><para>あなたの
		  <filename>.login</filename> ファイルを編集してください。
		</para><para>ファイルの一覧を表示するには
		  <command>ls -a</command> を使います。
		</para><para><screen>You have mail.</screen></para></entry>
	    </row>

	    <row>
	      <entry>コンピュータの画面に表示されるものと、
		あなたが入力するものを区別する場合</entry>

	      <entry><screen>&prompt.user; <userinput>su</userinput>
Password:</screen></entry>
	    </row>

	    <row>
	      <entry>マニュアルページの参照</entry>

	      <entry>ユーザ名を変更するには
		<citerefentry>
		  <refentrytitle>su</refentrytitle>
		  <manvolnum>1</manvolnum>
		</citerefentry>
		を使います。</entry>
	    </row>

	    <row>
	      <entry>ユーザ名とグループ名</entry>

	      <entry>これが行なえるのは
		<username>root</username> だけです。</entry>
	    </row>

	    <row>
	      <entry>強調部分</entry>

	      <entry>必ずこれを行なわなければ<emphasis>いけません</emphasis>。</entry>
	    </row>

	    <row>
	      <entry>コマンドラインに書かれる引数。
		これは実際にあるファイル名や変数名などに置き換えられます。
	      </entry>

	      <entry>ファイルを消去するには、
		<command>rm <filename><replaceable>ファイル名</replaceable></filename></command>
		と入力します。</entry>
	    </row>

	    <row>
	      <entry>環境変数</entry>

	      <entry><envar>$HOME</envar>は、
		あなたのホームディレクトリです。</entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </sect1>

    <sect1 id="preface-notes">
      <title>注記、Tips、重要な情報、警告、例示</title>

      <para>注記や警告、例示は本文中に書かれています。</para>

      <note>
	<para>注記はこのような感じで表示されます。
	  これには、読者が行なう操作に関連して
	  注意しなければならないことを伝えるための内容が含まれています。
	</para>
      </note>

      <tip>
	<para>Tips はこのような感じで表示されます。
	  これには、読者の役に立つかもしれない情報や、
	  何かをするのにより易しい方法へと導いてくれるような手がかりが含まれています。
	</para>
      </tip>

      <important>
	<para>重要な情報はこのような感じで表示されます。
	  一般的には読者が追加して行わなければならない手順を示しています。
	</para>
      </important>

      <warning>
	<para>警告は、このような感じで表示されます。
	  これには、手順に従わない場合に何らかの損害を被る可能性があることを
	  伝える内容が含まれています。
	  その損害はハードウェアや操作者に対する物理的なものかも知れませんし、
	  不注意で重要なファイルが削除されてしまうような非物理的なものかも知れません。
	</para>
      </warning>

      <example>
	<title>例示のサンプル</title>

	<para>例示は、このような感じで表示されます。
	  これには通常、読者自身が試す必要のある例や、
	  ある操作がどのような結果をもたらすのか、
	  読者に示すための例が含まれています。
	</para>
      </example>
    </sect1>

    <sect1 id="preface-acknowledgements">
      <title>謝辞</title>

      <para>Sue Blake, Patrick Durusau,
	Jon Hamilton, Peter Flynn,
	Christopher Maden
	はこの文書の初稿を読む時間を割いて、
	たくさんの有益なコメントや批評を送ってくれました。
	ここに感謝の意を表します。</para>
    </sect1>
  </preface>

  &chap.overview;
  &chap.tools;
  &chap.sgml-primer;
  &chap.sgml-markup;
  &chap.stylesheets;
  &chap.structure;
  &chap.doc-build;
  &chap.the-website;
  &chap.translations;
  &chap.writing-style;
  &chap.psgml-mode;
  &chap.see-also;

  &app.examples;

<!--
  &index;
-->
</book>

<!--
     Local Variables:
     mode: sgml
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-always-quote-attributes: t
     End:
-->
