os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Change punctuation style and tidy up.

Browse source 
Submitted by:	TAOKA Fumiyoshi <fmysh at iijmio-mail dot jp>
Reference:	[doc-jp-work 862]
This commit is contained in:
Hideyuki KURASHINA 2004-10-27 18:28:12 +00:00
parent 0189e2e092
commit 40ea1f25f1
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=22707
8 changed files with 708 additions and 708 deletions
ja_JP.eucJP/books/fdp-primer
book.sgml
overview
chapter.sgml
psgml-mode
chapter.sgml
see-also
chapter.sgml
structure
chapter.sgml
stylesheets
chapter.sgml
tools
chapter.sgml
writing-style
chapter.sgml

128
ja_JP.eucJP/books/fdp-primer/book.sgml
View file

@ -53,7 +53,7 @@
<firstname>Nik</firstname>
<surname>Clayton</surname>
<affiliation>
<address><email>nik@FreeBSD.org</email></address>
<address><email>nik@FreeBSD.org</email></address>
</affiliation>
</author>
@ -104,20 +104,20 @@
DAMAGE.</para>
</important>
</legalnotice>
<abstract>
<para>FreeBSD
ドキュメンテーションプロジェクトに参加してくださってありがとうございます.
あなたの貢献は非常に価値のあることです.</para>
ドキュメンテーションプロジェクトに参加してくださってありがとうございます。
あなたの貢献は非常に価値のあることです。</para>
<para>この入門では FreeBSD
ドキュメンテーションプロジェクトへの貢献を始めるにあたって理解する必要のあること,
すなわち(必須のものだけでなく, 推奨されるものも含めた)ツールやソフトウェアの使い方から,
ドキュメンテーションプロジェクトの方針にわたる内容のすべてを扱っています.</para>
ドキュメンテーションプロジェクトへの貢献を始めるにあたって理解する必要のあること、
すなわち(必須のものだけでなく、推奨されるものも含めた)ツールやソフトウェアの使い方から、
ドキュメンテーションプロジェクトの方針にわたる内容のすべてを扱っています。</para>
<para>この文書は発展途上にあり, まだ完成していません.
まだ完成していない節の名前には
<literal>*</literal>(アスタリスク) が付けてあります.</para>
<para>この文書は発展途上にあり、まだ完成していません。
まだ完成していない節の名前には
<literal>*</literal>(アスタリスク) が付けてあります。</para>
</abstract>
</bookinfo>
@ -126,11 +126,11 @@
<sect1>
<title>シェルプロンプト</title>
<para>以下の表は,
標準のシステムプロンプトとスーパーユーザのプロンプト示しています.
この文書であげる実例では,
どちらのユーザでその例を実行すべきか示すためにこれらのプロンプトを使用します.</para>
<para>以下の表は、
標準のシステムプロンプトとスーパーユーザのプロンプト示しています。
この文書であげる実例では、
どちらのユーザでその例を実行すべきか示すためにこれらのプロンプトを使用します。</para>
<informaltable frame="none">
<tgroup cols="2">
@ -141,7 +141,7 @@
<entry>プロンプト</entry>
</row>
</thead>
<tbody>
<row>
<entry>通常ユーザ</entry>
@ -158,12 +158,12 @@
</tgroup>
</informaltable>
</sect1>
<sect1>
<title>表記上の慣例</title>
<para>下の表は,
この文書で使われる表記上の慣例を示しています.</para>
<para>下の表は、
この文書で使われる表記上の慣例を示しています。</para>
<informaltable frame="none">
<tgroup cols="2">
@ -174,22 +174,22 @@
<entry>例</entry>
</row>
</thead>
<tbody>
<row>
<entry>コマンド, ファイル, ディレクトリの名前および,
コンピュータ画面への出力</entry>
<entry>コマンド、ファイル、ディレクトリの名前および、
コンピュータ画面への出力</entry>
<entry><para>あなたの
<filename>.login</filename> ファイルを編集してください.
</para><para>ファイルの一覧を表示するには
<command>ls -a</command> を使います.
</para><para><screen>You have mail.</screen></para></entry>
<filename>.login</filename> ファイルを編集してください。
</para><para>ファイルの一覧を表示するには
<command>ls -a</command> を使います。
</para><para><screen>You have mail.</screen></para></entry>
</row>
<row>
<entry>コンピュータの画面に表示されるものと,
あなたが入力するものを区別する場合</entry>
<entry>コンピュータの画面に表示されるものと、
あなたが入力するものを区別する場合</entry>
<entry><screen>&prompt.user; <userinput>su</userinput>
Password:</screen></entry>
@ -199,41 +199,41 @@ Password:</screen></entry>
<entry>マニュアルページの参照</entry>
<entry>ユーザ名を変更するには
<citerefentry>
<citerefentry>
<refentrytitle>su</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>
を使います.</entry>
を使います。</entry>
</row>
<row>
<entry>ユーザ名とグループ名</entry>
<entry>これが行なえるのは
<username>root</username> だけです.</entry>
<username>root</username> だけです。</entry>
</row>
<row>
<entry>強調部分</entry>
<entry>必ずこれを行なわなければ<emphasis>いけません</emphasis>.</entry>
<entry>必ずこれを行なわなければ<emphasis>いけません</emphasis>。</entry>
</row>
<row>
<entry>コマンドラインに書かれる引数.
これは実際にあるファイル名や変数名などに置き換えられます.
</entry>
<entry>コマンドラインに書かれる引数。
これは実際にあるファイル名や変数名などに置き換えられます。
</entry>
<entry>ファイルを消去するには,
<command>rm <filename><replaceable>ファイル名</replaceable></filename></command>
と入力します.</entry>
<entry>ファイルを消去するには、
<command>rm <filename><replaceable>ファイル名</replaceable></filename></command>
と入力します。</entry>
</row>
<row>
<entry>環境変数</entry>
<entry><envar>$HOME</envar>は,
あなたのホームディレクトリです.</entry>
<entry><envar>$HOME</envar>は、
あなたのホームディレクトリです。</entry>
</row>
</tbody>
</tgroup>
@ -241,34 +241,34 @@ Password:</screen></entry>
</sect1>
<sect1>
<title>注記(notes), 警告(warnings), 例示(examples)</title>
<title>注記(notes)、警告(warnings)、例示(examples)</title>
<para>注記や警告, 例示は本文中に書かれています.</para>
<para>注記や警告、例示は本文中に書かれています。</para>
<note>
<para>注記はこのような感じで表示されます.
これには, 読者が行なう操作に関連して
注意しなければならないことを伝えるための内容が含まれています.
</para>
<para>注記はこのような感じで表示されます。
これには、読者が行なう操作に関連して
注意しなければならないことを伝えるための内容が含まれています。
</para>
</note>
<warning>
<para>警告は, このような感じで表示されます.
これには, 手順に従わない場合に何らかの損害を被る可能性があることを
伝える内容が含まれています.
その損害はハードウェアや操作者に対する物理的なものかも知れませんし,
不注意で重要なファイルが削除されてしまうような非物理的なものかも知れません.
</para>
<para>警告は、このような感じで表示されます。
これには、手順に従わない場合に何らかの損害を被る可能性があることを
伝える内容が含まれています。
その損害はハードウェアや操作者に対する物理的なものかも知れませんし、
不注意で重要なファイルが削除されてしまうような非物理的なものかも知れません。
</para>
</warning>
<example>
<title>例示のサンプル</title>
<para>例示は, このような感じで表示されます.
これには通常, 読者自身が試す必要のある例や,
ある操作がどのような結果をもたらすのか,
読者に示すための例が含まれています.
</para>
<para>例示は、このような感じで表示されます。
これには通常、読者自身が試す必要のある例や、
ある操作がどのような結果をもたらすのか、
読者に示すための例が含まれています。
</para>
</example>
</sect1>
@ -276,14 +276,14 @@ Password:</screen></entry>
<title>謝辞</title>
<para>Sue Blake, Patrick Durusau,
Jon Hamilton, Peter Flynn,
Christopher Maden
はこの文書の初稿を読む時間を割いて,
たくさんの有益なコメントや批評を送ってくれました.
ここに感謝の意を表します.</para>
Jon Hamilton, Peter Flynn,
Christopher Maden
はこの文書の初稿を読む時間を割いて、
たくさんの有益なコメントや批評を送ってくれました。
ここに感謝の意を表します。</para>
</sect1>
</preface>
&chap.overview;
&chap.tools;
&chap.sgml-primer;
@ -295,7 +295,7 @@ Password:</screen></entry>
&chap.writing-style;
&chap.psgml-mode;
&chap.see-also;
</book>
<!--

276
ja_JP.eucJP/books/fdp-primer/overview/chapter.sgml
View file

@ -37,172 +37,172 @@
<chapter id="overview">
<title>概要</title>
<para>FreeBSD ドキュメンテーションプロジェクトへようこそ.
質の高い文書は, FreeBSD
を成功させるために欠かすことができない重要なものです. FreeBSD
<para>FreeBSD ドキュメンテーションプロジェクトへようこそ。
質の高い文書は、FreeBSD
を成功させるために欠かすことができない重要なものです。FreeBSD
ドキュメンテーションプロジェクト(FreeBSD Documentation Project;
FDP)は, そのような文書を数多く作成するためのプロジェクトです.
あなたの貢献は, 非常に貴重です.
FDP)は、そのような文書を数多く作成するためのプロジェクトです。
あなたの貢献は、非常に貴重です。
</para>
<para>この文書は主に <emphasis>FDP の構成</emphasis>,
<emphasis>文書の作成と FDP への提出方法</emphasis>および,
<para>この文書は主に <emphasis>FDP の構成</emphasis>、
<emphasis>文書の作成と FDP への提出方法</emphasis>および、
<emphasis>文書作成のために利用できるツールの効果的な利用法</emphasis>
について解説することを目的としています.
について解説することを目的としています。
</para>
<para><indexterm>
<primary>参加資格</primary>
</indexterm>
FDP は, どなたでも参加できます. 参加資格はありませんし,
毎月, 文書の作成が義務づけられているわけでもありません.
あなたがしなければならないのは, ただ
FDP は、どなたでも参加できます。参加資格はありませんし、
毎月、文書の作成が義務づけられているわけでもありません。
あなたがしなければならないのは、ただ
&a.doc;
メーリングリストに参加することだけです.
メーリングリストに参加することだけです。
</para>
<para>この文書を読み終えた後,
あなたは次のようになっていなければなりません. </para>
<para>この文書を読み終えた後、
あなたは次のようになっていなければなりません。</para>
<itemizedlist>
<listitem>
<para>どれが FDP が管理する文書はなのか理解して下さい. </para>
</listitem>
<listitem>
<para>FDP の管理する文書の SGML のソースコードを読み,
意味が理解できるようになってください.
<para>どれが FDP が管理する文書はなのか理解して下さい。</para>
</listitem>
<listitem>
<para>FDP の管理する文書の SGML のソースコードを読み、
意味が理解できるようになってください。
</para>
</listitem>
<listitem>
<para>文書へ変更を加える操作ができるようになってください. </para>
</listitem>
<listitem>
<para>あなたの変更が査読を受け, FreeBSD
の文書として採用にまわせるよう, 変更の提出ができるようになってください.
<para>文書へ変更を加える操作ができるようになってください。</para>
</listitem>
<listitem>
<para>あなたの変更が査読を受け、FreeBSD
の文書として採用にまわせるよう、変更の提出ができるようになってください。
</para>
</listitem>
</listitem>
</itemizedlist>
<sect1 id="overview-doc">
<title>FreeBSD 文書セット</title>
<para>FDP では FreeBSD 関連文書のうち, 次の
4 つのカテゴリを担当しています.
<para>FDP では FreeBSD 関連文書のうち、次の
4 つのカテゴリを担当しています。
</para>
<variablelist>
<varlistentry>
<term>マニュアルページ</term>
<term>マニュアルページ</term>
<listitem>
<para>システムの英語版マニュアルページは基本システムの一部であり,
FDP がその作成を担当しているわけではありません.
しかし FDP は, マニュアルページをよりわかりやすくしたり,
不正確な記述を修正するため, 既存のマニュアルページの改編を行なうことが
できます.
</para>
<listitem>
<para>システムの英語版マニュアルページは基本システムの一部であり、
FDP がその作成を担当しているわけではありません。
しかし FDP は、マニュアルページをよりわかりやすくしたり、
不正確な記述を修正するため、既存のマニュアルページの改編を行なうことが
できます。
</para>
<para>翻訳チームは, システムのマニュアルページを他言語に翻訳する
作業を担当しています. この翻訳作業は, FDP の担当範囲内です.
</para>
</listitem>
<para>翻訳チームは、システムのマニュアルページを他言語に翻訳する
作業を担当しています。この翻訳作業は、FDP の担当範囲内です。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>FAQ</term>
<listitem>
<para>FAQ は, FreeBSD
に関連するさまざまなメーリングリストやニュースグループで
よく尋ねられる質問, あるいは質問されるべきものについて,
(短い質疑応答形式で)取り扱ったものです.
この形式では, 必要以上に長く細かい回答は許されません.
</para>
</listitem>
<term>FAQ</term>
<listitem>
<para>FAQ は、FreeBSD
に関連するさまざまなメーリングリストやニュースグループで
よく尋ねられる質問、あるいは質問されるべきものについて、
(短い質疑応答形式で)取り扱ったものです。
この形式では、必要以上に長く細かい回答は許されません。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ハンドブック</term>
<term>ハンドブック</term>
<listitem>
<para>ハンドブックは広範囲の話題を扱った FreeBSD のユーザのための
オンライン情報源, およびリファレンスとなることを意図したものです.
</para>
</listitem>
<listitem>
<para>ハンドブックは広範囲の話題を扱った FreeBSD のユーザのための
オンライン情報源、およびリファレンスとなることを意図したものです。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ウェブサイト</term>
<listitem>
<para>これは, World Wide Web において中心的な FreeBSD のサイトであり,
<ulink url="../../../../index.html">http://www.FreeBSD.org/</ulink>
と, 世界中に存在するたくさんのミラーサイトから見ることができます.
このウェブサイトは, 多くの人々が FreeBSD
を初めて目にする場所でもあります.
</para>
<term>ウェブサイト</term>
<listitem>
<para>これは、World Wide Web において中心的な FreeBSD のサイトであり、
<ulink url="../../../../index.html">http://www.FreeBSD.org/</ulink>
と、世界中に存在するたくさんのミラーサイトから見ることができます。
このウェブサイトは、多くの人々が FreeBSD
を初めて目にする場所でもあります。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>この 4 種類の文書は, いずれも FreeBSD CVS ツリーから入手することができます.
そのため, ファイルへの変更履歴は一般に公開されていて,
<para>この 4 種類の文書は、いずれも FreeBSD CVS ツリーから入手することができます。
そのため、ファイルへの変更履歴は一般に公開されていて、
<application>CVSup</application> や
<application>CTM</application> といったプログラムを使い
誰でも文書のローカルコピーを最新のものに保つことができます.
誰でも文書のローカルコピーを最新のものに保つことができます。
</para>
<para>さらに, たくさんの人々がチュートリアルや FreeBSD
関連のウェブサイトをつくっています. それらのなかには,
<para>さらに、たくさんの人々がチュートリアルや FreeBSD
関連のウェブサイトをつくっています。それらのなかには、
他の文書と同じように CVS リポジトリ(の原作者が同意した場所)に
含まれているものもある一方, FreeBSD のリポジトリからは分離して,
原作者の手によって直接保守されているものもあります.
FDP では, そのような文書に対して可能な限り,
リンクを提供するように努力しています.
含まれているものもある一方、FreeBSD のリポジトリからは分離して、
原作者の手によって直接保守されているものもあります。
FDP では、そのような文書に対して可能な限り、
リンクを提供するように努力しています。
</para>
</sect1>
<sect1 id="overview-before">
<title>はじめる前に</title>
<para>この文書は, 次にあげる内容について
あなたがすでに理解していることを前提として書かれています.
<para>この文書は、次にあげる内容について
あなたがすでに理解していることを前提として書かれています。
</para>
<itemizedlist>
<itemizedlist>
<listitem>
<para>FreeBSD CVS リポジトリのローカルコピーを
(<application>CVS</application>, もしくは
(<application>CVS</application>、もしくは
<application>CVSup</application> か
<application>CTM</application> を使って) 入手したり,
<application>CVSup</application> を使って
<application>CTM</application> を使って) 入手したり、
<application>CVSup</application> を使って
<emphasis>チェックアウトした(checked-out)</emphasis>コピーを
ダウンロードすることで,
FreeBSD の文書のローカルコピーを最新に維持する方法について.
</para>
ダウンロードすることで、
FreeBSD の文書のローカルコピーを最新に維持する方法について。
</para>
</listitem>
<listitem>
<para>FreeBSD Ports システム, もしくは &man.pkg.add.1
を利用して新しいソフトウェアをダウンロードし, インストールする方法について.
</para>
</listitem>
</itemizedlist>
<para>FreeBSD Ports システム、もしくは &man.pkg.add.1
を利用して新しいソフトウェアをダウンロードし、インストールする方法について。
</para>
</listitem>
</itemizedlist>
</sect1>
<sect1 id="overview-quick-start">
<title>まずははじめてみる</title>
<para>もし何かやってみたくなって, 継続してやっていく自信があるなら,
以下の手順を追ってみてください.</para>
<para>もし何かやってみたくなって、継続してやっていく自信があるなら、
以下の手順を追ってみてください。</para>
<procedure>
<step>
<para><filename role="package">textproc/docproj</filename> メタ port を
インストールします.</para>
インストールします。</para>
<screen>&prompt.root; <userinput>cd /usr/ports/textproc/docproj</userinput>
&prompt.root; <userinput>make JADETEX=no install</userinput></screen>
@ -210,48 +210,48 @@
<step>
<para>FreeBSD <filename>doc</filename> ツリーのローカルコピー
を入手します.
CVSup を <literal>checkout</literal> モードで使うか,
CVS リポジトリの完全なコピーをローカルに取り寄せるかします.
を入手します。
CVSup を <literal>checkout</literal> モードで使うか、
CVS リポジトリの完全なコピーをローカルに取り寄せるかします。
</para>
<para>CVS リポジトリをローカルに持つようにした場合,
<para>CVS リポジトリをローカルに持つようにした場合、
少なくとも <filename>doc/share</filename> と
<filename>doc/en_US.ISO8859-1/share</filename> ディレクトリ
をチェックアウトする必要があります.</para>
をチェックアウトする必要があります。</para>
<screen>&prompt.user; <userinput>cvs checkout doc/share</userinput>
&prompt.user; <userinput>cvs checkout doc/en_US.ISO8859-1/share</userinput></screen>
<para>ディスクスペースに余裕があるようでしたら, 全てをチェックアウト
してしまうこともできます.</para>
<para>ディスクスペースに余裕があるようでしたら、全てをチェックアウト
してしまうこともできます。</para>
<screen>&prompt.user; <userinput>cvs checkout doc</userinput></screen>
</step>
<step>
<para>既存の book もしくは article に変更を加えようと
している場合には, リポジトリのその部分をチェックアウトします.
新規に book や article を寄稿しようとしている場合には,
既存のものをテンプレートとして使ってください.</para>
している場合には、リポジトリのその部分をチェックアウトします。
新規に book や article を寄稿しようとしている場合には、
既存のものをテンプレートとして使ってください。</para>
<para>例えば, FreeBSD と Windows 2000 の間に VPN を設定するような
新しい article を寄稿しようとしている場合, 以下のようにします.
<para>例えば、FreeBSD と Windows 2000 の間に VPN を設定するような
新しい article を寄稿しようとしている場合、以下のようにします。
</para>
<procedure>
<step>
<para><filename>articles</filename> ディレクトリを
チェックアウトします.</para>
チェックアウトします。</para>
<screen>&prompt.user; <userinput>cvs checkout doc/en_US.ISO8859-1/articles</userinput></screen>
</step>
<step>
<para>既存の article をテンプレートとして使うために
コピーします.
今回は, 新しい article は <filename>vpn-w2k</filename>
というディレクトリに入れることにしましょう.</para>
コピーします。
今回は、新しい article は <filename>vpn-w2k</filename>
というディレクトリに入れることにしましょう。</para>
<screen>&prompt.user; <userinput>cd doc/en_US.ISO8859-1/articles</userinput>
&prompt.user; <userinput>cp -r committers-guide vpn-w2k</userinput></screen>
@ -259,59 +259,59 @@
</procedure>
<para>もし <filename>doc/en_US.ISO8859-1/books/faq</filename>
にある FAQ のような既存の文書に手を加える場合,
リポジトリから以下のようにチェックアウトします.</para>
にある FAQ のような既存の文書に手を加える場合、
リポジトリから以下のようにチェックアウトします。</para>
<screen>&prompt.user; <userinput>cvs checkout doc/en_US.ISO8859-1/books/faq</userinput></screen>
</step>
<step>
<para><filename>.sgml</filename> ファイルをあなたの好きな
エディタで編集します.</para>
エディタで編集します。</para>
</step>
<step>
<para><maketarget>lint</maketarget> ターゲットでマークアップ
をテストします.
これにより, 時間のかかる変換を実際に行なうこと無く,
文書中の間違いをすばやく見つけることができます.</para>
をテストします。
これにより、時間のかかる変換を実際に行なうこと無く、
文書中の間違いをすばやく見つけることができます。</para>
<screen>&prompt.user; <userinput>make lint</userinput></screen>
<para>文書を実際に構築する準備ができたら,
<varname>FORMATS</varname> 変数で単一のフォーマット,
もしくはフォーマットの一覧を指定することができます.
今のところ,
<literal>html</literal>, <literal>html-split</literal>,
<literal>txt</literal>, <literal>ps</literal>,
<literal>pdf</literal>, <literal>rtf</literal>
が指定できます.
<para>文書を実際に構築する準備ができたら、
<varname>FORMATS</varname> 変数で単一のフォーマット、
もしくはフォーマットの一覧を指定することができます。
今のところ、
<literal>html</literal>, <literal>html-split</literal>,
<literal>txt</literal>, <literal>ps</literal>,
<literal>pdf</literal>, <literal>rtf</literal>
が指定できます。
サポートされているフォーマットの最新のリストは
<filename>doc/share/mk/doc.docbook.mk</filename> ファイルの
先頭を見てください.
先頭を見てください。
単一のコマンドで複数のフォーマットを構築しようとする際
には, フォーマットの一覧を引用符で括ることを忘れないでください.
には、フォーマットの一覧を引用符で括ることを忘れないでください。
</para>
<para>例えば, 文書を <literal>html</literal> に変換する
<para>例えば、文書を <literal>html</literal> に変換する
だけなら以下のようになります:</para>
<screen>&prompt.user; <userinput>make FORMATS=html</userinput></screen>
<para>文書を <literal>html</literal> と <literal>txt</literal>
の両方のフォーマットに変換したい場合は, 以下のように
<para>文書を <literal>html</literal> と <literal>txt</literal>
の両方のフォーマットに変換したい場合は、以下のように
&man.make.1; を二回にわけて実行することでできます:</para>
<screen>&prompt.user; <userinput>make FORMATS=html</userinput>
&prompt.user; <userinput>make FORMATS=txt</userinput></screen>
<para>一回のコマンドで実行するには, 以下のようになります:</para>
<para>一回のコマンドで実行するには、以下のようになります:</para>
<screen>&prompt.user; <userinput>make FORMATS="html txt"</userinput></screen>
</step>
<step>
<para>変更点を &man.send-pr.1; を使って提出します.</para>
<para>変更点を &man.send-pr.1; を使って提出します。</para>
</step>
</procedure>
</sect1>

146
ja_JP.eucJP/books/fdp-primer/psgml-mode/chapter.sgml
View file

@ -38,124 +38,124 @@
<literal>sgml-mode</literal> を利用する</title>
<para>新しいバージョンの <application>Emacs</application> や
<application>Xemacs</application> (Ports Collection にあります)には,
PSGML と呼ばれる非常に便利なパッケージが附属しています.
これは拡張子がとなっている <filename>.sgml</filename> のファイルが読み込まれるか,
<command>M-x sgml-mode</command> と入力することで呼び出されます.
PSGML は, SGML ファイルやエレメント, 属性を扱うためのメジャーモードです.
<application>Xemacs</application> (Ports Collection にあります)には、
PSGML と呼ばれる非常に便利なパッケージが附属しています。
これは拡張子がとなっている <filename>.sgml</filename> のファイルが読み込まれるか、
<command>M-x sgml-mode</command> と入力することで呼び出されます。
PSGML は、SGML ファイルやエレメント、属性を扱うためのメジャーモードです。
</para>
<para>このモードで提供されているいくつかのコマンドを知っていれば,
ハンドブックなどの SGML 文書をより簡単に扱うことができるようになります.
<para>このモードで提供されているいくつかのコマンドを知っていれば、
ハンドブックなどの SGML 文書をより簡単に扱うことができるようになります。
</para>
<variablelist>
<varlistentry>
<term><command>C-c C-e</command></term>
<listitem>
<para><literal>sgml-insert-element</literal> を実行します.
実行すると, 現在のカーソル位置に挿入すべきエレメント名が聞かれ,
TAB キーを使うことでエレメント名の補完ができます. また,
カーソル位置に挿入できないエレメント名は入力できないようになっています.
</para>
<para>挿入は, 指定したエレメントのスタートタグとエンドタグが両方行なわれます.
もし, そのエレメントが他の必須エレメントを含む場合は,
その必須エレメントも同じように挿入されます.
</para>
<listitem>
<para><literal>sgml-insert-element</literal> を実行します。
実行すると、現在のカーソル位置に挿入すべきエレメント名が聞かれ、
TAB キーを使うことでエレメント名の補完ができます。また、
カーソル位置に挿入できないエレメント名は入力できないようになっています。
</para>
<para>挿入は、指定したエレメントのスタートタグとエンドタグが両方行なわれます。
もし、そのエレメントが他の必須エレメントを含む場合は、
その必須エレメントも同じように挿入されます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><command>C-c =</command></term>
<listitem>
<para><literal>sgml-change-element-name</literal> を実行します.
カーソルをエレメントの内側に移動させてこのコマンドを実行して下さい.
変更するエレメント名が聞かれ, 現在のエレメントのスタートタグとエンドタグが
入力した新しいエレメントのものに変更されます.
</para>
<para><literal>sgml-change-element-name</literal> を実行します。
カーソルをエレメントの内側に移動させてこのコマンドを実行して下さい。
変更するエレメント名が聞かれ、現在のエレメントのスタートタグとエンドタグが
入力した新しいエレメントのものに変更されます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><command>C-c C-r</command></term>
<listitem>
<para><literal>sgml-tag-region</literal> を実行します.
テキストを指定(テキストの開始点に移動して C-Space を押し,
終了点に移動して C-Space を押す)してから, このコマンドを実行して下さい.
利用するエレメント名が聞かれ,
マークが付けられた範囲(リージョン)のすぐ前後に指定したエレメントが挿入されます.
</para>
<para><literal>sgml-tag-region</literal> を実行します。
テキストを指定(テキストの開始点に移動して C-Space を押し、
終了点に移動して C-Space を押す)してから、このコマンドを実行して下さい。
利用するエレメント名が聞かれ、
マークが付けられた範囲(リージョン)のすぐ前後に指定したエレメントが挿入されます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><command>C-c -</command></term>
<listitem>
<para><literal>sgml-untag-element</literal> を実行します.
カーソルを削除したいエレメントのスタートタグか, エンドタグの上において
このコマンドを実行して下さい. すると, エレメントのスタートタグ,
エンドタグが両方とも削除されます.
</para>
<para><literal>sgml-untag-element</literal> を実行します。
カーソルを削除したいエレメントのスタートタグか、エンドタグの上において
このコマンドを実行して下さい。すると、エレメントのスタートタグ、
エンドタグが両方とも削除されます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><command>C-c C-q</command></term>
<listitem>
<para><literal>sgml-fill-element</literal> を実行します.
実行すると, カーソル位置のエレメントの内容に対して,
(整形する時のように)再帰的な文章の詰めが行なわれます.
この詰め作業は, 含まれている空白文字が重要なもの, たとえば
<sgmltag>programlisting</sgmltag>
エレメントの中などでも<emphasis>効果があります</emphasis>ので,
利用の際は注意して下さい.
</para>
<para><literal>sgml-fill-element</literal> を実行します。
実行すると、カーソル位置のエレメントの内容に対して、
(整形する時のように)再帰的な文章の詰めが行なわれます。
この詰め作業は、含まれている空白文字が重要なもの、たとえば
<sgmltag>programlisting</sgmltag>
エレメントの中などでも<emphasis>効果があります</emphasis>ので、
利用の際は注意して下さい。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><command>C-c C-a</command></term>
<listitem>
<para><literal>sgml-edit-attributes</literal> を実行します.
実行するともう一つバッファを開き,
最も近い閉じたエレメントのすべての属性のリストと, 現在の値を表示します.
TAB を使って属性間を移動することができ, <command>C-k</command> を
押すことで, 既存の値を新しいものに置き換えることができます.
また, <command>C-c C-c</command> を押すことで, バッファを閉じて
元の文書に戻ることができます.
</para>
<para><literal>sgml-edit-attributes</literal> を実行します。
実行するともう一つバッファを開き、
最も近い閉じたエレメントのすべての属性のリストと、現在の値を表示します。
TAB を使って属性間を移動することができ、<command>C-k</command> を
押すことで、既存の値を新しいものに置き換えることができます。
また、<command>C-c C-c</command> を押すことで、バッファを閉じて
元の文書に戻ることができます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><command>C-c C-v</command></term>
<listitem>
<para><literal>sgml-validate</literal> を実行します.
実行すると(必要に応じて)現在編集中の文書をセーブするかどうか聞かれ,
次に SGML の正当性検査が行なわれます.
検査の出力は新しいバッファに表示されますので,
誤りのある部分へひとつひとつ移動してマークアップのミスを修正することができます.
</para>
<para><literal>sgml-validate</literal> を実行します。
実行すると(必要に応じて)現在編集中の文書をセーブするかどうか聞かれ、
次に SGML の正当性検査が行なわれます。
検査の出力は新しいバッファに表示されますので、
誤りのある部分へひとつひとつ移動してマークアップのミスを修正することができます。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>もちろん, このモードには他にも有用な機能があります.
ここにあげたのは, その中でもわたしが非常に頻繁に利用しているものです.
<para>もちろん、このモードには他にも有用な機能があります。
ここにあげたのは、その中でもわたしが非常に頻繁に利用しているものです。
</para>
<para>ドキュメンテーションプロジェクトで作業するのに,
適切な空白, インデント, コラム幅を設定するのに,
<para>ドキュメンテーションプロジェクトで作業するのに、
適切な空白、インデント、コラム幅を設定するのに、
<filename>.emacs</filename>
に以下のエントリを使うことができます.</para>
に以下のエントリを使うことができます。</para>
<programlisting>
(setq sgml-mode-hook

20
ja_JP.eucJP/books/fdp-primer/see-also/chapter.sgml
View file

@ -37,9 +37,9 @@
<chapter id="see-also">
<title>参考サイト</title>
<para>この文書は, SGML や DTD, FreeBSD ドキュメンテーションプロジェクトに関して,
すべてを網羅したものではありません. さらに詳しい内容については,
以下のウェブサイトをご覧になることをおすすめします.
<para>この文書は、SGML や DTD、FreeBSD ドキュメンテーションプロジェクトに関して、
すべてを網羅したものではありません。さらに詳しい内容については、
以下のウェブサイトをご覧になることをおすすめします。
</para>
<sect1 id="see-also-fdp">
@ -62,10 +62,10 @@
<itemizedlist>
<listitem>
<para><ulink url="http://www.oasis-open.org/cover/">SGML/XML ウェブページ</ulink>.
これは広範囲にわたる網羅的な SGML の情報源です. </para>
<para><ulink url="http://www.oasis-open.org/cover/">SGML/XML ウェブページ</ulink>。
これは広範囲にわたる網羅的な SGML の情報源です。</para>
</listitem>
<listitem>
<para><ulink
url='http://etext.virginia.edu/bin/tei-tocs?div=DIV1&amp;id=SG'>やさしい SGML 入門</ulink></para>
@ -94,19 +94,19 @@
<listitem>
<para><ulink url="http://www.oasis-open.org/docbook/">The DocBook
Technical Committee</ulink>.
ここは DocBook DTD の保守を行なっているところです. </para>
ここは DocBook DTD の保守を行なっているところです。</para>
</listitem>
<listitem>
<para><ulink url="http://www.docbook.org/">DocBook: The Definitive
Guide</ulink>。DocBook DTD のオンライン文書。</para>
</listitem>
<listitem>
<para><ulink url="http://docbook.sourceforge.net/">The DocBook Open
Repository</ulink>。DSSSL stylesheets など、DocBook
の利用者向けの情報があります。</para>
の利用者向けの情報があります。</para>
</listitem>
</itemizedlist>
</sect1>
@ -117,7 +117,7 @@
<itemizedlist>
<listitem>
<para><ulink url="http://www.linuxdoc.org/">Linux
ドキュメンテーションプロジェクトのウェブページ</ulink></para>
ドキュメンテーションプロジェクトのウェブページ</ulink></para>
</listitem>
</itemizedlist>
</sect1>

288
ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml
View file

@ -37,9 +37,9 @@
<chapter id="structure">
<title><filename>doc/</filename> 以下に構成されている文書</title>
<para><filename>doc/</filename> ソースツリーは, ある一貫した方針で構成されています.
また, そのうち FDP が管理する文書は, さらに別の方針で構成されています.
これは新しい文書をソースツリーに追加する作業の単純化に加え, </para>
<para><filename>doc/</filename> ソースツリーは、ある一貫した方針で構成されています。
また、そのうち FDP が管理する文書は、さらに別の方針で構成されています。
これは新しい文書をソースツリーに追加する作業の単純化に加え、</para>
<orderedlist>
<listitem>
@ -47,8 +47,8 @@
</listitem>
<listitem>
<para>他の異なる文書構成との間の一貫性を維持し,
相互に作業しやすくすること
<para>他の異なる文書構成との間の一貫性を維持し、
相互に作業しやすくすること
</para>
</listitem>
@ -57,17 +57,17 @@
</listitem>
</orderedlist>
<para>を目的としています.
さらに文書のソースツリーは, さまざまな異なる言語や
文字エンコーディングに対応できなければなりません.
<para>を目的としています。
さらに文書のソースツリーは、さまざまな異なる言語や
文字エンコーディングに対応できなければなりません。
文書ツリーの構造が特定の慣習や文化背景を強制するものであっては
ならないという点は重要です. </para>
ならないという点は重要です。</para>
<sect1 id="structure-top">
<title>ソースツリーの最上位 <filename>doc/</filename></title>
<para><filename>doc/</filename> の下には二種類のディレクトリがあり,
各ディレクトリはそれぞれ, 特別な名前と意味を持っています. </para>
<para><filename>doc/</filename> の下には二種類のディレクトリがあり、
各ディレクトリはそれぞれ、特別な名前と意味を持っています。</para>
<segmentedlist>
<segtitle>ディレクトリ</segtitle>
@ -76,25 +76,25 @@
<seglistitem>
<seg><filename>share/</filename></seg>
<seg>このディレクトリには, 文書の翻訳やエンコーディングに依存しないファイルが収められ,
その分類のためのサブディレクトリがつくられています.
たとえば, &man.make.1; で使用されるファイルは <filename>share/mk</filename>
に, (FreeBSD で拡張された DocBook DTD などの) SGML 関連のファイルは
<filename>share/sgml</filename> におかれています. </seg>
<seg>このディレクトリには、文書の翻訳やエンコーディングに依存しないファイルが収められ、
その分類のためのサブディレクトリがつくられています。
たとえば、&man.make.1; で使用されるファイルは <filename>share/mk</filename>
に、(FreeBSD で拡張された DocBook DTD などの) SGML 関連のファイルは
<filename>share/sgml</filename> におかれています。</seg>
</seglistitem>
<seglistitem>
<seg><filename><replaceable>lang</replaceable>.<replaceable>encoding</replaceable>/</filename></seg>
<seg>各々の文書の翻訳, エンコーディングに対して,
それに対応する一つのディレクトリがあります.
具体的には, <filename>en_US.ISO8859-1/</filename> や
<filename>zh_TW.Big5/</filename> というディレクトリです.
ディレクトリ名が長いのですが, 言語とエンコーディングを完全に記述することで,
翻訳チームが将来的に, 同一の言語で異なるエンコーディングの
文書を提供する際に発生する問題を回避することができます.
また, Unicode に移行するとしても, この方法ならば問題はまったくありません. </seg>
<seg>各々の文書の翻訳、エンコーディングに対して、
それに対応する一つのディレクトリがあります。
具体的には、<filename>en_US.ISO8859-1/</filename> や
<filename>zh_TW.Big5/</filename> というディレクトリです。
ディレクトリ名が長いのですが、言語とエンコーディングを完全に記述することで、
翻訳チームが将来的に、同一の言語で異なるエンコーディングの
文書を提供する際に発生する問題を回避することができます。
また、Unicode に移行するとしても、この方法ならば問題はまったくありません。</seg>
</seglistitem>
</segmentedlist>
</sect1>
@ -104,9 +104,9 @@
<filename><replaceable>lang</replaceable>.<replaceable>encoding</replaceable>/</filename>
ディレクトリ群</title>
<para>これらのディレクトリには, 文書そのものがおかれています.
文書はこのディレクトリからさらに,
それぞれ異なるディレクトリ名で示される三種類に分類されます. </para>
<para>これらのディレクトリには、文書そのものがおかれています。
文書はこのディレクトリからさらに、
それぞれ異なるディレクトリ名で示される三種類に分類されます。</para>
<segmentedlist>
<segtitle>ディレクトリ</segtitle>
@ -115,46 +115,46 @@
<seglistitem>
<seg><filename>articles</filename></seg>
<seg>DocBook の <sgmltag>article</sgmltag>(もしくはそれと同等なもの)
でマークアップされた文書です.
文書は短めのもので, 構成単位は節(section)となっています.
通常, 一つの HTML ファイルとして生成されます. </seg>
でマークアップされた文書です。
文書は短めのもので、構成単位は節(section)となっています。
通常、一つの HTML ファイルとして生成されます。</seg>
</seglistitem>
<seglistitem>
<seg><filename>books</filename></seg>
<seg>DocBook の <sgmltag>book</sgmltag>(もしくはそれと同等なもの)
でマークアップされた文書です. 文書は比較的長めで,
構成単位は章(chapter)となっています. 通常,
(高速なネットワーク接続を持っている人や,
ブラウザからの印刷に便利なよう)大きな単一の HTML ファイルと,
リンクされた小さな HTML ファイルの両方が生成されます. </seg>
でマークアップされた文書です。文書は比較的長めで、
構成単位は章(chapter)となっています。通常、
(高速なネットワーク接続を持っている人や、
ブラウザからの印刷に便利なよう)大きな単一の HTML ファイルと、
リンクされた小さな HTML ファイルの両方が生成されます。</seg>
</seglistitem>
<seglistitem>
<seg><filename>man</filename></seg>
<seg>システムのマニュアルページの翻訳をおくためのディレクトリです.
このディレクトリには, さらに <filename>man<replaceable>n</replaceable></filename> という,
翻訳されたマニュアルのセクションに対応する複数のディレクトリがあります. </seg>
<seg>システムのマニュアルページの翻訳をおくためのディレクトリです。
このディレクトリには、さらに <filename>man<replaceable>n</replaceable></filename> という、
翻訳されたマニュアルのセクションに対応する複数のディレクトリがあります。</seg>
</seglistitem>
</segmentedlist>
<para>
ここで説明したディレクトリすべてが, 必ずそれぞれの
ここで説明したディレクトリすべてが、必ずそれぞれの
<filename><replaceable>lang</replaceable>.<replaceable>encoding</replaceable></filename>
ディレクトリにあるというわけではありません.
どのディレクトリが存在するかについては, 翻訳チームがどれだけ翻訳を完了しているかに依存します.
ディレクトリにあるというわけではありません。
どのディレクトリが存在するかについては、翻訳チームがどれだけ翻訳を完了しているかに依存します。
</para>
</sect1>
<sect1 id="structure-document">
<title>特定の文書に関する情報</title>
<para>このセクションでは, FDP
が管理する特定の文書に関する注意点が書かれています.
<para>このセクションでは、FDP
が管理する特定の文書に関する注意点が書かれています。
</para>
<sect2>
@ -162,142 +162,142 @@
<subtitle><filename>books/handbook/</filename></subtitle>
<para>ハンドブックは, FreeBSD
によって拡張された DocBook DTD で書かれています.
<para>ハンドブックは、FreeBSD
によって拡張された DocBook DTD で書かれています。
</para>
<para>ハンドブックは, DocBook の <sgmltag>book</sgmltag>
によって構成されています.
そしてそれは複数の <sgmltag>part</sgmltag> に分割され,
<sgmltag>part</sgmltag> はいくつかの <sgmltag>chapter</sgmltag>
を含みます. <sgmltag>chapter</sgmltag> は
さらにセクション(<sgmltag>sect1</sgmltag>), サブセクション
(<sgmltag>sect2</sgmltag>, <sgmltag>sect3</sgmltag>)
などに分割されています.
<para>ハンドブックは、DocBook の <sgmltag>book</sgmltag>
によって構成されています。
そしてそれは複数の <sgmltag>part</sgmltag> に分割され、
<sgmltag>part</sgmltag> はいくつかの <sgmltag>chapter</sgmltag>
を含みます。<sgmltag>chapter</sgmltag> は
さらにセクション(<sgmltag>sect1</sgmltag>)、サブセクション
(<sgmltag>sect2</sgmltag>, <sgmltag>sect3</sgmltag>)
などに分割されています。
</para>
<sect3>
<title>物理的な構成</title>
<para><filename>handbook</filename> ディレクトリには,
数多くのファイルとディレクトリがおかれています. </para>
<para><filename>handbook</filename> ディレクトリには、
数多くのファイルとディレクトリがおかれています。</para>
<note>
<para>ハンドブックの構成は, 時より変更されますので,
この文書では,
構成変更の細かな部分の記述が古くなってしまっているかも知れません.
ハンドブックの構成について疑問点がありましたら,
FreeBSD ドキュメンテーションプロジェクト
<email>freebsd-doc@FreeBSD.org</email> まで連絡下さい.
</para>
<para>ハンドブックの構成は、時より変更されますので、
この文書では、
構成変更の細かな部分の記述が古くなってしまっているかも知れません。
ハンドブックの構成について疑問点がありましたら、
FreeBSD ドキュメンテーションプロジェクト
<email>freebsd-doc@FreeBSD.org</email> まで連絡下さい。
</para>
</note>
<sect4>
<title><filename>Makefile</filename></title>
<para><filename>Makefile</filename> は, SGML
ソースを他の形式に変換する方法を決めたり,
ハンドブックを構築する各種ソースファイルを列挙する
さまざまな変数を定義するものです.
このファイルは, 文書形式の変換を扱うためのコードを取り込むために
標準の <filename>doc.project.mk</filename> をインクルードします.
</para>
<para><filename>Makefile</filename> は、SGML
ソースを他の形式に変換する方法を決めたり、
ハンドブックを構築する各種ソースファイルを列挙する
さまざまな変数を定義するものです。
このファイルは、文書形式の変換を扱うためのコードを取り込むために
標準の <filename>doc.project.mk</filename> をインクルードします。
</para>
</sect4>
<sect4>
<title><filename>book.sgml</filename></title>
<para>これはハンドブックの構造において最上位にあたる文書です.
ハンドブックの <link
<para>これはハンドブックの構造において最上位にあたる文書です。
ハンドブックの <link
linkend="sgml-primer-doctype-declaration">DOCTYPE
宣言</link>とハンドブックの構成を記述するためのエレメントが含まれています.
</para>
宣言</link>とハンドブックの構成を記述するためのエレメントが含まれています。
</para>
<para><filename>book.sgml</filename> は,
<filename>.ent</filename>
という拡張子のついたファイルをロードするために<link
linkend="sgml-primer-parameter-entities">パラメータ実体(parameter
entities)</link>を使います. (後述する)これらのファイルには,
ハンドブックの他の部分で共通して使われる<link
linkend="sgml-primer-general-entities">一般実体(general
entities)</link>
が定義されています. </para>
<para><filename>book.sgml</filename> は、
<filename>.ent</filename>
という拡張子のついたファイルをロードするために<link
linkend="sgml-primer-parameter-entities">パラメータ実体(parameter
entities)</link>を使います。(後述する)これらのファイルには、
ハンドブックの他の部分で共通して使われる<link
linkend="sgml-primer-general-entities">一般実体(general
entities)</link>
が定義されています。</para>
</sect4>
<sect4>
<title><filename><replaceable>directory</replaceable>/chapter.sgml</filename></title>
<para>ハンドブックの各章は, 互いに個別に分けられたディレクトリに
<filename>chapter.sgml</filename> というファイルとして格納されています.
それぞれのディレクトリには, <sgmltag>chapter</sgmltag> エレメントの
<literal>id</literal> 属性の値と同じ名前が付けられています.
</para>
<para>ハンドブックの各章は、互いに個別に分けられたディレクトリに
<filename>chapter.sgml</filename> というファイルとして格納されています。
それぞれのディレクトリには、<sgmltag>chapter</sgmltag> エレメントの
<literal>id</literal> 属性の値と同じ名前が付けられています。
</para>
<para>たとえば、ある章のファイルが</para>
<para>たとえば, ある章のファイルが</para>
<programlisting><![ CDATA [
<chapter id="kernelconfiguration">
...
</chapter>]]></programlisting>
<para>のようになっていたとすれば, それは
<filename>kernelconfiguration</filename> という
ディレクトリ中の <filename>chapter.sgml</filename>
というファイルです. 通常,
その章の内容はすべてこのファイルに書かれています. </para>
<para>のようになっていたとすれば、それは
<filename>kernelconfiguration</filename> という
ディレクトリ中の <filename>chapter.sgml</filename>
というファイルです。通常、
その章の内容はすべてこのファイルに書かれています。</para>
<para>HTML 版のハンドブックを構築する時, この章は
<filename>kernelconfiguration.html</filename>
というファイル名として生成されます. これは
<literal>id</literal> の値に関係するもので,
ディレクトリ名との関連はありません. </para>
<para>HTML 版のハンドブックを構築する時、この章は
<filename>kernelconfiguration.html</filename>
というファイル名として生成されます。これは
<literal>id</literal> の値に関係するもので、
ディレクトリ名との関連はありません。</para>
<para>ハンドブックの以前の版では, 文書のファイルは
<filename>book.sgml</filename> と同じディレクトリにおかれていて,
ファイル名は <sgmltag>chapter</sgmltag> エレメントの
<literal>id</literal> 属性の値になっていました.
これを個別のディレクトリに分けて移動させたのはハンドブックの
将来的な計画の準備のためです. 具体的には, こうすることで,
特に変更することなく各章に画像を追加することが可能になります.
また, それぞれの画像ファイルを章のテキストファイルと同じディレクトリに
おくことは, 大きな一つのディレクトリにすべてのテキストファイルと
画像ファイルをおいて管理しようとするより分かりやすくなります.
名前空間の衝突が発生したとしても,
格納ファイルの少ないディレクトリで作業する方が,
数多くのファイルがディレクトリにある場合よりも対処しやすくなるでしょう. </para>
<para>ハンドブックの以前の版では、文書のファイルは
<filename>book.sgml</filename> と同じディレクトリにおかれていて、
ファイル名は <sgmltag>chapter</sgmltag> エレメントの
<literal>id</literal> 属性の値になっていました。
これを個別のディレクトリに分けて移動させたのはハンドブックの
将来的な計画の準備のためです。具体的には、こうすることで、
特に変更することなく各章に画像を追加することが可能になります。
また、それぞれの画像ファイルを章のテキストファイルと同じディレクトリに
おくことは、大きな一つのディレクトリにすべてのテキストファイルと
画像ファイルをおいて管理しようとするより分かりやすくなります。
名前空間の衝突が発生したとしても、
格納ファイルの少ないディレクトリで作業する方が、
数多くのファイルがディレクトリにある場合よりも対処しやすくなるでしょう。</para>
<para>ここまでを簡単にまとめると,
個々に <filename>chapter.sgml</filename>
というファイルを含むディレクトリがたくさんあり, それらは
<para>ここまでを簡単にまとめると、
個々に <filename>chapter.sgml</filename>
というファイルを含むディレクトリがたくさんあり、それらは
<filename>basics/chapter.sgml</filename>,
<filename>introduction/chapter.sgml</filename>,
<filename>printing/chapter.sgml</filename>
などという名前になっているということです. </para>
などという名前になっているということです。</para>
<important>
<para>章とディレクトリは,
ハンドブックの並び順を反映した方法で名付けられるべきではありません.
順番はハンドブックの改訂の際に変更される可能性があります.
(章全体が階層構造の中で上下に移動するような場合でなければ)
こういった改訂が行なわれる場合にファイル名を変更する必要性が
(なるべく) 生じないようにするべきです.
</para>
<para>章とディレクトリは、
ハンドブックの並び順を反映した方法で名付けられるべきではありません。
順番はハンドブックの改訂の際に変更される可能性があります。
(章全体が階層構造の中で上下に移動するような場合でなければ)
こういった改訂が行なわれる場合にファイル名を変更する必要性が
(なるべく) 生じないようにするべきです。
</para>
</important>
<para>各々の <filename>chapter.sgml</filename> ファイルは,
完全な SGML 文書ではありません. 詳しく言えば,
それらのファイルの先頭には DOCTYPE 宣言の行が書かれていません.
</para>
<para>これには, 二つの欠点があります. </para>
<para>各々の <filename>chapter.sgml</filename> ファイルは、
完全な SGML 文書ではありません。詳しく言えば、
それらのファイルの先頭には DOCTYPE 宣言の行が書かれていません。
</para>
<para>これには、二つの欠点があります。</para>
<para>これらのファイルは一般的な SGML ファイルとして扱うことが
できないため, HTML, RTF, PS などの形式に変換するのに,
できないため、HTML, RTF, PS などの形式に変換するのに、
ハンドブック全体の生成に用いている方法と同じ方法を
単純に用いることができないという欠点があります.
そのため, ただ一つの章だけを変更し,
その結果を確認しようという場合には, 毎回ハンドブック全体を
<emphasis>構築し直さなければならない</emphasis>ことになります.</para>
単純に用いることができないという欠点があります。
そのため、ただ一つの章だけを変更し、
その結果を確認しようという場合には、毎回ハンドブック全体を
<emphasis>構築し直さなければならない</emphasis>ことになります。</para>
</sect4>
</sect3>
</sect2>

64
ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.sgml
View file

@ -37,36 +37,36 @@
<chapter id="stylesheets">
<title>* スタイルシート</title>
<para>SGML は, 文書が利用者にどのように表示されるかということや,
紙の上にどう配置されるかということについては何も定義していません.
それらを行なうためにスタイルシートを記述するさまざまな言語が開発されています.
その言語には, DynaText, Panorama, SPICE, JSSS, FOSI, CSS, DSSSL
などがあります.
<para>SGML は、文書が利用者にどのように表示されるかということや、
紙の上にどう配置されるかということについては何も定義していません。
それらを行なうためにスタイルシートを記述するさまざまな言語が開発されています。
その言語には、DynaText, Panorama, SPICE, JSSS, FOSI, CSS, DSSSL
などがあります。
</para>
<para>わたしたちは, DocBook 文書用として DSSSL で書かれたスタイルシートを,
HTML 文書用として CSS を利用しています. </para>
<para>わたしたちは、DocBook 文書用として DSSSL で書かれたスタイルシートを、
HTML 文書用として CSS を利用しています。</para>
<sect1 id="stylesheets-dsssl">
<title>* DSSSL</title>
<para>ドキュメンテーションプロジェクトでは,
<para>ドキュメンテーションプロジェクトでは、
Norm Walsh 氏による Modular DocBook Stylesheets
を少しカスタマイズしたものを使っています. </para>
<para>このスタイルシートは,
<filename role="package">textproc/dsssl-docbook-modular</filename>
から入手できます. </para>
を少しカスタマイズしたものを使っています。</para>
<para>変更が加えられたスタイルシートは, ports システムに含まれていません.
それらはドキュメンテーションプロジェクトのソースリポジトリの一部であり,
<filename>doc/share/sgml/freebsd.dsl</filename> におかれています.
変更が加えられたスタイルシートには詳細なコメントが付けられていますので,
この章が完成するまで, 標準のスタイルシートにあるオプションが
<para>このスタイルシートは、
<filename role="package">textproc/dsssl-docbook-modular</filename>
から入手できます。</para>
<para>変更が加えられたスタイルシートは、ports システムに含まれていません。
それらはドキュメンテーションプロジェクトのソースリポジトリの一部であり、
<filename>doc/share/sgml/freebsd.dsl</filename> におかれています。
変更が加えられたスタイルシートには詳細なコメントが付けられていますので、
この章が完成するまで、標準のスタイルシートにあるオプションが
どういった風に FreeBSD ドキュメンテーションプロジェクト用に
カスタマイズされているのか, このファイルを見て調べてみてください.
カスタマイズされているのか、このファイルを見て調べてみてください。
このファイルには FreeBSD 独自のエレメントを組版するために
スタイルシートを適用するエレメントを追加する方法の例も含まれています.
スタイルシートを適用するエレメントを追加する方法の例も含まれています。
</para>
</sect1>
@ -74,30 +74,30 @@
<title>CSS</title>
<para>Cascading Stylesheets (CSS) はスタイル情報
(フォント, ウェイト, 大きさ, 色などなど)
を HTML 文書の要素に付加する機構です.</para>
(フォント、ウェイト、大きさ、色などなど)
を HTML 文書の要素に付加する機構です。</para>
<sect2>
<title>ウェブサイト (HTML 文書)</title>
<para>FreeBSD のウェブサイトは現在 CSS を使用していません.
残念ながら, 見た目とその印象は HTML の各属性で直接調整されており,
人によってその度合は異なります.
この問題は解決すべきであり, ドキュメンテーションプロジェクトに
貢献するに値する良いプロジェクトになるでしょう.</para>
<para>FreeBSD のウェブサイトは現在 CSS を使用していません。
残念ながら、見た目とその印象は HTML の各属性で直接調整されており、
人によってその度合は異なります。
この問題は解決すべきであり、ドキュメンテーションプロジェクトに
貢献するに値する良いプロジェクトになるでしょう。</para>
</sect2>
<sect2>
<title>DocBook 文書</title>
<para>FreeBSD の DSSSL スタイルシートには, スタイルシート
<filename>docbook.css</filename> への参照が含まれています.
<para>FreeBSD の DSSSL スタイルシートには、スタイルシート
<filename>docbook.css</filename> への参照が含まれています。
このスタイルシートは HTML ファイルと同一のディレクトリに
存在することが想定されています.
プロジェクトにまたがる CSS ファイルは,
存在することが想定されています。
プロジェクトにまたがる CSS ファイルは、
文書が HTML に変換される時に
<filename>doc/share/misc/docbook.css</filename>
から複製され, 自動的にインストールされます.</para>
から複製され、自動的にインストールされます。</para>
</sect2>
</sect1>
</chapter>

232
ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml
View file

@ -37,51 +37,51 @@
<chapter id="tools">
<title>ツール</title>
<para>FDP では FreeBSD の文書を管理したり,
他の出力形式に整形したりするため, さまざまなソフトウェアツールを利用します.
FreeBSD の文書で作業するには, あなた自身がそれらのツールを使う必要があります.
<para>FDP では FreeBSD の文書を管理したり、
他の出力形式に整形したりするため、さまざまなソフトウェアツールを利用します。
FreeBSD の文書で作業するには、あなた自身がそれらのツールを使う必要があります。
</para>
<para>これらのツールはすべて FreeBSD の port や package として入手可能で,
インストール作業は非常に簡単です.
<para>これらのツールはすべて FreeBSD の port や package として入手可能で、
インストール作業は非常に簡単です。
</para>
<para>以下の章に書かれた例を試すには, あらかじめ
これらのツールがインストールされていなければなりません.
各ツールの実際の利用方法は, その例が書かれた章で説明されています.
<para>以下の章に書かれた例を試すには、あらかじめ
これらのツールがインストールされていなければなりません。
各ツールの実際の利用方法は、その例が書かれた章で説明されています。
</para>
<tip>
<title>できるだけ <filename role="package">textproc/docproj</filename> を利用してください</title>
<para><filename role="package">textproc/docproj</filename> の port
を使うとインストールする手間を大きく省くことができます. これは
<emphasis>メタ (meta) port</emphasis> と呼ばれる port で,
その中にソフトウェアが含むかわりに, 他のさまざまな port
が正しくインストールされるように依存関係がつくられているものです.
この port をインストールすると,
を使うとインストールする手間を大きく省くことができます。これは
<emphasis>メタ (meta) port</emphasis> と呼ばれる port で、
その中にソフトウェアが含むかわりに、他のさまざまな port
が正しくインストールされるように依存関係がつくられているものです。
この port をインストールすると、
この章であげられているソフトウェアが
自動的に<emphasis>すべてダウンロードされ, インストールされます</emphasis>.
自動的に<emphasis>すべてダウンロードされ、インストールされます</emphasis>。
</para>
<para>必要となるパッケージの一つに, JadeTeX マクロセットというものがあります.
このマクロセットは, インストール時に TeX
がインストールされていることを必要とします. TeX
は非常に大きなパッケージですが, Postscript や PDF
形式の出力を行なわないならばインストールの必要はありません.
<para>必要となるパッケージの一つに、JadeTeX マクロセットというものがあります。
このマクロセットは、インストール時に TeX
がインストールされていることを必要とします。TeX
は非常に大きなパッケージですが、Postscript や PDF
形式の出力を行なわないならばインストールの必要はありません。
</para>
<para>時間とディスクスペースの節約のため,
この port をインストールする際に, JadeTeX (すなわち TeX を含む)
を必要とするかどうかを指定する必要があります.
次のいずれかを, 場合に応じて実行して下さい.
<para>時間とディスクスペースの節約のため、
この port をインストールする際に、JadeTeX (すなわち TeX を含む)
を必要とするかどうかを指定する必要があります。
次のいずれかを、場合に応じて実行して下さい。
<screen>&prompt.root; <userinput>make JADETEX=yes install</userinput></screen>
<screen>&prompt.root; <userinput>make JADETEX=no install</userinput></screen>
<makevar>JADETEX=no</makevar> を指定してツールをインストールすると,
HTML や ACSII テキストだけを出力することができます.
PostScript や PDF を出力するには TeX が必要です.
<makevar>JADETEX=no</makevar> を指定してツールをインストールすると、
HTML や ACSII テキストだけを出力することができます。
PostScript や PDF を出力するには TeX が必要です。
</para>
</tip>
@ -91,66 +91,66 @@
<sect2>
<title>ソフトウェア</title>
<para>以下のプログラムは, FreeBSD
の文書で快適に作業するために必要なものであり, 文書を
HTML, プレインテキストや RTF 形式に変換することができます.
これらはすべて,
<para>以下のプログラムは、FreeBSD
の文書で快適に作業するために必要なものであり、文書を
HTML、プレインテキストや RTF 形式に変換することができます。
これらはすべて、
<filename role="package">textproc/docproj</filename>
に含まれています. </para>
に含まれています。</para>
<variablelist>
<varlistentry>
<term><application>SP</application>
(<filename role="package">textproc/sp</filename>)</term>
<listitem>
<para>正当性検査のための SGML パーサや
SGML 正規化ツールを含むアプリケーションのセットです.
</para>
SGML 正規化ツールを含むアプリケーションのセットです。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><application>Jade</application>
(<filename role="package">textproc/jade</filename>)</term>
<listitem>
<para>DSSSL の実装です. これはマークアップされた文書を HTML
や TeX といった他の形式に変換するために使われます. </para>
<para>DSSSL の実装です。これはマークアップされた文書を HTML
や TeX といった他の形式に変換するために使われます。</para>
</listitem>
</varlistentry>
<varlistentry>
<term><application>Tidy</application>
(<filename role="package">www/tidy</filename>)</term>
<listitem>
<para>HTML 整形ツールです.
これは自動生成された HTML 文書を整形し,
より利用しやすいものにするために使われます.
</para>
<para>HTML 整形ツールです。
これは自動生成された HTML 文書を整形し、
より利用しやすいものにするために使われます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><application>Links</application>
(<filename role="package">www/links</filename>)</term>
<listitem>
<para>HTML ファイルをプレインテキストに変換することのできる
テキストモードの WWW ブラウザです. </para>
テキストモードの WWW ブラウザです。</para>
</listitem>
</varlistentry>
<varlistentry>
<term><application>peps</application>
(<filename role="package">graphics/peps</filename>)</term>
<listitem>
<para>いくつかの文書には画像が含まれており, その中には
EPS 形式で格納されているファイルがあります.
<para>いくつかの文書には画像が含まれており、その中には
EPS 形式で格納されているファイルがあります。
ウェブブラウザが表示できるように
PNG 形式に変換するために使われます. </para>
PNG 形式に変換するために使われます。</para>
</listitem>
</varlistentry>
</variablelist>
@ -159,40 +159,40 @@
<sect2>
<title>文書型定義 (DTD) と実体宣言 (entity)</title>
<para>以下にあげるのは, FDP で使われている DTD と実体宣言集合 (entity set)です.
これらはいずれも, 文書を取り扱う前に必要となります.
<para>以下にあげるのは、FDP で使われている DTD と実体宣言集合 (entity set)です。
これらはいずれも、文書を取り扱う前に必要となります。
</para>
<variablelist>
<varlistentry>
<term>HTML DTD (<filename role="package">textproc/html</filename>)</term>
<listitem>
<para>HTML は, World Wide Web で採用されているマークアップ言語です.
これは FreeBSD ウェブサイト全体でも利用されます. </para>
<para>HTML は、World Wide Web で採用されているマークアップ言語です。
これは FreeBSD ウェブサイト全体でも利用されます。</para>
</listitem>
</varlistentry>
<varlistentry>
<term>DocBook DTD (<filename role="package">textproc/docbook</filename>)</term>
<listitem>
<para>DocBook は, 技術文書のマークアップのために設計された DTD です.
FreeBSD の文書はすべて DocBook で記述されています.
</para>
<para>DocBook は、技術文書のマークアップのために設計された DTD です。
FreeBSD の文書はすべて DocBook で記述されています。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ISO 8879 公開実体宣言
(<filename role="package">textproc/iso8879</filename>)</term>
<listitem>
<para>ISO 8879:1986 に規定された 19 種類の 文字実体集合です.
これはたくさんの DTD で利用されるもので, 数学記号や latin
文字集合の追加文字 (アクセント記号, 発音記号など),
ギリシャ文字などが含まれます.
</para>
<para>ISO 8879:1986 に規定された 19 種類の 文字実体集合です。
これはたくさんの DTD で利用されるもので、数学記号や latin
文字集合の追加文字 (アクセント記号、発音記号など)、
ギリシャ文字などが含まれます。
</para>
</listitem>
</varlistentry>
</variablelist>
@ -201,19 +201,19 @@
<sect2>
<title>スタイルシート</title>
<para>スタイルシートは, 文書を画面表示や印刷などに利用される形式に変換,
整形するために使われます.
<para>スタイルシートは、文書を画面表示や印刷などに利用される形式に変換、
整形するために使われます。
</para>
<variablelist>
<varlistentry>
<term>Modular DocBook Stylesheets
(<filename role="package">textproc/dsssl-docbook-modular</filename>)</term>
<listitem>
<para>Modular DocBook Stylesheets は,
DocBook DTD でマークアップされた文書を HTML や RTF
形式に変換するのに使われます. </para>
<para>Modular DocBook Stylesheets は、
DocBook DTD でマークアップされた文書を HTML や RTF
形式に変換するのに使われます。</para>
</listitem>
</varlistentry>
</variablelist>
@ -223,73 +223,73 @@
<sect1 id="tools-optional">
<title>必須でない (optional) ツール</title>
<para>もし必要性を感じないなら, 以下にあげるソフトウェアはインストールしなくともかまいません.
しかしインストールしていれば, 文書の取り扱いに便利だと感じるでしょうし,
これらを使うことで, より多様な出力形式で文書を出力することが可能となります.
<para>もし必要性を感じないなら、以下にあげるソフトウェアはインストールしなくともかまいません。
しかしインストールしていれば、文書の取り扱いに便利だと感じるでしょうし、
これらを使うことで、より多様な出力形式で文書を出力することが可能となります。
</para>
<sect2>
<title>ソフトウェア</title>
<variablelist>
<varlistentry>
<term><application>JadeTeX</application> および
<application>teTeX</application>
(<filename role="package">print/jadetex</filename> および
<filename role="package">print/teTeX</filename>)</term>
<listitem>
<para><application>Jade</application> と
<application>teTeX</application> は,
DocBook 文書を DVI, Postscript, PDF の各形式に変換するのに使われます.
また, このとき <application>JadeTeX</application> マクロも必要となります.
</para>
<application>teTeX</application> は、
DocBook 文書を DVI, Postscript, PDF の各形式に変換するのに使われます。
また、このとき <application>JadeTeX</application> マクロも必要となります。
</para>
<para>文書をそのような形式に変換しなくて良い
(たとえば HTML, プレインテキスト, RTF で十分であるような) 場合には,
<application>JadeTeX</application> および
<application>teTeX</application> をインストールする必要はありません.
これらのインストールには大きなディスクスペースと時間を必要とします.
<application>teTeX</application> は, 30MB を超える大きなものです.
</para>
(たとえば HTML, プレインテキスト、RTF で十分であるような) 場合には、
<application>JadeTeX</application> および
<application>teTeX</application> をインストールする必要はありません。
これらのインストールには大きなディスクスペースと時間を必要とします。
<application>teTeX</application> は、30MB を超える大きなものです。
</para>
<important>
<para><application>JadeTeX</application> と
<application>teTeX</application>
をインストールする場合には,
<application>JadeTeX</application> がインストールされた後,
<application>teTeX</application> の設定を行なわなければなりません.
必要な手順の詳細は,
<filename>print/jadetex/pkg-message</filename>
に説明されています. </para>
<application>teTeX</application>
をインストールする場合には、
<application>JadeTeX</application> がインストールされた後、
<application>teTeX</application> の設定を行なわなければなりません。
必要な手順の詳細は、
<filename>print/jadetex/pkg-message</filename>
に説明されています。</para>
</important>
</listitem>
</varlistentry>
<varlistentry>
<term><application>Emacs</application> もしくは
<application>xemacs</application>
<application>xemacs</application>
(<filename role="package">editors/emacs</filename> もしくは
<filename role="package">editors/xemacs</filename>)</term>
<listitem>
<para>このエディタは両方とも, SGML DTD
でマークアップされた文書を編集するための特別なモードを備えています.
このモードには,
必要なタイプ量や誤りを低減するためのコマンドがあります.
</para>
<para>どのようなテキストエディタでもマークアップされた文書を編集することは可能ですので,
これらを使う必要があるというわけではありません.
しかしおそらく, これらは便利なものだと感じると思います.
</para>
<listitem>
<para>このエディタは両方とも、SGML DTD
でマークアップされた文書を編集するための特別なモードを備えています。
このモードには、
必要なタイプ量や誤りを低減するためのコマンドがあります。
</para>
<para>どのようなテキストエディタでもマークアップされた文書を編集することは可能ですので、
これらを使う必要があるというわけではありません。
しかしおそらく、これらは便利なものだと感じると思います。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>もし, この他に SGML 文書を扱うために有用なソフトウェアをご存知でしたら,
&nik; までお知らせ下さい.
このリストに加えさせていただきます.
<para>もし、この他に SGML 文書を扱うために有用なソフトウェアをご存知でしたら、
&nik; までお知らせ下さい。
このリストに加えさせていただきます。
</para>
</sect2>
</sect1>

262
ja_JP.eucJP/books/fdp-primer/writing-style/chapter.sgml
View file

@ -31,110 +31,110 @@
The FreeBSD Japanese Documentation Project
Original revision: 1.9
$FreeBSD: doc/ja_JP.eucJP/books/fdp-primer/writing-style/chapter.sgml,v 1.1 2001/03/07 19:40:56 hrs Exp $
$FreeBSD$
-->
<chapter id="writing-style">
<title>文体について</title>
<para>FreeBSD の文書はたくさんの人々によって書かれています.
そのため, 文書の一貫性を保てるよう, 作者向けにガイドラインがつくられています.
<para>FreeBSD の文書はたくさんの人々によって書かれています。
そのため、文書の一貫性を保てるよう、作者向けにガイドラインがつくられています。
</para>
<variablelist>
<varlistentry>
<term>短縮形は使わない</term>
<listitem>
<para>短縮形は使わないでください.
スペルは常に完全な形で書き,
&ldquo;Don't use contractions&rdquo;
というような表現は使ってはいけません.
</para>
<para>短縮形を使わないことで文の調子が引き締まり, かたい感じになります.
また, 多少ですが翻訳者の負担を軽減できます.
</para>
<listitem>
<para>短縮形は使わないでください。
スペルは常に完全な形で書き、
&ldquo;Don't use contractions&rdquo;
というような表現は使ってはいけません。
</para>
<para>短縮形を使わないことで文の調子が引き締まり、かたい感じになります。
また、多少ですが翻訳者の負担を軽減できます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>並記の際にはカンマを使う</term>
<listitem>
<para>
段落のなかで項目を並べる場合には,
それぞれの項目をカンマを使って分けてください.
最後の項目では, カンマと &ldquo;and&rdquo; を使います.
</para>
段落のなかで項目を並べる場合には、
それぞれの項目をカンマを使って分けてください。
最後の項目では、カンマと &ldquo;and&rdquo; を使います。
</para>
<para>たとえば、次の例を見てください。</para>
<para>たとえば, 次の例を見てください. </para>
<blockquote>
<para>This is a list of one, two and three items.</para>
</blockquote>
<para>さて, これは三つの項目, &ldquo;one&rdquo;,
<para>さて、これは三つの項目、&ldquo;one&rdquo;,
&ldquo;two&rdquo; および &ldquo;three&rdquo;
を並べたものでしょうか?
それとも, 二つの項目, &ldquo;one&rdquo; と &ldquo;two and three&rdquo;
を並べたものなのでしょうか?
</para>
を並べたものでしょうか?
それとも、二つの項目、&ldquo;one&rdquo; と &ldquo;two and three&rdquo;
を並べたものなのでしょうか?
</para>
<para>これは、
並記の際にカンマを使うことではっきりさせることができます。</para>
<para>これは,
並記の際にカンマを使うことではっきりさせることができます. </para>
<blockquote>
<para>This is a list of one, two, and three items.</para>
</blockquote>
</listitem>
</varlistentry>
<varlistentry>
<term>冗長な表現を避ける</term>
<listitem>
<para>冗長な表現を使わないよう配慮してください. 具体的に言うと,
&ldquo;the command&rdquo;,
&ldquo;the file&rdquo;,
そして &ldquo;man command&rdquo;
というような表現は, いずれも余計なものです.
</para>
<para>ここに, コマンドに関する二つの例を示します.
好ましいのは二番目の例です. </para>
<listitem>
<para>冗長な表現を使わないよう配慮してください。具体的に言うと、
&ldquo;the command&rdquo;,
&ldquo;the file&rdquo;,
そして &ldquo;man command&rdquo;
というような表現は、いずれも余計なものです。
</para>
<para>ここに、コマンドに関する二つの例を示します。
好ましいのは二番目の例です。</para>
<informalexample>
<para>Use the command <command>cvsup</command> to update your
sources</para>
</informalexample>
<informalexample>
<para>Use <command>cvsup</command> to update your sources</para>
</informalexample>
<para>次に, ファイル名に関する二つの例を示します.
こちらも, 好ましいのは二番目の例です. </para>
<para>次に、ファイル名に関する二つの例を示します。
こちらも、好ましいのは二番目の例です。</para>
<informalexample>
<para>&hellip; in the filename
<filename>/etc/rc.local</filename>&hellip;</para>
</informalexample>
<informalexample>
<para>&hellip; in
<filename>/etc/rc.local</filename>&hellip;</para>
</informalexample>
<para>マニュアルページ参照に関する二つの例を示します.
こちらも, 好ましいのは二番目の例です (二番目の例では,
<sgmltag>citerefentry</sgmltag> が使われています). </para>
<para>マニュアルページ参照に関する二つの例を示します。
こちらも、好ましいのは二番目の例です (二番目の例では、
<sgmltag>citerefentry</sgmltag> が使われています)。</para>
<informalexample>
<para>See <command>man csh</command> for more
information.</para>
</informalexample>
<informalexample>
<para>See &man.csh.1;</para>
</informalexample>
@ -145,54 +145,54 @@
<term>文の最後には二個分の空白を入れる</term>
<listitem>
<para>文の最後には, 常に二個分の空白を入れてください.
これは読みやすさを向上させるためと,
<application>emacs</application>
のようなツールで扱いやすくするためです.
</para>
<para>文の最後には、常に二個分の空白を入れてください。
これは読みやすさを向上させるためと、
<application>emacs</application>
のようなツールで扱いやすくするためです。
</para>
<para>文の最後のピリオドに続く文字は大文字だから,
スペースの数が一つでも文の最後と分かるじゃないか,
と思われた方がいらっしゃるかも知れませんが,
これは特に, 名前にピリオドが使われるときには当てはまりません.
適当な例として, たとえば <quote>Jordan K. Hubbard</quote>
があげられます. この場合, ピリオドと一つのスペースの後ろに大文字の
<literal>H</literal> が来ていますが,
明らかに新しい文のはじまりではありません.
</para>
<para>文の最後のピリオドに続く文字は大文字だから、
スペースの数が一つでも文の最後と分かるじゃないか、
と思われた方がいらっしゃるかも知れませんが、
これは特に、名前にピリオドが使われるときには当てはまりません。
適当な例として、たとえば <quote>Jordan K. Hubbard</quote>
があげられます。この場合、ピリオドと一つのスペースの後ろに大文字の
<literal>H</literal> が来ていますが、
明らかに新しい文のはじまりではありません。
</para>
</listitem>
</varlistentry>
</variablelist>
<para>文体についての詳細は, William Strunk 氏による <ulink
<para>文体についての詳細は、William Strunk 氏による <ulink
url="http://www.bartleby.com/141/index.html">Elements of
Style</ulink> が参考になります. </para>
Style</ulink> が参考になります。</para>
<sect1>
<title>スタイルガイド</title>
<para>ハンドブックはたくさんの人々によって編集されます.
ソースファイルにおける一貫性を維持するため,
以下にあげるようなスタイルを守るようにお願いします.
<para>ハンドブックはたくさんの人々によって編集されます。
ソースファイルにおける一貫性を維持するため、
以下にあげるようなスタイルを守るようにお願いします。
</para>
<sect2>
<title>大文字と小文字</title>
<para>タグは小文字で入力します.
<literal>&lt;PARA&gt;</literal>
<emphasis>ではなく</emphasis>,
<literal>&lt;para&gt;</literal> です.
<para>タグは小文字で入力します。
<literal>&lt;PARA&gt;</literal>
<emphasis>ではなく</emphasis>、
<literal>&lt;para&gt;</literal> です。
</para>
<para>SGML コンテキスト(訳注: DTD などの部分)では通常,
大文字で書かれます.
たとえば <literal>&lt;!entity&hellip;&gt;</literal> や
<para>SGML コンテキスト(訳注: DTD などの部分)では通常、
大文字で書かれます。
たとえば <literal>&lt;!entity&hellip;&gt;</literal> や
<literal>&lt;!doctype&hellip;&gt;</literal>
<emphasis>ではなく</emphasis>,
<literal>&lt!ENTITY&hellip;&gt;</literal> や
<emphasis>ではなく</emphasis>、
<literal>&lt!ENTITY&hellip;&gt;</literal> や
<literal>&lt;!DOCTYPE&hellip;&gt;</literal>
というように書きます.
というように書きます。
</para>
</sect2>
@ -204,13 +204,13 @@
<emphasis>regardless</emphasis> of the indentation level of the file
which might contain this one.</para>
<para>開始タグでは必ず二個分の空白で字下げ幅を増やし,
同様に終了タグでは二個分の空白で字下げ幅を減らします.
エレメント中の内容が一行以上にわたる場合は,
さらに二個分の空白で字下げされていなければなりません.
<para>開始タグでは必ず二個分の空白で字下げ幅を増やし、
同様に終了タグでは二個分の空白で字下げ幅を減らします。
エレメント中の内容が一行以上にわたる場合は、
さらに二個分の空白で字下げされていなければなりません。
</para>
<para>たとえば, このセクションのソースはつぎのようになっています. </para>
<para>たとえば、このセクションのソースはつぎのようになっています。</para>
<programlisting>
<![ CDATA [+--- This is column 0
@ -233,16 +233,16 @@ V
within elements should be indented by two spaces if the content runs
over more than one line.</para>
...
...
</sect2>
</sect1>
</chapter>]]></programlisting>
<para>ファイルの編集に <application>Emacs</application> か
<application>Xemacs</application> を使っている場合には
<literal>sgml-mode</literal> が自動的にロードされますので,
各ファイルの最後に書かれた Emacs
のローカル変数によってこのスタイルが維持されます. </para>
<application>Xemacs</application> を使っている場合には
<literal>sgml-mode</literal> が自動的にロードされますので、
各ファイルの最後に書かれた Emacs
のローカル変数によってこのスタイルが維持されます。</para>
</sect2>
<sect2>
@ -252,10 +252,10 @@ V
<title>タグ間のスペース</title>
<para>
タグはその前にあるタグと同じ字下げ幅ではじめ,
タグとの間は一行空けてください.
ただしその前のタグが同じ字下げ幅でなければ行を空けてはいけません.
</para>
タグはその前にあるタグと同じ字下げ幅ではじめ、
タグとの間は一行空けてください。
ただしその前のタグが同じ字下げ幅でなければ行を空けてはいけません。
</para>
<informalexample>
<programlisting><![ CDATA [<article>
@ -266,8 +266,8 @@ V
<abstract>
<para>...
...
...</para>
...
...</para>
</abstract>
</artheader>
@ -290,55 +290,55 @@ V
<title>タグの分離</title>
<para>
<sgmltag>itemizedlist</sgmltag>
のようなタグは常に内部に別のタグが入り,
実際の文字データは入りません.
そのため, 常にタグだけで一行になります.
</para>
<sgmltag>itemizedlist</sgmltag>
のようなタグは常に内部に別のタグが入り、
実際の文字データは入りません。
そのため、常にタグだけで一行になります。
</para>
<para><sgmltag>para</sgmltag> と <sgmltag>term</sgmltag> は,
通常の文字データを他のタグを使わずにそのまま入れることができます.
そのため, 内容は開始タグの直後,
すなわち<emphasis>同じ行から</emphasis>はじまります.
</para>
<para><sgmltag>para</sgmltag> と <sgmltag>term</sgmltag> は、
通常の文字データを他のタグを使わずにそのまま入れることができます。
そのため、内容は開始タグの直後、
すなわち<emphasis>同じ行から</emphasis>はじまります。
</para>
<para>これは, 二種類のタグが閉じるときも同様です. </para>
<para>このルールは, この種のタグが混ぜて使われる際に問題となります. </para>
<para>これは、二種類のタグが閉じるときも同様です。</para>
<para>直接文字データを含むことができない開始タグに続くタグがこの種のタグ,
すなわち文字データを入れるために他のタグを使わなければならないものであった場合,
それらはそれぞれ独立した行になります.
二番目のタグは, 適切に字下げされていなければなりません.
</para>
<para>このルールは、この種のタグが混ぜて使われる際に問題となります。</para>
<para>直接文字データを含むことができない開始タグに続くタグがこの種のタグ、
すなわち文字データを入れるために他のタグを使わなければならないものであった場合、
それらはそれぞれ独立した行になります。
二番目のタグは、適切に字下げされていなければなりません。
</para>
<para>文字データを直接含むことのできるタグが
データを直接含むことのできないタグの直後に現われる場合は,
それらは同一の行に共存することになります.
</para>
データを直接含むことのできないタグの直後に現われる場合は、
それらは同一の行に共存することになります。
</para>
</sect3>
</sect2>
<sect2>
<title>空白の変更</title>
<para>変更を commit する際には,
<emphasis>内容の変更と体裁の変更を同時に
commit してはいけません</emphasis>.
<para>変更を commit する際には、
<emphasis>内容の変更と体裁の変更を同時に
commit してはいけません</emphasis>。
</para>
<para>これは, ハンドブックを他の言語に翻訳している翻訳チームがあなたの
commit で実際の内容が変更されたことをすぐに判別できるようにするためです.
commit が分けてあれば, その変更が内容的なものか,
それとも単に整形のためなのかを確認する必要がなくなります.
<para>これは、ハンドブックを他の言語に翻訳している翻訳チームがあなたの
commit で実際の内容が変更されたことをすぐに判別できるようにするためです。
commit が分けてあれば、その変更が内容的なものか、
それとも単に整形のためなのかを確認する必要がなくなります。
</para>
<para>たとえば, ある段落に二つの文を追加する場合を考えてみましょう.
文を追加したことにより, 段落の長さが 80 カラムを超えたとします.
そういう場合には, 最初の commit で整形せずに長いまま commit してください.
そして次に行の折り返しを行ない, 二回目としてその結果を commit します.
また, 二回目の commit ログには「これは空白の変更だけであり,
翻訳チームは無視しても大丈夫です」ということを示すようにしてください.
<para>たとえば、ある段落に二つの文を追加する場合を考えてみましょう。
文を追加したことにより、段落の長さが 80 カラムを超えたとします。
そういう場合には、最初の commit で整形せずに長いまま commit してください。
そして次に行の折り返しを行ない、二回目としてその結果を commit します。
また、二回目の commit ログには「これは空白の変更だけであり、
翻訳チームは無視しても大丈夫です」ということを示すようにしてください。
</para>
</sect2>
</sect1>