Updated webwml/japanese/devel/website/using_wml.wml

[Tsutomu Saito <tsaito@debian.or.jp>]

齋藤です。

webwml/japanese/devel/website/using_wml.wml を更新しましたので
commit お願いします。

問題あれば指摘してください。
-- 
 Tsutomu Saito <tsaito@debian.or.jp>

#use wml::debian::template title="wml の利用方法"
#use wml::debian::translation-check translation="1.2"

ここでは、すでに wml が端末にインストールされてるものと仮定します。
wml は Debian のパッケージとして提供されています。

<p>webwml/&lt;lang&gt; ディレクトリで、単純に <kbd>make</kbd> と打つ
だけです。<kbd>make install</kbd> を実行すれば、html ファイルが
<kbd>../../debian.org/</kbd> ディレクトリに置かれます。

<p>マルチバイト言語では文字セットを正しく扱うために、wml ファイルに対
する特別に前処理もしくは後処理が必要になるかもしれません。これは
<kbd>webwml/&lt;lang&gt;/Make.lang</kbd> 中の該当箇所
<kbd>WMLPROLOG</kbd> 変数および <kbd>WMLEPILOG</kbd> 変数を
変更することによって行なえます。<kbd>WMLEPILOG</kbd> のプログラムの
動作によっては、<kbd>WMLOUTFILE</kbd> の値を変更する必要があるかもしれ
ません。例として日本語や中国語用のファイルを見てください。

<p>wml で遭遇することの 1 つにスライスがあります。ここで言いたいのは、
いくつかの選択肢の中の 1 つとして検討できる候補である、ということです。
簡単な例で意図していることをお見せします。
<pre><protect>
   [EN:the salad:]
   [DE:der Salat:]
</protect></pre>
このケースではスライスが 2 つあり、1 つが英語で、もう 1つがドイツ語です。
スライスを追加するためには、単にあなたの言語で新しいスライスを追加する
だけです。例えば下記のようにします。
<pre><protect>
   [EN:the salad:]
   [DE:der Salat:]
   [FR:la salade:]
</protect></pre>
このファイルで wml を実行したとき、あなたが翻訳したものは自動的に適切な
スライスが選択され、他のものは無視されるようになります。

<h3>wml で perl を使う</h3>
<p>利用法を拡張した wml の特徴の 1 つに perl の利用があります。私達の
ページは動的なページではないことを思い出してください。perl は html
ページが生成されるとき、上手く、そして好きなように動作するよう利用され
ています。ページ中でどのように perl を使っているかの 2 つの良い事例は、
メインページでの最新ニュースの項目一覧の作成と、ページ最下部の多言語
ページへのリンクの生成です。

<p>wml のドキュメントから学ぼうとするのは易しいことではありません。実際
にはとても良くできていますが、どう動作するのか (とてもパワフルです)
を理解し始めるまでは、実例から学ぶのがもっとも簡単です。Debian
サイトに役立っているテンプレートファイルが見つかるかもしれません。
それらは <code>english/template/debian/</code> にあります。

<h3>要求されるバージョン</h3>
 
<p>わたしたちのウェブサイトで要求される wml のバージョンは 2.0.6
で、公式にパッケージ化しているのは unstable ディストリビューション
だけです。unstable ディストリビューションに移さず、stable 
ディストリビューションのままでいたい方のために、Josip Rodin が
potato 用に wml を移植しています。パッケージは
<a href="http://people.debian.org/~joey/webwml/debs/";>こちら</a>
で見つけることができます。