diff --git a/ja_JP.eucJP/books/fdp-primer/Makefile b/ja_JP.eucJP/books/fdp-primer/Makefile
new file mode 100644
index 0000000000..0101034192
--- /dev/null
+++ b/ja_JP.eucJP/books/fdp-primer/Makefile
@@ -0,0 +1,55 @@
+#
+# $FreeBSD$
+#
+# Build the FreeBSD Documentation Project Primer (Japanese).
+#
+# Original revision: 1.10
+#
+
+MAINTAINER=
+
+DOC?= book
+
+FORMATS?= html-split html
+
+INSTALL_COMPRESSED?= gz
+INSTALL_ONLY_COMPRESSED?=
+
+NO_TIDY= YES
+
+#
+# SRCS lists the individual SGML files that make up the document. Changes
+# to any of these files will force a rebuild
+#
+
+# SGML content
+SRCS= book.sgml
+SRCS+= overview/chapter.sgml
+SRCS+= psgml-mode/chapter.sgml
+SRCS+= see-also/chapter.sgml
+SRCS+= sgml-markup/chapter.sgml
+SRCS+= sgml-primer/chapter.sgml
+SRCS+= stylesheets/chapter.sgml
+SRCS+= structure/chapter.sgml
+SRCS+= doc-build/chapter.sgml
+SRCS+= the-website/chapter.sgml
+SRCS+= tools/chapter.sgml
+SRCS+= translations/chapter.sgml
+SRCS+= writing-style/chapter.sgml
+
+
+SRCS+= examples/appendix.sgml
+
+# Images from the cross-document image library
+#IMAGES_LIB= callouts/1.png
+#IMAGES_LIB+= callouts/2.png
+#IMAGES_LIB+= callouts/3.png
+#IMAGES_LIB+= callouts/4.png
+#IMAGES_LIB+= callouts/5.png
+
+# Entities
+SRCS+= chapters.ent
+
+DOC_PREFIX?= ${.CURDIR}/../../..
+
+.include "${DOC_PREFIX}/share/mk/doc.project.mk"
diff --git a/ja_JP.eucJP/books/fdp-primer/book.sgml b/ja_JP.eucJP/books/fdp-primer/book.sgml
new file mode 100644
index 0000000000..6527429142
--- /dev/null
+++ b/ja_JP.eucJP/books/fdp-primer/book.sgml
@@ -0,0 +1,308 @@
+
+
+
+%man;
+
+ %chapters;
+]>
+
+
+
+
+
+ 新しい貢献者のための FreeBSD ドキュメンテーションプロジェクト入門
+
+
+ Nik
+ Clayton
+
+ nik@FreeBSD.org
+
+
+
+
+ 1998
+ 1999
+ Nik Clayton
+
+
+ $FreeBSD: doc/en_US.ISO_8859-1/books/fdp-primer/book.sgml,v 1.9 1999/09/06 07:22:25 peter Exp $
+
+ $FreeBSD: doc/en_US.ISO_8859-1/books/fdp-primer/book.sgml,v 1.9 1999/09/06 07:22:25 peter Exp $
+
+
+ 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;
+
+
+
+
diff --git a/ja_JP.eucJP/books/fdp-primer/chapter.decl b/ja_JP.eucJP/books/fdp-primer/chapter.decl
new file mode 100644
index 0000000000..ce0a7ed16a
--- /dev/null
+++ b/ja_JP.eucJP/books/fdp-primer/chapter.decl
@@ -0,0 +1 @@
+
diff --git a/ja_JP.eucJP/books/fdp-primer/chapters.ent b/ja_JP.eucJP/books/fdp-primer/chapters.ent
new file mode 100644
index 0000000000..3fa92c30f4
--- /dev/null
+++ b/ja_JP.eucJP/books/fdp-primer/chapters.ent
@@ -0,0 +1,26 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/ja_JP.eucJP/books/fdp-primer/overview/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/overview/chapter.sgml
new file mode 100644
index 0000000000..42e6c75da8
--- /dev/null
+++ b/ja_JP.eucJP/books/fdp-primer/overview/chapter.sgml
@@ -0,0 +1,204 @@
+
+
+
+ 概要
+
+ FreeBSD ドキュメンテーションプロジェクトへようこそ.
+ 質の高い文書は, FreeBSD
+ を成功させるために欠かすことができない重要なものです. FreeBSD
+ ドキュメンテーションプロジェクト(FreeBSD Documentation Project;
+ FDP)は, そのような文書を数多く作成するためのプロジェクトです.
+ あなたの貢献は, 非常に貴重です.
+
+
+ この文書は主に FDP の構成,
+ 文書の作成と FDP への提出方法および,
+ 文書作成のために利用できるツールの効果的な利用法
+ について解説することを目的としています.
+
+
+ FDP は, どなたでも参加できます. 参加資格はありませんし,
+ 毎月, 文書の作成が義務づけられているわけでもありません.
+ あなたがしなければならないのは, ただ
+ freebsd-doc@FreeBSD.org
+ メーリングリストに参加することだけです.
+
+
+ この文書を読み終えた後,
+ あなたは次のようになっていなければなりません.
+
+
+
+ どれが FDP が管理する文書はなのか理解して下さい.
+
+
+
+ FDP の管理する文書の SGML のソースコードを読み,
+ 意味が理解できるようになってください.
+
+
+
+
+ 文書へ変更を加える操作ができるようになってください.
+
+
+
+ あなたの変更が査読を受け, FreeBSD
+ の文書として採用にまわせるよう, 変更の提出ができるようになってください.
+
+
+
+
+
+ FreeBSD 文書セット
+
+ FDP では FreeBSD 関連文書のうち, 次の
+ 4 つのカテゴリを担当しています.
+
+
+
+
+ マニュアルページ
+
+
+ システムの英語版マニュアルページは基本システムの一部であり,
+ FDP がその作成を担当しているわけではありません.
+ しかし FDP は, マニュアルページをよりわかりやすくしたり,
+ 不正確な記述を修正するため, 既存のマニュアルページの改編を行なうことが
+ できます.
+
+
+ 翻訳チームは, システムのマニュアルページを他言語に翻訳する
+ 作業を担当しています. この翻訳作業は, FDP の担当範囲内です.
+
+
+
+
+
+ FAQ
+
+
+ FAQ は, FreeBSD
+ に関連するさまざまなメーリングリストやニュースグループで
+ よく尋ねられる質問, あるいは質問されるべきものについて,
+ (短い質疑応答形式で)取り扱ったものです.
+ この形式では, 必要以上に長く細かい回答は許されません.
+
+
+
+
+
+ ハンドブック
+
+
+ ハンドブックは広範囲の話題を扱った FreeBSD のユーザのための
+ オンライン情報源, およびリファレンスとなることを意図したものです.
+
+
+
+
+
+ ウェブサイト
+
+
+ これは, World Wide Web において中心的な FreeBSD のサイトであり,
+ http://www.FreeBSD.org/
+ と, 世界中に存在するたくさんのミラーサイトから見ることができます.
+ このウェブサイトは, 多くの人々が FreeBSD
+ を初めて目にする場所でもあります.
+
+
+
+
+
+ この 4 種類の文書は, いずれも FreeBSD CVS ツリーから入手することができます.
+ そのため, ログとファイルへの変更は一般に公開されていて,
+ CVSup や
+ CTM といったプログラムを使い
+ 誰でも文書のローカルコピーを最新のものに保つことができます.
+
+
+ さらに, たくさんの人々がチュートリアルや FreeBSD
+ 関連のウェブサイトをつくっています. それらのなかには,
+ 他の文書と同じように CVS リポジトリ(の原作者が同意した場所)に
+ 含まれているものもある一方, FreeBSD のリポジトリからは分離して,
+ 原作者の手によって直接保守されているものもあります.
+ FDP では, そのような文書に対して可能な限り,
+ リンクを提供するように努力しています.
+
+
+
+
+ はじめる前に
+
+ この文書は, 次にあげる内容について
+ あなたがすでに理解していることを前提として書かれています.
+
+
+
+
+ FreeBSD の文書のローカルコピーを入手し, 最新に維持する方法について.
+ これには, FreeBSD CVS リポジトリのローカルコピーを
+ (CVS, もしくは
+ CVSup か
+ CTM を使って)維持するか, もしくは
+ CVSup を使って
+ チェックアウトした(checked-out)コピーを
+ ダウンロードするという方法があります.
+
+
+
+
+ FreeBSD Ports システム, もしくは &man.pkg.add.1
+ を利用して新しいソフトウェアをダウンロードし, インストールする方法について.
+
+
+
+
+
+
+
+
diff --git a/ja_JP.eucJP/books/fdp-primer/psgml-mode/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/psgml-mode/chapter.sgml
new file mode 100644
index 0000000000..7a542726f1
--- /dev/null
+++ b/ja_JP.eucJP/books/fdp-primer/psgml-mode/chapter.sgml
@@ -0,0 +1,166 @@
+
+
+
+ <application>Emacs</application> で
+ <literal>sgml-mode</literal> を利用する
+
+ 新しいバージョンの Emacs や Xemacs(Ports Collection にあります)には,
+ PSGML と呼ばれる非常に便利なパッケージが附属しています.
+ これは拡張子が .sgml のファイルが読み込まれるか,
+ M-x sgml-mode と入力することで呼び出されます.
+ PSGML は, SGML ファイルやエレメント, 属性を扱うためのメジャーモードです.
+
+
+ このモードで提供されているいくつかのコマンドを知っていれば,
+ ハンドブックなどの SGML 文書をより簡単に扱うことができるようになります.
+
+
+
+
+ C-c C-e
+
+
+ sgml-insert-element を実行します.
+ 実行すると, 現在のカーソル位置に挿入すべきエレメント名が聞かれ,
+ TAB キーを使うことでエレメント名の補完ができます. また,
+ カーソル位置に挿入できないエレメント名は入力できないようになっています.
+
+
+ 挿入は, 指定したエレメントのスタートタグとエンドタグが両方行なわれます.
+ もし, そのエレメントが他の必須エレメントを含む場合は,
+ その必須エレメントも同じように挿入されます.
+
+
+
+
+
+ C-c =
+
+
+ sgml-change-element-name を実行します.
+ カーソルをエレメントの内側に移動させてこのコマンドを実行して下さい.
+ 変更するエレメント名が聞かれ, 現在のエレメントのスタートタグとエンドタグが
+ 入力した新しいエレメントのものに変更されます.
+
+
+
+
+
+ C-c C-r
+
+
+ sgml-tag-region を実行します.
+ テキストを指定(テキストの開始点に移動して C-Space を押し,
+ 終了点に移動して C-Space を押す)してから, このコマンドを実行して下さい.
+ 利用するエレメント名が聞かれ,
+ マークが付けられた範囲(リージョン)のすぐ前後に指定したエレメントが挿入されます.
+
+
+
+
+
+ C-c -
+
+
+ sgml-untag-element を実行します.
+ カーソルを削除したいエレメントのスタートタグか, エンドタグの上において
+ このコマンドを実行して下さい. すると, エレメントのスタートタグ,
+ エンドタグが両方とも削除されます.
+
+
+
+
+
+ C-c C-q
+
+
+ sgml-fill-element を実行します.
+ 実行すると, カーソル位置のエレメントの内容に対して,
+ (整形する時のように)再帰的な文章の詰めが行なわれます.
+ この詰め作業は, 含まれている空白文字が重要なもの, たとえば
+ programlisting
+ エレメントの中などでも効果がありますので,
+ 利用の際は注意して下さい.
+
+
+
+
+
+ C-c C-a
+
+
+ sgml-edit-attributes を実行します.
+ 実行するともう一つバッファを開き,
+ 最も近い閉じたエレメントのすべての属性のリストと, 現在の値を表示します.
+ TAB を使って属性間を移動することができ, C-k を
+ 押すことで, 既存の値を新しいものに置き換えることができます.
+ また, C-c を押すことで, バッファを閉じて
+ 元の文書に戻ることができます.
+
+
+
+
+
+ C-c C-v
+
+
+ sgml-validate を実行します.
+ 実行すると(必要に応じて)現在編集中の文書をセーブするかどうか聞かれ,
+ 次に SGML の正当性検査が行なわれます.
+ 検査の出力は新しいバッファに表示されますので,
+ 誤りのある部分へひとつひとつ移動してマークアップのミスを修正することができます.
+
+
+
+
+
+ もちろん, このモードには他にも有用な機能があります.
+ ここにあげたのは, その中でもわたしが非常に頻繁に利用しているものです.
+
+
+
+
+
+
diff --git a/ja_JP.eucJP/books/fdp-primer/see-also/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/see-also/chapter.sgml
new file mode 100644
index 0000000000..509e0df519
--- /dev/null
+++ b/ja_JP.eucJP/books/fdp-primer/see-also/chapter.sgml
@@ -0,0 +1,123 @@
+
+
+
+ 参考サイト
+
+ この文書は, SGML や DTD, FreeBSD ドキュメンテーションプロジェクトに関して,
+ すべてを網羅したものではありません. さらに詳しい内容については,
+ 以下のウェブサイトをご覧になることをおすすめします.
+
+
+
+ FreeBSD ドキュメンテーションプロジェクト
+
+
+
+ FreeBSD
+ ドキュメンテーションプロジェクトのウェブページ
+
+
+
+ FreeBSD ハンドブック(英語版)
+
+
+
+
+
+ SGML
+
+
+
+ SGML/XML ウェブページ.
+ これは広範囲にわたる網羅的な SGML の情報源です.
+
+
+
+ やさしい SGML 入門
+
+
+
+
+
+ HTML
+
+
+
+ World Wide Web コンソーシアム
+
+
+
+ HTML 4.0 規格書
+
+
+
+
+
+ DocBook
+
+
+
+ The Davenport
+ Group. ここは DocBook DTD の保守を行なっているところです.
+
+
+
+
+
+ Linux ドキュメンテーションプロジェクト
+
+
+
+ Linux
+ ドキュメンテーションプロジェクトのウェブページ
+
+
+
+
+
+
+
diff --git a/ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml
new file mode 100644
index 0000000000..d2f2be27cb
--- /dev/null
+++ b/ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml
@@ -0,0 +1,322 @@
+
+
+
+ <filename>doc/</filename> 以下に構成されている文書
+
+ doc/ ソースツリーは, ある一貫した方針で構成されています.
+ また, そのうち FDP が管理する文書は, さらに別の方針で構成されています.
+ これは新しい文書をソースツリーに追加する作業の単純化に加え,
+
+
+
+ 文書を他の形式への変換を自動化しやすくすること
+
+
+
+ 他の異なる文書構成との間の一貫性を維持し,
+ 相互に作業しやすくすること
+
+
+
+
+ ソースツリー上で新しい文書を導入する場所の決定を簡単に行なえるようにすること
+
+
+
+ を目的としています.
+ さらに文書のソースツリーは, さまざまな異なる言語や
+ 文字エンコーディングに対応できなければなりません.
+ 文書ツリーの構造が特定の慣習や文化背景を強制するものであっては
+ ならないという点は重要です.
+
+
+ ソースツリーの最上位 <filename>doc/</filename>
+
+ doc/ の下には二種類のディレクトリがあり,
+ 各ディレクトリはそれぞれ, 特別な名前と意味を持っています.
+
+
+
+ share/
+
+ このディレクトリには, 文書の翻訳やエンコーディングに依存しないファイルが収められ,
+ その分類のためのサブディレクトリがつくられています.
+ たとえば, &man.make.1; で使用されるファイルは share/mk
+ に, (FreeBSD で拡張された DocBook DTD などの) SGML 関連のファイルは
+ share/sgml におかれています.
+
+
+
+ lang.encoding/
+
+ 各々の文書の翻訳, エンコーディングに対して,
+ それに対応する一つのディレクトリがあります.
+ 具体的には, en_US.ISO_8859-1/ や
+ zh_TW.Big5/ というディレクトリです.
+ ディレクトリ名が長いのですが, 言語とエンコーディングを完全に記述することで,
+ 翻訳チームが将来的に, 同一の言語で異なるエンコーディングの
+ 文書を提供する際に発生する問題を回避することができます.
+ また, Unicode に移行するとしても, この方法ならば問題はまったくありません.
+
+
+
+
+
+
+ <filename><replaceable>lang</replaceable>.<replaceable>encoding</replaceable>/</filename>
+ ディレクトリ群
+
+ これらのディレクトリには, 文書そのものがおかれています.
+ 文書はこのディレクトリからさらに,
+ それぞれ異なるディレクトリ名で示される三種類に分類されます.
+
+
+
+ articles
+
+ DocBook の article(もしくはそれと同等なもの)
+ でマークアップされた文書です.
+ 文書は短めのもので, 構成単位は節(section)となっています.
+ 通常, 一つの HTML ファイルとして生成されます.
+
+
+
+ books
+
+ DocBook の book(もしくはそれと同等なもの)
+ でマークアップされた文書です. 文書は比較的長めで,
+ 構成単位は章(chapter)となっています. 通常,
+ (高速なネットワーク接続を持っている人や,
+ ブラウザからの印刷に便利なよう)大きな単一の HTML ファイルと,
+ リンクされた小さな HTML ファイルの両方が生成されます.
+
+
+
+ man
+
+ システムのマニュアルページの翻訳をおくためのディレクトリです.
+ このディレクトリには, さらに mann という,
+ 翻訳されたマニュアルのセクションに対応する複数のディレクトリがあります.
+
+
+
+
+ ここで説明したディレクトリすべてが, 必ずそれぞれの
+ lang.encoding
+ ディレクトリにあるというわけではありません.
+ どのディレクトリが存在するかについては, 翻訳チームがどれだけ翻訳を完了しているかに依存します.
+
+
+
+
+ 特定の文書に関する情報
+
+ このセクションでは, FDP
+ が管理する特定の文書に関する注意点が書かれています.
+
+
+
+ ハンドブック
+
+ books/handbook/
+
+ ハンドブックは, FreeBSD
+ によって拡張された DocBook DTD で書かれています.
+
+
+ ハンドブックは, DocBook の book
+ によって構成されています.
+ そしてそれは複数の part に分割され,
+ part はいくつかの chapter
+ を含みます. chapter は
+ さらにセクション(sect1), サブセクション
+ (sect2, sect3)
+ などに分割されています.
+
+
+
+ 物理的な構成
+
+ handbook ディレクトリには,
+ 数多くのファイルとディレクトリがおかれています.
+
+
+ ハンドブックの構成は, 時より変更されますので,
+ この文書では,
+ 構成変更の細かな部分の記述が古くなってしまっているかも知れません.
+ ハンドブックの構成について疑問点がありましたら,
+ FreeBSD ドキュメンテーションプロジェクト
+ freebsd-doc@FreeBSD.org まで連絡下さい.
+
+
+
+
+ <filename>Makefile</filename>
+
+ Makefile は, SGML
+ ソースを他の形式に変換する方法を決めたり,
+ ハンドブックを構築する各種ソースファイルを列挙する
+ さまざまな変数を定義するものです.
+ このファイルは, 文書形式の変換を扱うためのコードを取り込むために
+ 標準の doc.project.mk をインクルードします.
+
+
+
+
+ <filename>book.sgml</filename>
+
+ これはハンドブックの構造において最上位にあたる文書です.
+ ハンドブックの DOCTYPE
+ 宣言とハンドブックの構成を記述するためのエレメントが含まれています.
+
+
+ book.sgml は,
+ .ent
+ という拡張子のついたファイルをロードするためにパラメータ実体(parameter
+ entities)を使います. (後述する)これらのファイルには,
+ ハンドブックの他の部分で共通して使われる一般実体(general
+ entities)
+ が定義されています.
+
+
+
+ <filename><replaceable>directory</replaceable>/chapter.sgml</filename>
+
+ ハンドブックの各章は, 互いに個別に分けられたディレクトリに
+ chapter.sgml というファイルとして格納されています.
+ それぞれのディレクトリには, chapter エレメントの
+ id 属性の値と同じ名前が付けられています.
+
+
+ たとえば, ある章のファイルが
+
+
+...
+]]>
+
+ のようになっていたとすれば, それは
+ kernelconfiguration という
+ ディレクトリ中の chapter.sgml
+ というファイルです. 通常,
+ その章の内容はすべてこのファイルに書かれています.
+
+ HTML 版のハンドブックを構築する時, この章は
+ kernelconfiguration.html
+ というファイル名として生成されます. これは
+ id の値に関係するもので,
+ ディレクトリ名との関連はありません.
+
+ ハンドブックの以前の版では, 文書のファイルは
+ book.sgml と同じディレクトリにおかれていて,
+ ファイル名は chapter エレメントの
+ id 属性の値になっていました.
+ これを個別のディレクトリに分けて移動させたのはハンドブックの
+ 将来的な計画の準備のためです. 具体的には, こうすることで,
+ 特に変更することなく各章に画像を追加することが可能になります.
+ また, それぞれの画像ファイルを章のテキストファイルと同じディレクトリに
+ おくことは, 大きな一つのディレクトリにすべてのテキストファイルと
+ 画像ファイルをおいて管理しようとするより分かりやすくなります.
+ 名前空間の衝突が発生したとしても,
+ 格納ファイルの少ないディレクトリで作業する方が,
+ 数多くのファイルがディレクトリにある場合よりも対処しやすくなるでしょう.
+
+ ここまでを簡単にまとめると,
+ 個々に chapter.sgml
+ というファイルを含むディレクトリがたくさんあり, それらは
+ basics/chapter.sgml,
+ introduction/chapter.sgml,
+ printing/chapter.sgml
+ などという名前になっているということです.
+
+
+ 章とディレクトリは,
+ ハンドブックの並び順を反映した方法で名付けられるべきではありません.
+ 順番はハンドブックの改訂の際に変更される可能性があります.
+ (章全体が階層構造の中で上下に移動するような場合でなければ)
+ こういった改訂が行なわれる場合にファイル名を変更する必要性が
+ (なるべく) 生じないようにするべきです.
+
+
+
+ 各々の chapter.sgml ファイルは,
+ 完全な SGML 文書ではありません. 詳しく言えば,
+ それらのファイルの先頭には DOCTYPE 宣言の行が書かれていません.
+
+
+ これには, 二つの欠点があります.
+
+
+
+ これらのファイルは一般的な SGML
+ ファイルとして扱うことができないため,
+ HTML, RTF, PS などの形式に変換するのに,
+ ハンドブック全体の生成に用いている方法と同じ方法を単純に用いることができません.
+ そのため, ただ一つの章だけを変更し, その結果を確認しようという場合には,
+ 毎回ハンドブック全体を構築し直さなければならないことになります.
+
+
+
+
+ Emacs の sgml-mode を使う場合,
+ 文書が利用している DTD を認識できないために
+ sgml-mode
+ の便利な機能(エレメントの補完入力,
+ 自動チェック機能など)が利用できなくなります.
+
+
+
+
+
+
+
+
+
+
+
diff --git a/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.sgml
new file mode 100644
index 0000000000..5d4e1da2ab
--- /dev/null
+++ b/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.sgml
@@ -0,0 +1,89 @@
+
+
+
+ * スタイルシート
+
+ SGML は, 文書が利用者にどのように表示されるかということや,
+ 紙の上にどう配置されるかということについては何も定義していません.
+ それらを行なうためにスタイルシートを記述するさまざまな言語が開発されています.
+ その言語には, DynaText, Panorama, SPICE, JSSS, FOSI, CSS, DSSSL
+ などがあります.
+
+
+ わたしたちは, DocBook 文書用として DSSSL で書かれたスタイルシートを,
+ HTML 文書用として CSS を利用しています.
+
+
+ * DSSSL
+
+ ドキュメンテーションプロジェクトでは,
+ Norm Walsh 氏による Modular DocBook Stylesheets
+ を少しカスタマイズしたものを使っています.
+
+ このスタイルシートは,
+ textproc/dsssl-docbook-modular
+ から入手できます.
+
+ 変更が加えられたスタイルシートは, ports システムに含まれていません.
+ それらはドキュメンテーションプロジェクトのソースリポジトリの一部であり,
+ doc/share/sgml/freebsd.dsl におかれています.
+ 変更が加えられたスタイルシートには詳細なコメントが付けられていますので,
+ この章が完成するまで, 標準のスタイルシートにあるオプションが
+ どういった風に FreeBSD ドキュメンテーションプロジェクト用に
+ カスタマイズされているのか, このファイルを見て調べてみてください.
+ このファイルには FreeBSD 独自のエレメントを組版するために
+ スタイルシートを適用するエレメントを追加する方法の例も含まれています.
+
+
+
+
+ * CSS
+
+
+
+
+
+
diff --git a/ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml
new file mode 100644
index 0000000000..8fd4d1dde3
--- /dev/null
+++ b/ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml
@@ -0,0 +1,306 @@
+
+
+
+ ツール
+
+ FDP では FreeBSD の文書を管理したり,
+ 他の出力形式にに整形したりするため, さまざまなソフトウェアツールを利用します.
+ FreeBSD の文書で作業するには, あなた自身がそれらのツールを使う必要があります.
+
+
+ これらのツールはすべて FreeBSD の port や package として入手可能で,
+ インストール作業は非常に簡単です.
+
+
+ 以下の章に書かれた例を試すには, あらかじめ
+ これらのツールがインストールされていなければなりません.
+ 各ツールの実際の利用方法は, その例が書かれた章で説明されています.
+
+
+
+ できるだけ <filename>textproc/docproj</filename> を利用してください
+
+ textproc/docproj の port
+ を使うとインストールする手間を大きく省くことができます. これは
+ メタ(meta) port と呼ばれる port で,
+ その中にソフトウェアが含むかわりに, 他のさまざまな port
+ が正しくインストールされるように依存関係がつくられているものです.
+ この port をインストールすると,
+ この章であげられているソフトウェアのうち,
+ あなたのシステムにインストールされていないものが
+ 自動的にすべてダウンロードされ, インストールされます.
+
+
+ 必要となるパッケージの一つに, JadeTeX マクロセットというものがあります.
+ このマクロセットは, インストール時に TeX
+ がインストールされていることを必要とします. TeX
+ は非常に大きなパッケージですが, Postscript や PDF
+ 形式の出力を行なわないならばインストールの必要はありません.
+
+
+ 時間とディスクスペースの節約のため,
+ この port をインストールする際に, JadeTeX(すなわち TeX を含む)
+ を必要とするかどうかを指定する必要があります.
+ 次のいずれかを, 場合に応じて実行して下さい.
+
+ &prompt.root; make JADETEX=yes install
+
+ &prompt.root; make JADETEX=no install
+
+
+
+
+ 必須のツール
+
+
+ ソフトウェア
+
+ 以下のプログラムは, FreeBSD
+ の文書で快適に作業するために必要なものです. これらはすべて,
+ textproc/docproj
+ に含まれています.
+
+
+
+ SP
+ (textproc/sp)
+
+
+ 正当性検査のための SGML パーサや
+ SGML 正規化ツールを含むアプリケーションのセットです.
+
+
+
+
+
+ Jade
+ (textproc/jade)
+
+
+ DSSSL の実装です. これはマークアップされた文書を HTML
+ や TeX といった他の形式に変換するために使われます.
+
+
+
+
+ Tidy
+ (www/tidy)
+
+
+ HTML 整形ツールです.
+ これは自動生成された HTML 文書を整形し,
+ より利用しやすいものにするために使われます.
+
+
+
+
+
+ Lynx
+ (www/lynx-current)
+
+
+
+ テキストモードの WWW ブラウザです. &man.lynx.1;
+ は, HTML
+ ファイルをプレインテキストに変換することができます.
+
+
+
+
+
+
+
+ 文書型定義(DTD)と実体宣言(entity)
+
+ 以下にあげるのは, FDP で使われている DTD と実体宣言集合(entity set)です.
+ これらはいずれも, 文書を取り扱う前に必要となります.
+
+
+
+
+ HTML DTD (textproc/html)
+
+
+ HTML は, World Wide Web で採用されているマークアップ言語です.
+ これは FreeBSD ウェブサイト全体でも利用されます.
+
+
+
+
+ LinuxDoc DTD (textproc/linuxdoc)
+
+
+ FreeBSD の文書には, LinuxDoc でマークアップされたものがあります.
+ FDP では, LinuxDoc から DocBook への移行を積極的にすすめています.
+
+
+
+
+
+ DocBook DTD (textproc/docbook)
+
+
+ DocBook は, 技術文書のマークアップのために設計された DTD であり,
+ FDP では LinuxDoc から DocBook への移行をすすめています.
+ この原稿を執筆している時点で, FreeBSD ハンドブックが
+ DockBook によってマークアップされています.
+
+
+
+
+
+ ISO 8879 公開実体宣言
+ (textproc/iso8879)
+
+
+ ISO 8879:1986 に規定された 19 種類の 文字実体集合です.
+ これはたくさんの DTD で利用されるもので, 数学記号や latin
+ 文字集合の追加文字(アクセント記号, 発音記号など),
+ ギリシャ文字などが含まれます.
+
+
+
+
+
+
+
+ スタイルシート
+
+ スタイルシートは, 文書を画面表示や印刷などに利用される形式に変換,
+ 整形するために使われます.
+
+
+
+
+ Modular DocBook Stylesheets
+ (textproc/dsssl-docbook-modular)
+
+
+ Modular DocBook Stylesheets は,
+ DocBook DTD でマークアップされた文書を HTML や RTF
+ 形式に変換するのに使われます.
+
+
+
+
+
+
+
+ 必須でない(optional)ツール
+
+ もし必要性を感じないなら, 以下にあげるソフトウェアはインストールしなくともかまいません.
+ しかしインストールしていれば, 文書の取り扱いに便利だと感じるでしょうし,
+ これらを使うことで, より多様な出力形式で文書を出力することが可能となります.
+
+
+
+ ソフトウェア
+
+
+
+ JadeTeX および
+ teTeX
+ (print/jadetex および
+ print/teTeX-beta)
+
+
+ Jade と
+ teTeX は,
+ DocBook 文書を DVI, Postscript, PDF の各形式に変換するのに使われます.
+ また, このとき JadeTeX マクロも必要となります.
+
+
+ 文書をそのような形式に変換しなくて良い
+ (たとえば HTML, プレインテキスト, RTF で十分であるような)場合には,
+ JadeTeX および
+ teTeX をインストールする必要はありません.
+ これらのインストールには大きなディスクスペースと時間を必要とします.
+ teTeX は, 30MB を超える大きなものです.
+
+
+
+ JadeTeX と
+ teTeX
+ をインストールする場合には,
+ JadeTeX がインストールされた後,
+ teTeX の設定を行なわなければなりません.
+ 必要な手順の詳細は,
+ print/jadetex/pkg/MESSAGE
+ に説明されています.
+
+
+
+
+
+ Emacs もしくは
+ xemacs
+ (editors/emacs もしくは
+ editors/xemacs)
+
+
+ このエディタは両方とも, SGML DTD
+ でマークアップされた文書を編集するための特別なモードを備えています.
+ このモードには,
+ 必要なタイプ量や誤りをを低減するためのコマンドがあります.
+
+
+ どのようなテキストエディタでもマークアップされた文書を編集することは可能ですので,
+ これらを使う必要があるというわけではありません.
+ しかしおそらく, これらは便利なものだと感じると思います.
+
+
+
+
+
+ もし, この他に SGML 文書を扱うために有用なソフトウェアをご存知でしたら,
+ Nik Clayton(nik@FreeBSD.org) までお知らせ下さい.
+ このリストに加えさせていただきます.
+
+
+
+
+
+
diff --git a/ja_JP.eucJP/books/fdp-primer/writing-style/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/writing-style/chapter.sgml
new file mode 100644
index 0000000000..511e0c8849
--- /dev/null
+++ b/ja_JP.eucJP/books/fdp-primer/writing-style/chapter.sgml
@@ -0,0 +1,387 @@
+
+
+
+ 文体について
+
+ FreeBSD の文書はたくさんの人々によって書かれています.
+ そのため, 文書の一貫性を保てるよう, 作者向けにガイドラインがつくられています.
+
+
+
+
+ 短縮形は使わない
+
+
+ 短縮形は使わないでください.
+ スペルは常に完全な形で書き,
+ “Don't use contractions”
+ というような表現は使ってはいけません.
+
+
+ 短縮形を使わないことで文の調子が引き締まり, かたい感じになります.
+ また, 多少ですが翻訳者の負担を軽減できます.
+
+
+
+
+
+ 並記の際にはカンマを使う
+
+
+
+ 段落のなかで項目を並べる場合には,
+ それぞれの項目をカンマを使って分けてください.
+ 最後の項目では, カンマと “and” を使います.
+
+
+ たとえば, 次の例を見てください.
+
+
+ This is a list of one, two and three items.
+
+
+ さて, これは三つの項目, “one”,
+ “two” および “three”
+ を並べたものでしょうか?
+ それとも, 二つの項目, “one” と “two and three”
+ を並べたものなのでしょうか?
+
+
+ これは,
+ 並記の際にカンマを使うことではっきりさせることができます.
+
+
+ This is a list of one, two, and three items.
+
+
+
+
+
+ 冗長な表現を避ける
+
+
+ 冗長な表現を使わないよう配慮してください. 具体的に言うと,
+ “the command”,
+ “the file”,
+ そして “man command”
+ というような表現は, いずれも余計なものです.
+
+
+ ここに, コマンドに関する二つの例を示します.
+ 好ましいのは二番目の例です.
+
+
+ Use the command cvsup to update your
+ sources
+
+
+
+ Use cvsup to update your sources
+
+
+ 次に, ファイル名に関する二つの例を示します.
+ こちらも, 好ましいのは二番目の例です.
+
+
+ … in the filename
+ /etc/rc.local…
+
+
+
+ … in
+ /etc/rc.local…
+
+
+ マニュアルページ参照に関する二つの例を示します.
+ こちらも, 好ましいのは二番目の例です (二番目の例では,
+ citerefentry が使われています).
+
+
+ See man csh for more
+ information.
+
+
+
+ See &man.csh.1;
+
+
+
+
+
+ 文の最後には二個分の空白を入れる
+
+
+ 文の最後には, 常に二個分の空白を入れてください.
+ これは読みやすさを向上させるためと,
+ emacs
+ のようなツールで扱いやすくするためです.
+
+
+ 文の最後のピリオドに続く文字は大文字だから,
+ スペースの数が 一つでも文の最後と分かるじゃないか,
+ と思われた方がいらっしゃるかも知れませんが,
+ これは特に, 名前にピリオドが使われるときには当てはまりません.
+ 適当な例として, たとえば Jordan K. Hubbard
+ があげられます. この場合, ピリオドと一つのスペースの後ろに大文字の
+ H が来ていますが,
+ 明らかに新しい文のはじまりではありません.
+
+
+
+
+
+ 文体についての詳細は, William Strunk 氏による Elements of
+ Style が参考になります.
+
+
+ スタイルガイド
+
+ ハンドブックはたくさんの人々によって編集されます.
+ ソースファイルにおける一貫性を維持するため,
+ 以下にあげるようなスタイルを守るようにお願いします.
+
+
+
+ 大文字と小文字
+
+ タグは小文字で入力します.
+ <PARA>
+ ではなく,
+ <para> です.
+
+
+ SGML コンテキスト(訳注: DTD などの部分)では通常,
+ 大文字で書かれます.
+ たとえば <!entity…> や
+ <!doctype…>
+ ではなく,
+ <!ENTITY…> や
+ <!DOCTYPE…>
+ というように書きます.
+
+
+
+
+ 字下げ
+
+
+ Each file starts with indentation set at column 0,
+ regardless of the indentation level of the file
+ which might contain this one.
+
+ 開始タグでは必ず二個分の空白で字下げ幅を増やし,
+ 同様に終了タグでは二個分の空白で字下げ幅を減らします.
+ エレメント中の内容が一行以上にわたる場合は,
+ さらに二個分の空白で字下げされていなければなりません.
+
+
+ たとえば, このセクションのソースはつぎのようになっています.
+
+
+
+ ...
+
+
+ ...
+
+
+ Indentation
+
+ Each file starts with indentation set at column 0,
+ regardless of the indentation level of the file
+ which might contain this one.
+
+ Every start tag increases the indentation level by 2 spaces, and
+ every end tag decreases the indentation level by 2 spaces. Content
+ within elements should be indented by two spaces if the content runs
+ over more than one line.
+
+ ...
+
+
+]]>
+
+ ファイルの編集に Emacs か
+ Xemacs を使っている場合には
+ sgml-mode が自動的にロードされますので,
+ 各ファイルの最後に書かれた Emacs
+ のローカル変数によってこのスタイルが維持されます.
+
+
+
+ タグのスタイル
+
+
+ タグ間のスペース
+
+
+ タグはその前にあるタグと同じ字下げ幅ではじめ,
+ タグとの間は一行空けてください.
+ ただしその前のタグが同じ字下げ幅でなければ行を空けてはいけません.
+
+
+
+
+
+ NIS
+
+ October 1999
+
+
+ ...
+ ...
+ ...
+
+
+
+
+ ...
+
+ ...
+
+
+
+ ...
+
+ ...
+
+]]>
+
+
+
+
+ 特殊なタグ
+
+
+ いくつかのタグには前節であげた字下げルールにを適用しません.
+ screen タグと
+ programlisting タグは,
+ 常に左詰めにしてください.
+
+
+
+
+
+…
+
+]]>
+
+
+
+ informalexample タグも
+ screen や
+ programlisting
+ が含まれる場合には左詰めにします.
+
+
+ これらの例の場合は前後に空白行を入れ,
+ 残りのテキストと分離してください.
+
+
+
+
+ タグの分離
+
+
+ itemizedlist
+ のようなタグは常に内部に別のタグが入り,
+ 実際の文字データは入りません.
+ そのため, 常にタグだけで一行になります.
+
+
+ para と term は,
+ 通常の文字データを他のタグを使わずにそのまま入れることができます.
+ そのため, 内容は開始タグの直後,
+ すなわち同じ行からはじまります.
+
+
+ これは, 二種類のタグが閉じるときも同様です.
+
+ このルールは, この種のタグが混ぜて使われる際に問題となります.
+
+ 直接文字データを含むことができない開始タグに続くタグがこの種のタグ,
+ すなわち文字データを入れるために他のタグを使わなければならないものであった場合,
+ それらはそれぞれ独立した行になります.
+ 二番目のタグは, 適切に字下げされていなければなりません.
+
+
+ 文字データを直接含むことのできるタグが
+ データを直接含むことのできないタグの直後に現われる場合は,
+ それらは同一の行に共存することになります.
+
+
+
+
+
+ 空白の変更
+
+ 変更を commit する際には,
+ 内容の変更と体裁の変更を同時に
+ commit してはいけません.
+
+
+ これは, ハンドブックを他の言語に翻訳している翻訳チームがあなたの
+ commit で実際の内容が変更されたことをすぐに判別できるようにするためです.
+ commit が分けてあれば, その変更が内容的なものか,
+ それとも単に整形のためなのかを確認する必要がなくなります.
+
+
+ たとえば, ある段落に二つの文を追加する場合を考えてみましょう.
+ 文を追加したことにより, 段落の長さが 80 カラムを超えたとします.
+ そういう場合には, 最初の commit で整形せずに長いまま commit してください.
+ そして次に行の折り返しを行ない, 二回目としてその結果を commit します.
+ また, 二回目の commit ログには「これは空白の変更だけであり,
+ 翻訳チームは無視しても大丈夫です」ということを示すようにしてください.
+
+
+
+
+
+
+