Catch up with the English version:

1.4 -> 1.6 books/fdp-primer/chapters.ent 1.8 -> 1.9 books/fdp-primer/overview/chapter.sgml 1.6 -> 1.7 books/fdp-primer/psgml-mode/chapter.sgml 1.2 -> 1.14 books/fdp-primer/structure/chapter.sgml 1.4 -> 1.10 books/fdp-primer/stylesheets/chapter.sgml 1.10 -> 1.25 books/fdp-primer/tools/chapter.sgml
svn path=/head/; revision=18503
2003-10-20 15:42:03 +00:00 · 2003-10-20 15:42:03 +00:00 · 96203e1cfe · 2020-12-08 03:00:23 +00:00
commit 96203e1cfe
parent 94d4398308
6 changed files with 112 additions and 87 deletions
--- a/ja_JP.eucJP/books/fdp-primer/chapters.ent
+++ b/ja_JP.eucJP/books/fdp-primer/chapters.ent
@ -2,7 +2,7 @@
     The FreeBSD Documentation Project
     The FreeBSD Japanese Documentation Project

-     Original revision: 1.4
+     Original revision: 1.6
     $FreeBSD$

     Creates entities for each chapter in the Documentation Project Primer.
@ -24,3 +24,6 @@
 <!ENTITY chap.writing-style	SYSTEM "writing-style/chapter.sgml">
 <!ENTITY chap.psgml-mode	SYSTEM "psgml-mode/chapter.sgml">
 <!ENTITY chap.see-also		SYSTEM "see-also/chapter.sgml">	
+<!ENTITY chap.doc-build		SYSTEM "doc-build/chapter.sgml">
+
+<!ENTITY app.examples		SYSTEM "examples/appendix.sgml">
--- a/ja_JP.eucJP/books/fdp-primer/overview/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/overview/chapter.sgml
@ -29,7 +29,7 @@

     The FreeBSD Japanese Documentation Project

-     Original revision: 1.18
+     Original revision: 1.19
     $FreeBSD$

 -->
--- a/ja_JP.eucJP/books/fdp-primer/psgml-mode/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/psgml-mode/chapter.sgml
@ -29,7 +29,7 @@

     The FreeBSD Japanese Documentation Project

-     Original revision: 1.6
+     Original revision: 1.7
     $FreeBSD$
 -->

@ -128,7 +128,7 @@
          最も近い閉じたエレメントのすべての属性のリストと, 現在の値を表示します.  
          TAB を使って属性間を移動することができ, <command>C-k</command> を
          押すことで, 既存の値を新しいものに置き換えることができます.  
-          また, <command>C-c</command> を押すことで, バッファを閉じて
+          また, <command>C-c C-c</command> を押すことで, バッファを閉じて
          元の文書に戻ることができます.  
        </para>
      </listitem>
--- a/ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml
@ -30,8 +30,8 @@

     The FreeBSD Japanese Documentation Project

-     Original revision: 1.2
-     $FreeBSD: doc/ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml,v 1.1 2001/03/07 19:40:54 hrs Exp $
+     Original revision: 1.14
+     $FreeBSD$
 -->

 <chapter id="structure">
@ -63,13 +63,17 @@
    文書ツリーの構造が特定の慣習や文化背景を強制するものであっては
    ならないという点は重要です.  </para>

-  <sect1>
+  <sect1 id="structure-top">
    <title>ソースツリーの最上位 <filename>doc/</filename></title>

    <para><filename>doc/</filename> の下には二種類のディレクトリがあり, 
      各ディレクトリはそれぞれ, 特別な名前と意味を持っています.  </para>

    <segmentedlist>
+      <segtitle>ディレクトリ</segtitle>
+
+      <segtitle>意味</segtitle>
+
      <seglistitem>
 	<seg><filename>share/</filename></seg>
 	
@ -95,7 +99,7 @@
    </segmentedlist>
  </sect1>

-  <sect1>
+  <sect1 id="structure-locale">
    <title>
      <filename><replaceable>lang</replaceable>.<replaceable>encoding</replaceable>/</filename>
      ディレクトリ群</title>
@ -105,6 +109,10 @@
      それぞれ異なるディレクトリ名で示される三種類に分類されます.  </para>

    <segmentedlist>
+      <segtitle>ディレクトリ</segtitle>
+
+      <segtitle>内容</segtitle>
+
      <seglistitem>
 	<seg><filename>articles</filename></seg>
 	
@ -142,7 +150,7 @@
    </para>
  </sect1>
  
-  <sect1>
+  <sect1 id="structure-document">
    <title>特定の文書に関する情報</title>

    <para>このセクションでは, FDP
@ -282,27 +290,14 @@
          </para>
      
 	  <para>これには, 二つの欠点があります.  </para>
-	  
-	  <itemizedlist>
-	    <listitem>
-	      <para>これらのファイルは一般的な SGML
-                ファイルとして扱うことができないため, 
-                HTML, RTF, PS などの形式に変換するのに, 
-                ハンドブック全体の生成に用いている方法と同じ方法を単純に用いることができません.  
-                そのため, ただ一つの章だけを変更し, その結果を確認しようという場合には, 
-                毎回ハンドブック全体を<emphasis>構築し直さなければならない</emphasis>ことになります.  
-              </para>
-	    </listitem>
-	    
-	    <listitem>
-	      <para>Emacs の <literal>sgml-mode</literal> を使う場合, 
-                文書が利用している DTD を認識できないために
-                <literal>sgml-mode</literal>
-                の便利な機能(エレメントの補完入力, 
-                自動チェック機能など)が利用できなくなります.  
-              </para>
-	    </listitem>
-	  </itemizedlist>
+
+	  <para>これらのファイルは一般的な SGML ファイルとして扱うことが
+	    できないため, HTML, RTF, PS などの形式に変換するのに,
+	    ハンドブック全体の生成に用いている方法と同じ方法を
+	    単純に用いることができないという欠点があります.
+	    そのため, ただ一つの章だけを変更し,
+	    その結果を確認しようという場合には, 毎回ハンドブック全体を
+	    <emphasis>構築し直さなければならない</emphasis>ことになります.</para>
 	</sect4>
      </sect3>
    </sect2>
--- a/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.sgml
@ -30,7 +30,7 @@

     The FreeBSD Japanese Documentation Project

-     Original revision: 1.4
+     Original revision: 1.10
     $FreeBSD$
 -->

@ -47,7 +47,7 @@
  <para>わたしたちは, DocBook 文書用として DSSSL で書かれたスタイルシートを, 
    HTML 文書用として CSS を利用しています. </para>

-  <sect1>
+  <sect1 id="stylesheets-dsssl">
    <title>* DSSSL</title>

    <para>ドキュメンテーションプロジェクトでは, 
@ -55,7 +55,7 @@
      を少しカスタマイズしたものを使っています. </para>
    
    <para>このスタイルシートは, 
-      <filename>textproc/dsssl-docbook-modular</filename>
+      <filename role="package">textproc/dsssl-docbook-modular</filename>
      から入手できます. </para>

    <para>変更が加えられたスタイルシートは, ports システムに含まれていません. 
@ -70,10 +70,35 @@
    </para>
  </sect1>

-  <sect1>
-    <title>* CSS</title>
+  <sect1 id="stylesheets-css">
+    <title>CSS</title>

-    <para></para>
+    <para>Cascading Stylesheets (CSS) はスタイル情報
+      (フォント, ウェイト, 大きさ, 色などなど)
+      を HTML 文書の要素に付加する機構です.</para>
+
+    <sect2>
+      <title>ウェブサイト (HTML 文書)</title>
+
+      <para>FreeBSD のウェブサイトは現在 CSS を使用していません.
+	残念ながら, 見た目とその印象は HTML の各属性で直接調整されており,
+	人によってその度合は異なります.
+	この問題は解決すべきであり, ドキュメンテーションプロジェクトに
+	貢献するに値する良いプロジェクトになるでしょう.</para>
+    </sect2>
+
+    <sect2>
+      <title>DocBook 文書</title>
+
+      <para>FreeBSD の DSSSL スタイルシートには, スタイルシート
+	<filename>docbook.css</filename> への参照が含まれています.
+	このスタイルシートは HTML ファイルと同一のディレクトリに
+	存在することが想定されています.
+	プロジェクトにまたがる CSS ファイルは,
+	文書が HTML に変換される時に
+	<filename>doc/share/misc/docbook.css</filename>
+	から複製され, 自動的にインストールされます.</para>
+    </sect2>
  </sect1>
 </chapter>

--- a/ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml
@ -30,8 +30,8 @@

     The FreeBSD Japanese Documentation Project

-     Original revision: 1.10
-     $FreeBSD: doc/ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml,v 1.1 2001/03/07 19:40:55 hrs Exp $
+     Original revision: 1.25
+     $FreeBSD$
 -->

 <chapter id="tools">
@ -51,12 +51,12 @@
    各ツールの実際の利用方法は, その例が書かれた章で説明されています.  
  </para>

-  <important>
-    <title>できるだけ <filename>textproc/docproj</filename> を利用してください</title>
+  <tip>
+    <title>できるだけ <filename role="package">textproc/docproj</filename> を利用してください</title>

-    <para><filename>textproc/docproj</filename> の port
+    <para><filename role="package">textproc/docproj</filename> の port
      を使うとインストールする手間を大きく省くことができます.  これは
-      <emphasis>メタ(meta) port</emphasis> と呼ばれる port で, 
+      <emphasis>メタ (meta) port</emphasis> と呼ばれる port で, 
      その中にソフトウェアが含むかわりに, 他のさまざまな port
      が正しくインストールされるように依存関係がつくられているものです.  
      この port をインストールすると, 
@ -72,31 +72,36 @@
    </para>

    <para>時間とディスクスペースの節約のため, 
-      この port をインストールする際に, JadeTeX(すなわち TeX を含む)
+      この 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 が必要です.
    </para>
-  </important>
+  </tip>

-  <sect1>
+  <sect1 id="tools-mandatory">
    <title>必須のツール</title>

    <sect2>
      <title>ソフトウェア</title>

      <para>以下のプログラムは, FreeBSD
-        の文書で快適に作業するために必要なものです.  これらはすべて, 
-	<filename>textproc/docproj</filename>
+        の文書で快適に作業するために必要なものであり, 文書を
+        HTML, プレインテキストや RTF 形式に変換することができます.
+        これらはすべて, 
+	<filename role="package">textproc/docproj</filename>
        に含まれています.  </para>
      
      <variablelist>
 	<varlistentry>
 	  <term><application>SP</application>
-	    (<filename>textproc/sp</filename>)</term>
+	    (<filename role="package">textproc/sp</filename>)</term>
 	  
 	  <listitem>
 	    <para>正当性検査のための SGML パーサや
@ -107,7 +112,7 @@
 	
 	<varlistentry>
 	  <term><application>Jade</application>
-	    (<filename>textproc/jade</filename>)</term>
+	    (<filename role="package">textproc/jade</filename>)</term>
 	  
 	  <listitem>
 	    <para>DSSSL の実装です.  これはマークアップされた文書を HTML
@ -117,7 +122,7 @@
 	
 	<varlistentry>
 	  <term><application>Tidy</application>
-	    (<filename>www/tidy</filename>)</term>
+	    (<filename role="package">www/tidy</filename>)</term>
 	  
 	  <listitem>
 	    <para>HTML 整形ツールです.  
@ -128,30 +133,39 @@
 	</varlistentry>
 	
 	<varlistentry>
-	  <term><application>W3M</application>
-	    (<filename>www/w3m</filename>)</term>
+	  <term><application>Links</application>
+	    (<filename role="package">www/links</filename>)</term>
 	  
 	  <listitem>
-	    <para>
-              テキストモードの WWW ブラウザです.  &man.w3m.1;
-              は, HTML
-              ファイルをプレインテキストに変換することができます.  
-            </para>
+	    <para>HTML ファイルをプレインテキストに変換することのできる
+	      テキストモードの WWW ブラウザです.  </para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term><application>peps</application>
+	    (<filename role="package">graphics/peps</filename>)</term>
+  
+	  <listitem>
+	    <para>いくつかの文書には画像が含まれており, その中には
+	      EPS 形式で格納されているファイルがあります.
+	      ウェブブラウザが表示できるように
+	      PNG 形式に変換するために使われます.  </para>
 	  </listitem>
 	</varlistentry>
      </variablelist>
    </sect2>

    <sect2>
-      <title>文書型定義(DTD)と実体宣言(entity)</title>
+      <title>文書型定義 (DTD) と実体宣言 (entity)</title>

-      <para>以下にあげるのは, FDP で使われている DTD と実体宣言集合(entity set)です.  
+      <para>以下にあげるのは, FDP で使われている DTD と実体宣言集合 (entity set)です.  
        これらはいずれも, 文書を取り扱う前に必要となります.  
      </para>
      
      <variablelist>
 	<varlistentry>
-	  <term>HTML DTD (<filename>textproc/html</filename>)</term>
+	  <term>HTML DTD (<filename role="package">textproc/html</filename>)</term>
 	  
 	  <listitem>
 	    <para>HTML は, World Wide Web で採用されているマークアップ言語です.  
@ -160,35 +174,23 @@
 	</varlistentry>
 	
 	<varlistentry>
-	  <term>LinuxDoc DTD (<filename>textproc/linuxdoc</filename>)</term>
+	  <term>DocBook DTD (<filename role="package">textproc/docbook</filename>)</term>
 	  
 	  <listitem>
-	    <para>FreeBSD の文書には, LinuxDoc でマークアップされたものがあります.  
-              FDP では, LinuxDoc から DocBook への移行を積極的にすすめています.  
-            </para>
-	  </listitem>
-	</varlistentry>
-	
-	<varlistentry>
-	  <term>DocBook DTD (<filename>textproc/docbook</filename>)</term>
-	  
-	  <listitem>
-	    <para>DocBook は, 技術文書のマークアップのために設計された DTD であり, 
-              FDP では LinuxDoc から DocBook への移行をすすめています.  
-              この原稿を執筆している時点で, FreeBSD ハンドブックが
-              DockBook によってマークアップされています.  
+	    <para>DocBook は, 技術文書のマークアップのために設計された DTD です.
+              FreeBSD の文書はすべて DocBook で記述されています.
            </para>
 	  </listitem>
 	</varlistentry>
 	
 	<varlistentry>
 	  <term>ISO 8879 公開実体宣言
-	    (<filename>textproc/iso8879</filename>)</term>
+	    (<filename role="package">textproc/iso8879</filename>)</term>
 	  
 	  <listitem>
 	    <para>ISO 8879:1986 に規定された 19 種類の 文字実体集合です.  
              これはたくさんの DTD で利用されるもので, 数学記号や latin
-              文字集合の追加文字(アクセント記号, 発音記号など), 
+              文字集合の追加文字 (アクセント記号, 発音記号など), 
              ギリシャ文字などが含まれます.  
            </para>
 	  </listitem>
@ -206,7 +208,7 @@
      <variablelist>
 	<varlistentry>
 	  <term>Modular DocBook Stylesheets
-	    (<filename>textproc/dsssl-docbook-modular</filename>)</term>
+	    (<filename role="package">textproc/dsssl-docbook-modular</filename>)</term>
 	  
 	  <listitem>
 	    <para>Modular DocBook Stylesheets は, 
@ -218,8 +220,8 @@
    </sect2>
  </sect1>

-  <sect1>
-    <title>必須でない(optional)ツール</title>
+  <sect1 id="tools-optional">
+    <title>必須でない (optional) ツール</title>

    <para>もし必要性を感じないなら, 以下にあげるソフトウェアはインストールしなくともかまいません.  
      しかしインストールしていれば, 文書の取り扱いに便利だと感じるでしょうし, 
@ -233,8 +235,8 @@
 	<varlistentry>
 	  <term><application>JadeTeX</application> および
 	    <application>teTeX</application>
-	    (<filename>print/jadetex</filename> および
-	    <filename>print/teTeX</filename>)</term>
+	    (<filename role="package">print/jadetex</filename> および
+	    <filename role="package">print/teTeX</filename>)</term>
 	  
 	  <listitem>
 	    <para><application>Jade</application> と
@ -244,7 +246,7 @@
            </para>

 	    <para>文書をそのような形式に変換しなくて良い
-              (たとえば HTML, プレインテキスト, RTF で十分であるような)場合には, 
+              (たとえば HTML, プレインテキスト, RTF で十分であるような) 場合には, 
              <application>JadeTeX</application> および
 	      <application>teTeX</application> をインストールする必要はありません.  
              これらのインストールには大きなディスクスペースと時間を必要とします.  
@ -258,7 +260,7 @@
                <application>JadeTeX</application> がインストールされた後, 
                <application>teTeX</application> の設定を行なわなければなりません.  
                必要な手順の詳細は, 
-                <filename>print/jadetex/pkg/MESSAGE</filename>
+                <filename>print/jadetex/pkg-message</filename>
                に説明されています.  </para>
 	    </important>
 	  </listitem>
@ -267,8 +269,8 @@
 	<varlistentry>
 	  <term><application>Emacs</application> もしくは
 	    <application>xemacs</application> 
-	    (<filename>editors/emacs</filename> もしくは
-	    <filename>editors/xemacs</filename>)</term>
+	    (<filename role="package">editors/emacs</filename> もしくは
+	    <filename role="package">editors/xemacs</filename>)</term>
 	  
 	  <listitem>
 	    <para>このエディタは両方とも, SGML DTD
@ -286,7 +288,7 @@
      </variablelist>

      <para>もし, この他に SGML 文書を扱うために有用なソフトウェアをご存知でしたら, 
-        Nik Clayton(<email>nik@FreeBSD.org</email>) までお知らせ下さい.  
+        &nik; までお知らせ下さい.  
        このリストに加えさせていただきます.  
      </para>
    </sect2>