[% title = "ウェブページ翻訳作業マニュアル - 実際の翻訳作業" %]

<p><a name="ch-translation"></a></p>
<hr>

<p>
[ <a href="index.html">previous</a> ]
[ <a href="index.html#contents">Contents</a> ]
[ 1 ]
[ <a href="ch-preview.html">2</a> ]
[ <a href="ch-revise.html">3</a> ]
[ <a href="ch-elisp.html">4</a> ]
[ <a href="ch-link.html">5</a> ]
[ <a href="ch-preview.html">next</a> ]
</p>

<hr>

<h2>
ウェブページ翻訳作業マニュアル
<br>Chapter 1 - 実際の翻訳作業
</h2>

<hr>

<p>
<code><a href="http://www.debian.org/">www.debian.org</a></code>
上のウェブページは、 wml
でマークアップされたソースから生成されています。翻訳は英語オリジナルの wml
ファイルを取得して行います。 またその <code><a
href="http://cvs.debian.org/">ソース ツリー</a></code>はcvs
で管理されています。(詳細は <code><a
href="http://www.debian.org/devel/website/translating">Debian ウェブページの
翻訳</a></code> を参照してください。)
</p>

<hr>

<h3><a name="s1.1"></a>1.1 準備</h3>
<ol type="1" start="1" >
<li>
<p>
<code>cvs</code> パッケージをインストール
</p>
</li>
</ol>
<ol type="1" start="2" >
<li>
<p>
適当な作業ディレクトリを用意する
</p>

<pre>
     mkdir ~/debian-www/
</pre>
</li>
</ol>
<ol type="1" start="3" >
<li>
<p>
そのディレクトリにソースをダウンロード (checkout) する
</p>

<pre>
     cd ~/debian-www/
     cvs -d :pserver:anonymous&#64;anonscm.debian.org:/cvs/webwml login
     (パスワードを聞かれるが、単にリターンキーを押す)
     cvs -d :pserver:anonymous&#64;anonscm.debian.org:/cvs/webwml checkout webwml/english
     cvs -d :pserver:anonymous&#64;anonscm.debian.org:/cvs/webwml checkout webwml/japanese
</pre>
</li>
</ol>

<p>
<code>~/debian-www/webwml/english/</code> 以下にオリジナルの英語ソースが、
<code>~/debian-www/webwml/japanese/</code> 以下に現時点で翻訳済の日本語ソースが
ダウンロードされます。
</p>

<p>
ここまでの作業は次回から不要です。作業ディレクトリで <samp>cvs update</samp>
を実行するだけで、ソースが最新の状態になります。
</p>

<hr>

<h3><a name="s1.2"></a>1.2 翻訳作業の流れ</h3>
<ol type="1" start="1" >
<li>
<p>
<code><a href="http://kmuto.jp/debian/web-trans/index.rhtml">Debian.org Web
Japanese translation status</a></code>で翻訳作業の状況を確認
</p>

<p>
(武藤 健志&lt;kmuto&#64;debian.or.jp&gt;さんがメンテナンスされています。)
</p>
</li>
</ol>
<ol type="1" start="2" >
<li>
<p>
どのページを翻訳するか決めたら、Debian JP WWW ML に翻訳する旨を流す
</p>

<p>
必須ではありませんが、翻訳者がたくさんいて、作業がかち合う恐れのあると
きは宣言したほうが無難でしょう。
</p>
</li>
</ol>
<ol type="1" start="3" >
<li>
<p>
ソースを最新の状態にする
</p>

<pre>
     cd ~/debian-www/
     cvs update
</pre>
</li>
</ol>
<ol type="1" start="4" >
<li>
<p>
英語オリジナルソースを、日本語の同じディレクトリにコピー
</p>

<p>
例えば intro/cooperation.wml を翻訳するなら、
</p>

<pre>
     cd ~/debian-www/webwml/
     cp ./english/intro/cooperation.wml  ./japanese/intro/
</pre>

<p>
(~/debian-www/webwml/japanese/ 以下に対応するディレクトリがない場合は作る。)
</p>
</li>
</ol>
<ol type="1" start="5" >
<li>
<p>
バージョン管理情報として cvs リヴィジョン番号を埋め込む
</p>
</li>
</ol>
<ol type="1" start="6" >
<li>
<p>
翻訳する
</p>

<p>
タグに変更を加えないように、また表記等に注意して翻訳します。
</p>
</li>
</ol>
<ol type="1" start="7" >
<li>
<p>
プレビューする
</p>

<p>
翻訳した wml ソースから生成されるページが実際にはどのようなものになるのか、
ローカルマシンで<code><a
href="./preview-jp_minihowto.html">プレビュー</a></code>することもできます。
また、拡張子 <samp>.html</samp> をつければ、
ちゃんと処理のされたものではありませんが、
ブラウザでとりあえずのプレビューはできるでしょう。
</p>
</li>
</ol>
<ol type="1" start="8" >
<li>
<p>
Debian JP WWW ML に投稿
</p>

<p>
こちらに投稿された wml ソースは、
日本語翻訳グループのコーディネーターである前原 恵太
&lt;maehara&#64;debian.or.jp&gt; さんが、 本家の cvs リポジトリに commit
してくださります。
</p>

<p>
なお誤訳を直したり、更新して再度 ML に投稿する場合は、
何を更新したのか簡単に箇条書きしておきましょう。
</p>
</li>
</ol>

<hr>

<h4><a name="s1.2.1"></a>1.2.1 バージョン管理情報として cvs リヴィジョン番号を埋め込む</h4>

<p>
(Emacs をお使いの方には、翻訳作業支援マクロ debwww.el が便利です。)
</p>

<pre>
     mkdir ~/work/
     cd ~/work/
     cvs -d :pserver:anonymous&#64;master.debian.or.jp:/var/cvs login
     CVS password:
     (パスワードを聞かれるのでリターンを押します。)
     cvs -d :pserver:anonymous&#64;master.debian.or.jp:/var/cvs checkout doc/webtrans_howto/debwww.el
     cp doc/webtrans_howto/debwww.el ~/debian-www/
</pre>

<p>
まずオリジナル英語ページの cvs リヴィジョン番号を調べます。
</p>

<pre>
     cd ~/debian-www/
     cvs status webwml/english/intro/cooperation.wml
</pre>

<p>
以下のような出力が得られます。 (インターネットに接続されている必要があります。)
</p>

<pre>
     ===================================================================
     File: cooperation.wml   Status: Up-to-date

        Working revision:    1.3
        Repository revision: 1.3     /cvs/webwml/webwml/english/intro/cooperation.wml,v
        Sticky Tag:          (none)
        Sticky Date:         (none)
        Sticky Options:      (none)
</pre>

<p>
<samp>Working revision:</samp> で示されるものが、ローカルディレクトリにあ
る英語オリジナルファイルのリビジョンです。この例では、<samp>1.3</samp> で
す。もしその番号と <samp>Repository revision:</samp> で示されるものが異な
る場合は、サーバー上のファイルが更新されています。もう一度 <samp>cvs
update</samp> を行ってから、<samp>Working revision</samp> を確認して下さい。
</p>

<p>
翻訳する日本語ページにそのリヴィジョン番号をコメントとして埋め込む。
「<samp>#use wml::debian::translation-check translation=&quot;&lt;英語
オリジナルファイルのリビジョン番号&gt;&quot;</samp>」 を、 これから翻訳する
日本語ページにコメントとして埋め込みます。埋め込む場所はファイルの 先頭にある
#use 行の一番最後に追加します。
</p>

<pre>
     #use wml::debian::template title=&quot;Cooperation with the FSF&quot;
     #use wml::debian::translation-check translation=&quot;1.3&quot;
</pre>

<hr>

<p>
[ <a href="index.html">previous</a> ]
[ <a href="index.html#contents">Contents</a> ]
[ 1 ]
[ <a href="ch-preview.html">2</a> ]
[ <a href="ch-revise.html">3</a> ]
[ <a href="ch-elisp.html">4</a> ]
[ <a href="ch-link.html">5</a> ]
[ <a href="ch-preview.html">next</a> ]
</p>

<hr>

<p>
ウェブページ翻訳作業マニュアル
</p>

<address>
$Id: webtrans_howto.ja.sgml,v 1.5 2001/06/19 17:34:45 tsaito Exp $<br>
<br>
Debian JP Webmasters <code><a href="mailto:debian-www&#64;debian.or.jp">debian-www&#64;debian.or.jp</a></code><br>
<br>
</address>
<hr>