The Debian Documentation Project では、 ウェブページや多くのマニュアル文書を svn.debian.org の Debian Subversion サーバに置いています。 svn.debian.org は alioth.debian.org の Gforge インストレーションの一部です。 このサービスがどのように動作しているかについての詳細は、Alioth ドキュメント を参照してください。
どなたでも、SVN からソースをダウンロードできます。 ファイルを更新できるのは、 Debian Documentation Project のメンバーだけです。
ウェブ上で個々のファイルにアクセスしたり、 それらの変更状況を見たりしたい場合に使えるウェブインターフェースには、 http://svn.debian.org/wsvn/ddp/manuals/trunk からアクセスできます。
マニュアル全部をダウンロードしたい場合には、 SVN サーバに直接アクセスするほうが良いでしょう。 この場合にはマシンに subversion パッケージを入れておく必要があります。
次のコマンドを入力して接続してください:
svn co svn://svn.debian.org/ddp/manuals/trunk manuals
このコマンドを実行すると、再帰的にディレクトリが生成され、 その中にファイルが保存されます。
ローカルにコピーしたファイルを、 他の人の加えた変更に応じてアップデートするには、 manuals ディレクトリに移動して次のコマンドを実行します。
svn update
ここに述べる方法で SVN サーバにアクセスするには、 書き込み権限を持ってアクセスする許可が先に必要になります。 まず更新権限の請求方法をご覧ください。
ファイルを全部ダウンロードするには、次のコマンドを使います。
svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals
このコマンドを実行すると、再帰的にディレクトリが生成され、 その中にファイルが保存されます。
ローカルにコピーしたファイルを、 他の人の加えた変更に応じてアップデートするには、 manuals ディレクトリに移動して次のコマンドを実行します。
svn update
更新権限は、 マニュアルの執筆に参加を希望される方ならどなたでも入手できます。 通常は、まず有効なパッチをいくつか出していることが要求されます。
アップデート権限を入手するには、Debian
ドキュメンテーションメーリングリストにリクエストを出して、
なぜそれが必要なのかを説明してください。あなたの
Alioth ログイン名も提示してください。
要求が承認されたら、あなたは Alioth の ddp
プロジェクト (および Unix グループ) の一員となります。
公開されたマニュアル文書のウェブページは、 www-master.debian.org で、定期ウェブサイト再構築処理の一環として 毎 4 時間ごとに生成されます。
このスクリプトは、まず svn update を、 ついで make -C manuals clean publish を実行します。
makefile は、すべてのサブディレクトリ
(メンテナンスされている文書が入っています) をリビルドし、
すべてのサブディレクトリからファイルを
doc/manuals/ のウェブサイト用サブディレクトリに
インストールするよう設定されています。
各サブディレクトリの makefile は
manuals/standard.makefileから呼ばれます。
更新スクリプトによって生成されたドキュメントファイルは、 http://www.debian.org/doc/manuals/ で見ることができます。
更新スクリプトによって生成されたログファイルは、 http://www-master.debian.org/build-logs/ddp/ で見ることができます。
この処理は /doc/manuals/ ディレクトリを再生成することに
注意してください。/doc/ ディレクトリ内の内容は
webwml または、パッケージからとある
マニュアルを展開するといったようなその他のスクリプトの両方から生成されます。