翻訳者の作業をできるだけ簡単にするため、私たちのページは普段多くの人が 行なっているのとは少し違った方法でページを生成しています。ウェブページは 実際には wml でマークアップされたソースを使って生成されます。 各言語毎にわかれたディレクトリが存在します。
もし Debian ウェブサイトの新規言語翻訳を開始したい場合は、 新規言語の翻訳を始める の節をご覧ください。
訳注: 日本語への翻訳作業については、 Debian JP Project の www.debian.org 和訳作業のページを併せて参照してください。
複数のページに共通する内容を、個々の内容から分離するために、 WML が使われています。つまり、HTML ファイルを編集するのではなく、 WML ソースファイルを編集しなければならない、ということです。 CVS を利用 して現在のソースを入手してください。 少なくとも webwml/english/ と webwml/<language>/ の 2 つのディレクトリを check out する必要があります。
あるページを英語からあなたの言語へ翻訳するためには、 オリジナルの .wml ファイルを翻訳し、翻訳先言語のディレクトリに 置く必要があります。リンクが正しく働くために、 相対パスとファイル名は、英語版と同じでなければなりません。
翻訳対象となったオリジナルファイルの正確なリビジョンを記録し、
更新を容易にするための行を、ヘッダ部分の
最後の #use 行の直後に追加することを強くお勧めします。
その行は、以下のようなものです:
#use wml::debian::translation-check translation="x.y"
また、いくつかの翻訳チームは、各ウェブページの公式な翻訳者を記録するのに
この行を使っています。そうしていると、保守しているページの英語版が更新された
時に自動的にメールを受け取れるようになり、翻訳を更新する必要があることに
気づくことができます。そのためには、#use 行の末尾に
メンテナとしてあなたの名前を単純に付け加えます。以下のようになります:
#use wml::debian::translation-check translation="x.y" maintainer="あなたの名前"
さらに、あなたが誰なのか、どのぐらいの頻度で自動的に メールや変更内容を受け取りたいのかをロボットに説明する必要があります。 そのためには、CVS にある webwml/language/international/language/translator.db.pl ファイルを編集 (もしくはコーディネータに編集を依頼) します。 文法はとても分かりやすいです。もしあなたの言語用のものがまだない場合は、 フランス語チームのファイルをテンプレートとして使ってください。 ロボットは何種類かの情報をそれぞれ送信することができます。あなたは ロボットが情報を送信する間隔を選択できます。その種類とは:
それぞれの値は、0 (不要)、1 (毎月)、2 (毎週)、3 (毎日) のうちの 一つとなります。
例えば:
'Martin Quinson' => {
email => 'martin.quinson@tuxfamily.org',
summary => 3,
logs => 3,
diff => 3,
tdiff => 0,
file => 0
},
webwml のルートディレクトリにある copypage.pl スクリプトを使うと、ウェブページのヘッダは簡単に作成できます。 このスクリプトは、ページを正しい位置にコピーしてくれます。 必要ならディレクトリや makefile も作成してくれます。そして、 必要なヘッダを自動的に追加してくれます。
./copypage.pl file.wml を実行した後で、そのファイルの中の文章を翻訳してください。 もしファイル中に翻訳してはならない部分がある場合には、 コメントによって示されています。その場合は、そのコメントに 従ってください。フォーマットに不要な変更を加えないでください。 もし修正が必要な場合、その修正はオリジナル版にも必要でしょうから。
私たちは 内容交渉を使っているので、 HTML ファイルのファイル名は file.html ではなく file.<lang>.html となります。ここで <lang> は、 ISO 639 に基づく 2 文字の言語コードです (例えば日本語は「ja」です)。
ウェブページは www-master において CVS をもとに作成されます。 この処理はたいていの場合、エラーが出ても停止しませんが、 もし壊れたファイルを翻訳のトップレベル (例えばトップレベルの index.wml) にアップロード (cvs commit) した場合、 作成処理が壊れてしまい、他のすべてのウェブページの更新が止まってしまいます。 これらのファイルには、特に注意してください。
Debian ウェブページを新規言語に翻訳したい方は、 webmaster@debian.org までメールを (英語で) ください。
まず第一に、CVS 紹介ページに記述してあるように ソースツリーのチェックアウトが適切にできたことを確認してください。
webwml/ ディレクトリと (少なくとも) webwml/english/ をチェックアウトした後、english/ やその他の隣にあなたの言語用の新規 ディレクトリを作成するところから始めます。翻訳ディレクトリの名称は、 英語で、すべて小文字でなければなりません (例えば、 「Deutsch」ではなく「german」です)。
Make.lang と .wmlrc のファイルを english/ ディレクトリから新しく作った翻訳ディレクトリにコピーします。 これらのファイルは、あなたの翻訳を WML ファイルから構築するために必須の ファイルです。これらのファイルをコピーした後、以下に示した項目 だけを変更すればいいようになっています。
このあと、そのディレクトリに新しく「Makefile」という名前のファイルを 作成し、以下に示す行を置いてください:
include $(subst webwml/yourlanguagedir,webwml/english,$(CURDIR))/Makefile
(もちろん、yourlanguagedir は、あなたの言語のディレクトリ名で 置き換えてください)。
次に、あなたの言語のディレクトリの下に、「po」という名前の サブディレクトリを作成し、同じ Makefile をそのサブディレクトリに コピーしてください (cp ../Makefile .)。
po/ ディレクトリの中で、make init-po を実行し、 初期状態の *.po ファイル群を作成してください。
これで骨格部分ができあがったので、 テンプレートに使われている共通の WML タグの翻訳作業が開始できます。 ヘッダのキーワード、ナビゲーションバーの項目、フッタなど、 すべてのウェブページに使われる語句から翻訳を始めるのが良いでしょう。
po/templates.xy.po
ファイルの翻訳を始めます
(ここで、xy は 2 文字の言語コードです)。
初期状態では、すべての msgid "something"
に対し、msgstr "" が存在します。something
を翻訳したものを、msgstr のあとの引用符の中に書いてください。
すべての .po ファイル中のすべての文字列を翻訳する必要はありません。
翻訳されたページが必要とする部分だけで構いません。ある文字列の翻訳が
必要かどうかを調べるには、各 msgid の直前に書かれてある
コメントを見てください。もし english/template/debian
ディレクトリ中のファイルが参照されていたら、それは翻訳したほうがいいです。
そうでなければ、それに関連し、その部分を必要とするウェブページを
翻訳するまで、その部分の翻訳を延期しても構いません。
もし正しく作業できたかどうか自信がないときは、commit する前に、debian-www メーリングリストで相談してください。
注意: もしそれ以外の部分で変更が必要であれば、 問題が解決するために、 どんな変更をなぜ加えるのかを debian-www で説明してください。
テンプレートの骨格ができあがったら、フロントページやその他の *.wml ファイルを翻訳してください。最初に翻訳すべきファイルの一覧が、 翻訳に役立つ情報のページにあります。 *.wml ページの翻訳のやりかたについては、このページの最初を見てください。
おそらく上記の説明だけで、翻訳を始めるのに十分でしょうが、あとで更に 詳しい説明や役立つ情報を補足してくれる以下のドキュメントを参照したほうが いいでしょう。
ウェブページの翻訳作業をできるだけ簡単にしていくよう、これまでの 私たちの作業をわかっていただければ幸いです。すでに述べたように、 もしなにか質問があれば debian-www メーリングリストで 聞いてください。