[Translate] /devel/website/desc.wml

[HAYAKAWA Hitoshi <cz@xxxxxxx>]

早川仁です。

/devel/website/desc.wml を翻訳しました。

============== cut here =============
#use wml::debian::template title="www.debian.org のウェブサイトはどのように構築されているのか"
#use wml::debian::translation-check translation="1.13"

<p>Debian のウェブサイトを構成しているディレクトリおよびファイルの
<em>``ウェブツリー''</em> は www-master.debian.org の
<tt>/org/www.debian.org/www</tt> ディレクトリ配下にあります。
ウェブサイトはミラーされるため、大部分のページはごく普通の静的な HTML ファ
イルです(つまり、CGI や PHP のスクリプトにより、動的に生成されるわけでは
ありません)。

<p>サイトは以下の三種類の内どれかの方法により生成されます。
<ul>
  <li>大部分は WML を利用して、CVS ツリーの `webwml' から生成されます。
  <li>ドキュメントは DebianDoc-SGML を使用して、CVS ツリーの
  `debian-doc' から生成されます。
  <li>サイトの一部は他のデータを利用するスクリプトにより生成されます
  (例えばメーリングリストの登録ページなど)
</ul>

<p>自動アップデート(CVS のリポジトリや他のデータから、ウェブのツリーを作成
します)は、一日四回実行されます。

<p>サイトにコントリビュートしたい場合、<code>www/</code> ディレクトリ配
下に単にファイルを追加や編集<strong>するのではなく</strong>、まず
<a href="mailto:webmaster@debian.org";>ウェブマスター</a> に連絡してくだ
さい。

<p>debwww グループは書き込み権限を含む、全てのディレクトリおよびファイル
のアクセス権限があります。そのため、ウェブのチームは<code>www</code>ディレクトリ
のファイルを編集することができます。このディレクトリのモード 2775 は、
ディレクトリ配下に作成された全てのファイルのグループが、ディレクトリのグ
ループである debwww を引き継ぐことを意味しています。debwww グループの
<code>umask</code> は、作成されるファイルにグループの書き込み権限が与え
られる <code>002</code> であることを想定しています。

<h3>ルックアンドフィール</h3>

<p>ページにヘッダやフッタなどを追加するといった細かな作業を <a
href="http://packages.debian.org/unstable/web/wml.html";>WML</a> にさせる
ことにより、各ページのルックアンドフィールが同じになるようにしています。
.wml のページは一見しただけでは HTML と同じに見えるかもしれませんが、
HTML は .wml 内で使用できる拡張情報の内の一つにすぎません。
ファイルを WML がフィルタに通した後には、本物の HTML ファイルが作成され
ます。WML の機能の一例を挙げるとすると、例えば Perl のコードをページに含
めることができます。これにより、ほぼあらゆることが可能になります。

<p>ただし WML は HTML コードの非常に基本的な、妥当性のチェック(時には
自動的に修正します)しかしません。
HTML コードの妥当性チェックを行うために、<a
href="http://packages.debian.org/unstable/web/weblint.html";>weblint</a>
や <a href="http://packages.debian.org/unstable/web/tidy.html";>tidy</a>
をインストールすべきです。

<p>我々のウェブページは現在 <a href="http://www.w3.org/TR/html4/";>HTML
4.01 Transitional</a> 標準に準拠していますが、<a
href="http://www.w3.org/TR/xhtml1/";>XHTML</a> に移行しようとしています。
できる限りすみやかに移行できるように、ウェブを編集する人は HTML タグを小
文字で書く、タグの終了タグを適切な場所に置く、などが強く推奨されています。

<p>多量のページを扱う人は、最終結果が意図した物になることを確実にするテ
ストが可能なため、WML をインストールすべきです。
Debian を使用しているのであれば、<code>wml</code> パッケージは簡単にイン
ストールできます。詳細については <a href="using_wml">WML の利用方法</a>
を参照してください。

<h3>ソース</h3>

<p>ウェブページのソースは CVS で管理されています。CVS はバージョン管理シ
ステムの一つで、いつ誰が何をなぜ変更したかといったことを記録することを
可能にします。これは複数の著者がソースファイルを同時に編集する状況を管理
する場合、安心な方法です。Debian のウェブチームは比較的人数が多いため、
このことは極めて重要です。

<p>もしこの問題に馴染みがない時には、<a href="using_cvs">CVS の利用方法
</a> ページを読むと良いかもしれません。

<p>CVS リポジトリの webwml ディレクトリの直下には、ウェブサイトの言語名
のディレクトリ、二つの Makefile 、いくつかのスクリプトがあります。翻訳さ
れたサイトのディレクトリ名は小文字の英語となっているはずです(例えばドイ
ツ語の場合 "german" で、"Deutsch" ではありません)。

<p>二つの Makefile は、より重要です。一つは Makefile.common で、名前の通
り、いくつかの共通のルールが記述されており、他の Makefile にインクルード
されて利用されます。

<p>各言語のディレクトリには Makefile、WML のソースファイル、サブディレク
トリがあります。ファイルおよびディレクトリ名は、リンクが正しい状態を維持す
るため、全ての言語において同じです。ディレクトリには WML が利用する情報
が格納された .wmlrc ファイルがあるかもしれません。

<p>webwml/english/template ディレクトリには、他のファイルから
<code>#use</code> コマンドにより参照されるためテンプレートと呼んでいる、
特別な WML ファイルがあります。english ディレクトリ以下にありますが、こ
れらのファイルは英語だけで使用されるわけではありません。

<p>テンプレートを使用しているファイルにテンプレートへの変更を知らせるた
めに、Makefile に依存していることが記述されています。ほとんどのファイル
は先頭に "<code>#use wml::debian::template</code>" 行を書いて "template"
テンプレートを使用しているため、(全ファイルに共通していることは)このテン
プレートに依存しています。もちろん例外はありますが。

<h3>スクリプト</h3>

<p>スクリプトは
<code>www-master.debian.org:/org/www.debian.org/cron</code> にあり、ほと
んどはシェルスクリプトか Perl で書かれています。

<p>詳細はディレクトリにある README ファイルと、言うまでもなくソース自身
を参照してください。

<h3>手伝うには</h3>

<p>Debian のサイトを、出来るだけ良いものにすることに興味を持っている全て
の方を歓迎しています。我々のページで抜けている、Debian に関する有用な情
報をお持ちの方は、追加しますので <a
href="mailto:debian-www@lists.debian.org";>お知らせ下さい</a>。

<p>(画像やレイアウトについて)ページのデザインや、HTML を綺麗にしておくこ
とに関しての手助けを常に必要としています。定期的にウェブサイト全体に、
下記のチェックを実行しています。</p>

<ul>
  <li><a href="http://www-master.debian.org/~treacy/urlcheck/";>URL check</a>
  <li><a href="http://www-master.debian.org/~barbier/validate/";>wdg-html-validator</a>
  <li><a href="http://www-master.debian.org/~barbier/tidy/";>tidy</a>
</ul>

<p>これらの実行結果のログを読み、問題があった時には修正してくれる方は、
いつでも歓迎しています。</p>

<p>英語が達者であればページを校正し、誤りは全て <a
href="mailto:debian-www@lists.debian.org";>我々</a> にご連絡ください。

<p>他の言語を喋る場合、その言語への翻訳をお手伝いください。翻訳が既に行
われており、また何か問題がある時には、<a
href="translation_coordinators">翻訳コーディネータ</a> のリストを見て、
その言語のリーダーにその問題についてご連絡ください。ご自身で翻訳を行いた
い場合は詳細は <a href="translating">Debian ウェブページの翻訳</a> を
参照してください。

<p>また、<a href="todo">TODO ファイル</a> もチェックしてみてください。</p>

<h3>お助け<strong>できません</strong></h3>

<p><em>[Q] <var>ウェブの見栄えを良くするための機能</var> を www.debian.org に追加したいのですが？</em>

<p>[A] お断りします。www.debian.org は出来るだけ利用しやすくしたいため、
<ul>
    <li>ブラウザ固有の「拡張機能」は使いません。
    <li>イメージだけを使用することはありません。明確にするためにイメージ
	を使用することはありますが、www.debian.org の情報は lyxn のようなテ
	キストしか表示できないウェブブラウザからも利用できるようにする必要が
	あります。
</ul>

<p><em>[Q] よいアイデアを持っています。www.debian.org で動いている HTTPD
の FOO という機能を有効にしてもらえますか？</em>

<p>[A] 駄目です。www.debian.org のミラーを行う管理者の負担を減らしたいた
め、HTTPD の特別な機能は使いません。SSI ですら駄目です。例外は content
negotiation(内容交渉)です。これは複数の言語を提供するために最適の方法だ
からです。

-- 
早川仁（はやかわひとし）
cz@xxxxxxx