<!-- 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.9
     $FreeBSD: doc/ja_JP.eucJP/books/fdp-primer/book.sgml,v 1.1 2001/03/07 19:40:47 hrs Exp $
-->

<!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
%man;

<!ENTITY % chapters SYSTEM "chapters.ent"> %chapters;
]>

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

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

    <author>
      <firstname>Nik</firstname>
      <surname>Clayton</surname>
      <affiliation>
        <address><email>nik@FreeBSD.org</email></address>
      </affiliation>
    </author>

    <copyright>
      <year>1998</year>
      <year>1999</year>
      <holder role="mailto:nik@FreeBSD.org">Nik Clayton</holder>
    </copyright>

    <pubdate role="rcs">$FreeBSD: doc/ja_JP.eucJP/books/fdp-primer/book.sgml,v 1.1 2001/03/07 19:40:47 hrs Exp $</pubdate>

    <releaseinfo>$FreeBSD: doc/ja_JP.eucJP/books/fdp-primer/book.sgml,v 1.1 2001/03/07 19:40:47 hrs Exp $</releaseinfo>

    <legalnotice>
      <para>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:</para>

      <orderedlist>
	<listitem>
	  <para>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.</para>
	</listitem>

	<listitem>
	  <para>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.</para>
	</listitem>
      </orderedlist>

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

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

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

  <preface>
    <title>まえがき</title>

    <sect1>
      <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>
      <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>
      <title>注記(notes), 警告(warnings), 例示(examples)</title>

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

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

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

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

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

    <sect1>
      <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.the-website;
  &chap.translations;
  &chap.writing-style;
  &chap.psgml-mode;
  &chap.see-also;
  
</book>

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