<!-- Copyright (c) 1999 Nik Clayton, All rights reserved.

     Redistribution and use in source (SGML DocBook) and 'compiled' forms
     (SGML HTML, PDF, PostScript, RTF and so forth) with or without
     modification, are permitted provided that the following conditions
     are met:

      1. Redistributions of source code (SGML DocBook) must retain the above
         copyright notice, this list of conditions and the following
         disclaimer as the first lines of this file unmodified.

      2. Redistributions in compiled form (transformed to other DTDs,
         converted to PDF, PostScript, RTF and other formats) must reproduce
         the above copyright notice, this list of conditions and the
         following disclaimer in the documentation and/or other materials
         provided with the distribution.

     THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
     IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
     OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
     DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
     INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
     (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
     SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
     ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
     POSSIBILITY OF SUCH DAMAGE.

     The FreeBSD Japanese Documentation Project

     Original Revision: 1.25
     $FreeBSD$
-->

<chapter id="translations">
  <title>翻訳</title>

  <para>これは FreeBSD ドキュメンテーション
   (FAQ, ハンドブック、チュートリアル、マニュアルページ、その他)
   を他の言語へ翻訳している人たちのための FAQ です。</para>

  <para>Frank Gr&uuml;nder <email>elwood@mc5sys.in-berlin.de</email>
    が執筆し、Bernd Warken <email>bwarken@mayn.de</email>
    が英語へ翻訳し直した、FreeBSD ドイツ語ドキュメンテーションプロジェクトの
    翻訳 FAQ の<emphasis>大部分</emphasis>が原案として用いられました。</para>

  <para>この FAQ は &a.doceng; によって保守されています。</para>

  <qandaset>
    <qandaentry>
      <question>
	<para>どうして FAQ?</para>
      </question>

      <answer>
	<para>ますます多くの人たちが freebsd-doc メーリングリストへ集まり、
	  FreeBSD ドキュメンテーションを他の言語へ翻訳する
	  ボランティアをしています。
	  この FAQ は、できるだけ早く文書の翻訳を始められるように、
	  こうした人たちの疑問に答えることを目的としたものです。
	  </para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para><phrase>i18n</phrase> や <phrase>l10n</phrase>
	  の意味は何ですか?</para>
      </question>

      <answer>
	<para><phrase>i18n</phrase> は
	  <phrase>internationalisation</phrase> (訳注: 国際化) を意味し、
	  <phrase>l10n</phrase> は <phrase>localisation</phrase>
	  (訳注: 地域化) を意味します。これらは便利な略記法です。</para>

	<para><phrase>i18n</phrase> は
	  <quote>i</quote> に 18 文字が続いて
	  <quote>n</quote> が続くと読むことができます。
	  同様に、<phrase>l10n</phrase> は <quote>l</quote> に 10 文字続いて
	  <quote>n</quote> が続いています。</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>翻訳者用のメーリングリストはありますか?</para>
      </question>

      <answer>
	<para>はい。それぞれの翻訳グループが自分達のメーリングリストを持っています。
	  <ulink url="http://www.FreeBSD.org/ja/docproj/translations.html">翻訳プロジェクトのリスト</ulink> に
	  それぞれの翻訳プロジェクトによって運営されている
	  メーリングリストとウェブサイトについての情報があります。</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>もっと翻訳者は必要ですか?</para>
      </question>

      <answer>
	<para>はい。多くの人たちが翻訳作業をするほど速く完了しますし、
	  より速く、英語版ドキュメントへの変更が
	  翻訳されたドキュメントへ反映されます。</para>

	<para>協力するためにはプロの翻訳家である必要はありません。</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>どの言語を知っていなければなりませんか?</para>
      </question>

      <answer>
	<para>理想的には、文語英語の十分な知識を持っており、そしてもちろん
	  翻訳しようとしている言語に堪能である必要があるでしょう。</para>

	<para>英語は厳密に言えば必要ではありません。
	  たとえば、スペイン語の FAQ をハンガリー語に翻訳することだってできるでしょう。</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>どんなソフトウェアを知っていなければなりませんか?</para>
      </question>

      <answer>
	<para><application>CTM</application> か
	  <application>CVSup</application> を利用して、
	  FreeBSD CVS リポジトリのローカルコピー
	  (少なくともドキュメンテーション部分)
	  を保持することを強く奨めます。
	  ハンドブックの「最新の FreeBSD を追いかける」の章で
	  これらのアプリケーションの使い方を説明しています。</para>

	<para><application>CVS</application> の使い方には慣れておくべきです。
	  それによって、ドキュメントを構成するファイルが
	  異なるバージョン間でどのように変更されたかを知ることができます。</para>

	<para>[XXX To Do -- CVSup を使ってドキュメントを取得する方法、および
	  任意の二つのリビジョン間で何が変更されたかを知る方法を示す
	  チュートリアルを書く。] </para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>同じ言語へ翻訳しているかもしれない他の人を
	  どうやって探したらいいでしょうか?</para>
      </question>

      <answer>
	<para><ulink url="http://www.FreeBSD.org/ja/docproj/translations.html">
	  ドキュメンテーションプロジェクト翻訳ページ</ulink>では
	  現在知られている翻訳作業の一覧があります。
	  他の人たちが既にあなたの言語へドキュメンテーションを翻訳
	  しているならば、どうか同じ作業を繰り返さないでください。
	  代りにどう協力できるかを知るために、
	  彼らへ連絡を取ってください。</para>

	<para>このページに誰もあなたの言語への翻訳について載っていなければ、
	  &a.doc; へメッセージを送って、他の誰かが翻訳しようと思ったときに、
	  まだ告知されていなかったということがないようにしてください。</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>誰も私の言語へ翻訳していません。どうすれば良いでしょう?</para>
      </question>

      <answer>
	<para>おめでとう、あなたは <quote>FreeBSD
	  <replaceable>(あなたの言語をここに)</replaceable>語
	 ドキュメンテーションプロジェクト</quote> を立ち上げました。ようこそ。</para>

	<para>はじめに、割ける時間がどのくらいあるかを判断してください。
	  その言語への作業をしているのは今のところあなた一人だけです。
	  成果を公表したり、協力してくれるかもしれないボランティアと
	  調整するのはあなたの責任となります。</para>

	<para>ドキュメントの翻訳をするつもりであることを告知する電子メールを
	  ドキュメンテーションプロジェクトメーリングリストへ書いて、
	  ドキュメンテーションプロジェクトの翻訳ページが
	  保守されるようにしてください。</para>

	<para>国内に FreeBSD ミラーサービスを既に提供している人がいれば、
	  連絡を取ってプロジェクトのためにウェブスペースや、
	  電子メールアドレスあるいはメーリングリストサービスを
	  もらえないか尋ねてみると良いでしょう。</para>

	<para>それから一つドキュメントを選んで翻訳を始めます。
	  かなり小さ目の何か &mdash; FAQ かチュートリアルの一つから
	  始めるのが良いでしょう。</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>ドキュメントを翻訳しました。どこへ送れば良いですか?</para>
      </question>

      <answer>
	<para>場合によって違います。既に翻訳チーム
	  (日本語チームやドイツ語チームのような) で作業しているならば、
	  提出されたドキュメントの独自の取り扱い手続があって、
	  それらはウェブページで説明されているでしょう。</para>

	<para>もし、ある言語で作業しているたったひとりの人
	  (あるいは、ある翻訳プロジェクトの責任者で、
	  変更点を FreeBSD プロジェクトへ還元したい) ならば、
	  FreeBSD プロジェクトへ翻訳を送ってください
	  (次の質問を参照)。</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>この言語への翻訳作業をしているのは私だけです。
	  どのように翻訳を提出したら良いでしょうか?</para>

	<para>または</para>

	<para>私たちは翻訳チームで、メンバーが翻訳した
	  ドキュメンテーションを提出したいのですが? </para>
      </question>

      <answer>
	<para>はじめに、あなたの翻訳が適切に編成されているかを確めてください。
	  これは既存のドキュメンテーションツリーの中に収まり、
	  きちんとビルドできるということです。</para>

	<para>現在、FreeBSD ドキュメンテーションは <filename>doc/</filename>
	  というトップレベルディレクトリに納められています。
	  この下のディレクトリは記述されている言語コードに従って名付けられており、
	  ISO6639 で定義されています
	  (1999 年 1 月 20 日より新しい FreeBSD のパージョンでは
	  <filename>/usr/share/misc/iso6639</filename> をご覧ください)。</para>

	<para>あなたの言語がいくつかの方法でエンコード可能ならば (たとえば、中国語)、
	  あなたが準備したエンコード形式毎に、
	  この下にディレクトリがあるべきです。</para>

	<para>最後に、各ドキュメント毎にディレクトリがあります。</para>

	<para>たとえば、架空のスウェーデン語訳はこうなります。</para>

	<programlisting>doc/
    sv_SE.ISO8859-1/
                     Makefile
                     books/
                           faq/
                               Makefile
                               book.sgml</programlisting>

	<para><literal>sv_SE.ISO8859-1</literal> は翻訳の名前で、
	  <filename><replaceable>lang</replaceable>.<replaceable>encoding</replaceable></filename>
	  という形式です。二つの Makefile に注目してください。
	  これらがドキュメントを構築するのに用いられます。</para>

	<para>&man.tar.1; と &man.gzip.1; を使用して
	  ドキュメンテーションを圧縮し、プロジェクトへ送ってください。</para>

	<screen>&prompt.user; <userinput>cd doc</userinput>
&prompt.user; <userinput>tar cf swedish-docs.tar sv</userinput>
&prompt.user; <userinput>gzip -9 swedish-docs.tar</userinput></screen>

	<para><filename>swedish-docs.tar.gz</filename> をどこかへ置きます。
	  自分用のウェブスペースのへアクセスがなければ
	  (おそらく契約している ISP がスペースを提供していないのでしょう)
	  &a.doceng; へ e-mailしても良いですし、
	  都合が良ければファイルを電子メールで送ってもかまいません。</para>

	<para>どちらにしろ、ドキュメンテーションを提出したことの報告を出すのに
	  &man.send-pr.1; を使用します。
	  コミットする人がその言語に堪能ということはありそうにないので、
	  他の人たちにあなたの翻訳を査読してもらい、
	  先にダブルチェックしてもらえれば、とても助かります。</para>

	<para>誰か (おそらくドキュメンテーションプロジェクトマネージャ、
	  現在は &a.doceng;) があなたの翻訳を取り上げて、
	  構築できることを確めます。
	  特に、次の点が注目されるでしょう:</para>

	<orderedlist>
	  <listitem>
	    <para>すべてのファイルが RCS 文字列 ("ID" のような) を使っているか?</para>
	  </listitem>

	  <listitem>
	    <para><filename>sv_se.iso8859-1</filename> ディレクトリでの
	      <command>make all</command >はきちんとできるか?</para>
	  </listitem>

	  <listitem>
	    <para><command>make install</command> はきちんとできるか?</para>
	  </listitem>
	</orderedlist>

	<para>何か問題があれば、提出物を検査した人が誰であれ、
	  あなたへ対処するように戻します。</para>

	<para>翻訳物に問題がなければ、なるべく早くコミットされます。</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>翻訳文の中に言語や国に特有の文章を含めてよいですか? </para>
      </question>

      <answer>
	<para>そうしないでもらえると嬉しいです。</para>

	<para>たとえば、ハンドブックを朝鮮語へ翻訳しているとして、
	  ハンドブックに朝鮮の小売業者に関する節を
	  含めたいとします。</para>

	<para>その情報が英語 (あるいはドイツ語、スペイン語、日本語、&hellip;)
	  版で同じように載っているべきではない現実的な理由はないでしょう。
	  英語を話す人が朝鮮にいる間に
	  FreeBSD のコピーを手にいれようとするときに便利です。
	  また世界中で FreeBSD の認知度を増すのにも役立ちます。
	  このことは悪いことではないでしょう。</para>

	<para>国に特有の情報があれば、英語版ハンドブックへの変更として
	   (&man.send-pr.1;を使って) 提出し、
	   それから翻訳ハンドブックの中での変更点を
	   あなたの言語へ訳し戻してください。</para>

	<para>ありがとうございます。</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>言語に特有な文字を含めるのはどうですか?</para>
      </question>

      <answer>
	<para>ドキュメント中の非 ASCII 文字は
	  SGML のエンティティ (実体) を使用して含めるべきです。</para>

	<para>手短に言えば、これらはアンパサンド (&amp;) で始まり、
	  エンティティの名前、そしてセミコロン (;) で終ります。</para>

	<para>実体名は ISO8879 で定義されており、
	  それは portsツリーの
	  <filename role="package">textproc/iso8879</filename>
	  を利用してインストールすることができます。</para>

	<para>二、三の例を載せます。</para>

	<segmentedlist>
	  <segtitle>エンティティ</segtitle>

	  <segtitle>表現</segtitle>

	  <segtitle>説明</segtitle>

	  <seglistitem>
	    <seg>&amp;eacute;</seg>
	    <seg>&eacute;</seg>
	    <seg>鋭アクセント付きの小文字の <quote>e</quote></seg>
	  </seglistitem>

	  <seglistitem>
	    <seg>&amp;Eacute;</seg>
	    <seg>&Eacute;</seg>
	    <seg>鋭アクセント付きの大文字の <quote>E</quote></seg>
	  </seglistitem>

	  <seglistitem>
	    <seg>&amp;uuml;</seg>
	    <seg>&uuml;</seg>
	    <seg>ウムラウト付きの小文字の <quote>u</quote></seg>
	  </seglistitem>
	</segmentedlist>

	<para>iso8879 port をインストールすると、
	  <filename>/usr/local/share/sgml/iso8879</filename> ディレクトリに
	  完全なリストが設置されます。 </para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>読者への話しかけ</para>
      </question>

      <answer>
	<para>英語のドキュメントでは、読者は <quote>you</quote> と呼び掛けられ、
	  いくつかの言語にあるよう儀礼的/くだけたの区別はありません。</para>

	<para>区別をする言語への翻訳をしているならば、その言語での
	  他の技術文書でよく用いられている形式を使用してください。
	  迷ったら、穏やかで礼儀正しい形式を使ってください。</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>翻訳の中に何か追加情報を含めなければなりませんか?</para>
      </question>

      <answer>
	<para>はい。</para>

	<para>各ドキュメントの英語版のヘッダーはこのようになっています。</para>

	<programlisting>&lt;!--
     The FreeBSD Documentation Project

     &dollar;FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml,v 1.5 2000/07/07 18:38:38 dannyboy Exp &dollar;
--&gt;</programlisting>

	<para>決り文句の細部は違うかもしれませんが、
	  &dollar;FreeBSD&dollar; 行と
	  <literal>The FreeBSD Documentation Project</literal>
	  という句が常に含まれています。
	  &dollar;FreeBSD の部分は CVS によって自動的に展開されるので、
	  新しいファイルでは空 (<literal>&dollar;FreeBSD&dollar;</literal> だけ)
	  にします。</para>

	<para>翻訳した文書には自らの&dollar;FreeBSD&dollar; 行を含め、
	  <literal>FreeBSD Documentation Project</literal> 行を
	  <literal>The FreeBSD <replaceable>language</replaceable>
	   Documentation Project</literal>
	  へ変更します。</para>

	<para>さらに、この文章がどの英語のリビジョンに基づいているのかを示す
	  第三の行を追加します。</para>

	<para>ですから、このファイルのスペイン語版ならばこう始まるでしょう。</para>

	<programlisting>&lt;!--
     The FreeBSD Spanish Documentation Project

     &dollar;FreeBSD: doc/es_ES.ISO8859-1/books/fdp-primer/translations/chapter.sgml,v 1.3 1999/06/24 19:12:32 jesusr Exp &dollar;
     Original revision: 1.11
--&gt;</programlisting>
      </answer>
    </qandaentry>
  </qandaset>
</chapter>

<!--
     Local Variables:
     mode: sgml
     sgml-declaration: "../chapter.decl"
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-always-quote-attributes: t
     sgml-parent-document: ("../book.sgml" "part" "chapter")
     End:
-->
