%books.ent; %chapters; ]> 新しい貢献者のための FreeBSD ドキュメンテーションプロジェクト入門 Nik Clayton
nik@FreeBSD.org
1998 1999 Nik Clayton $FreeBSD$ $FreeBSD$ 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: 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. 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. FreeBSD ドキュメンテーションプロジェクトに参加してくださってありがとうございます。 あなたの貢献は非常に価値のあることです。 この入門では FreeBSD ドキュメンテーションプロジェクトへの貢献を始めるにあたって理解する必要のあること、 すなわち(必須のものだけでなく、推奨されるものも含めた)ツールやソフトウェアの使い方から、 ドキュメンテーションプロジェクトの方針にわたる内容のすべてを扱っています。 この文書は発展途上にあり、まだ完成していません。 まだ完成していない節の名前には *(アスタリスク) が付けてあります。
まえがき シェルプロンプト 以下の表は、 標準のシステムプロンプトとスーパーユーザのプロンプト示しています。 この文書であげる実例では、 どちらのユーザでその例を実行すべきか示すためにこれらのプロンプトを使用します。 ユーザ プロンプト 通常ユーザ &prompt.user; root &prompt.root; 表記上の慣例 下の表は、 この文書で使われる表記上の慣例を示しています。 意味 コマンド、ファイル、ディレクトリの名前および、 コンピュータ画面への出力 あなたの .login ファイルを編集してください。 ファイルの一覧を表示するには ls -a を使います。 You have mail. コンピュータの画面に表示されるものと、 あなたが入力するものを区別する場合 &prompt.user; su Password: マニュアルページの参照 ユーザ名を変更するには su 1 を使います。 ユーザ名とグループ名 これが行なえるのは root だけです。 強調部分 必ずこれを行なわなければいけません コマンドラインに書かれる引数。 これは実際にあるファイル名や変数名などに置き換えられます。 ファイルを消去するには、 rm ファイル名 と入力します。 環境変数 $HOMEは、 あなたのホームディレクトリです。 注記(notes)、警告(warnings)、例示(examples) 注記や警告、例示は本文中に書かれています。 注記はこのような感じで表示されます。 これには、読者が行なう操作に関連して 注意しなければならないことを伝えるための内容が含まれています。 警告は、このような感じで表示されます。 これには、手順に従わない場合に何らかの損害を被る可能性があることを 伝える内容が含まれています。 その損害はハードウェアや操作者に対する物理的なものかも知れませんし、 不注意で重要なファイルが削除されてしまうような非物理的なものかも知れません。 例示のサンプル 例示は、このような感じで表示されます。 これには通常、読者自身が試す必要のある例や、 ある操作がどのような結果をもたらすのか、 読者に示すための例が含まれています。 謝辞 Sue Blake, Patrick Durusau, Jon Hamilton, Peter Flynn, Christopher Maden はこの文書の初稿を読む時間を割いて、 たくさんの有益なコメントや批評を送ってくれました。 ここに感謝の意を表します。 &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;