[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Debian JP master SVN www commits (rev.433)



=======================================================
Repository: /org/svn.debian.or.jp/repos
  Revision: 433
  Commiter: henrich
      Date: 2007-09-02 00:39:40 +0900 (日, 02  9月 2007)
=======================================================
Log:

 - add web workflow image.
 - modified webmasters.tt2 a lot!
 - some tweak include/config



=======================================================
Changed:

U   www/trunk/include/config
A   www/trunk/src/image/www-workflow.png
U   www/trunk/src/project/webmasters.tt2

Modified: www/trunk/include/config
===================================================================
--- www/trunk/include/config	2007-08-25 08:20:19 UTC (rev 432)
+++ www/trunk/include/config	2007-09-01 15:39:40 UTC (rev 433)
@@ -69,6 +69,7 @@
    jproject1 = [
      { url => 'project/', title => 'Project について' }
      { url => 'project/organization.html', title => '組織構成' }
+     { url => 'project/webmasters.html', title => '本サイトについて' }
      { url => 'project/join.html', title => '参加しませんか?' }
      { url => 'project/donations.html', title => '支援/スポンサー' }
      { url => 'project/', title => '»' }
@@ -77,7 +78,6 @@
    jproject2 = [
      { url => 'project/', title => 'Project について' }
      { url => 'project/organization.html', title => '組織構成' }
-     { url => 'project/webmasters.html', title => 'Webmasters' }
      { url => 'project/join.html', title => '参加しませんか?' }
      { url => 'http://vote.debian.or.jp/', title => '投票' }
      { url => 'project/donations.html', title => '支援/スポンサー' }

Added: www/trunk/src/image/www-workflow.png
===================================================================
(Binary files differ)


Property changes on: www/trunk/src/image/www-workflow.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Modified: www/trunk/src/project/webmasters.tt2
===================================================================
--- www/trunk/src/project/webmasters.tt2	2007-08-25 08:20:19 UTC (rev 432)
+++ www/trunk/src/project/webmasters.tt2	2007-09-01 15:39:40 UTC (rev 433)
@@ -1,62 +1,57 @@
-[% title = "Debian JP Webmasters に参加するには" %]
-	<h2>Debian JP Webmasters に参加するには</h2>
+[% title = "Debian JP のウェブページを変更するには" %]
 
-<p>Debian JP Webmasters は、<a href="http://www.debian.or.jp/";>Debian JP Project</a> の Web ページを管理しているチームです。Debian JP Project 会員になることで、チームに参加できます。</p>
+<h2>Debian JP のウェブページを変更するには</h2>
+<p>
+本サイトでは、webmaster チームを中心に subversion を利用して 
+Debian JP Project 会員有志の共同作業によってコンテンツの維持変更管理を行っています。
+どの様にして行われているのか、どうしたらコンテンツの変更ができるのかなどについて、
+興味がある方は以下の文章をご覧下さい。</p>
+<p>
+<ol>
+<li><a href="#joinml">Debian JP WWW メーリングリストに参加しよう</a></li>
+<li><a href="#subversion">Subversion クライアントの準備</a></li>
+<li><a href="#get">Web ページソースの取得</a></li>
+<li><a href="#look">中身を見てみよう</a></li>
+<li><a href="#workflow">作業の一般的な流れ</a></li>
+<li><a href="#blog">blog 記事の編集</a></li>
+<li><a href="#joinjp">Debian JP Project の会員になろう</a></li>
+<li><a href="#commit">変更を反映しよう</a></li>
+<li><a href="#agreement">どんどん勝手に変えちゃっていい?</a></li>
+<li><a href="#exclude">Subversion で管理されていないページ</a></li></ol></p>
 
-<h3>1. Debian JP WWW メーリングリストに参加しよう</h3>
 
+<h3><a name="joinml" id="joinml">1. Debian JP WWW メーリングリストに参加しよう</a></h3>
+
 <p>Debian JP WWW メーリングリストでは、
 <a href="[% wwworg %]/">Debian Project</a>
 の Web ページを和訳する作業や、現在ご覧になっている
 <a href="http://www.debian.or.jp/";>Debian JP Project</a>
 の Web ページコンテンツに関する議論を行っています。</p>
 
-<p>このメーリングリストに参加することが、``Debian JP Webmasters'' への道
-の第一歩です。</p>
+<p>
+どのようなやり取りが行われているか/いたのかについては、<a 
+href="http://lists.debian.or.jp/debian-www/";>過去ログ</a>が参考になります。</p>
 
-<p>参加方法は<a href="../ml/openml.html#wwwML">公開メーリングリスト</a>
-のページを参照してください。</p>
+<p>参加方法は<a href="../community/ml/openml.html#wwwML">公開メーリングリスト</a>のページを参照してください。</p>
 
-<p>既存のページの訂正や改善の提案、ユーザの役に立つ新規文書の公開などを
-通して、どしどしアピールしてください。
-</p>
 
+<h3><a name="subversion" id="subversion">2. Subversion クライアントの準備</a></h3>
 
-<h3>2. Debian JP Project の会員になろう</h3>
-<p>Debian JP Project の Web ページはいずれも Subversion で管理されています。
-後述するように、Subversion は非常に強力な共同作業ツールで、Debian だけ
-でなく、Windows などで作業することも可能です。
-</p>
-
-<p>ただ、誰にでも変更を許してしまうと悪い人に書き換えられてしまうかもしれませんから :)、
-Debian JP Project では、会員 (正会員) のみに書き換えの権限を許可しています
-(手元にソースを取得して中身を見ることは誰でもできます)。</p>
-
-<p><a href="../../project/join.html">参加方法</a>の説明を読んでください。
-参加にあたっては<a href="[% wwworg %]/social_contract">社会規約</a>への賛同と
-Debian JP Project の<a href="../../project/regulation.html">会則</a>の遵守
-が前提ですので、これにご賛同頂けない場合には残念ながらご遠慮いただく
-ことになります。
-</p>
-
-
-<h3>3. Subversion クライアントの準備</h3>
-
 <p>Debian JP Project の Web ページはバージョン制御システムの Subversion
 を用いて管理されているので、Web ページのソースを手元にコピーしたり
 更新したりするには、Subversion の実行環境 (クライアント) を準備しておかなければなりません。
 </p>
-
+<p>
 <ul>
 <li>Debian GNU/Linux の場合: 「apt-get install subversion」で、Subversion がインストールされます。</li>
 <li>その他の UNIX/Linux の場合: たいていは Subversion がパッケージ化されているので、どれをインストールすべきかすぐに見つかるはずです。見つからない場合でも、<a href="http://subversion.tigris.org/";>開発元のページ</a>からソースコードをダウンロードしてコンパイル、実行できます。</li>
 <li>Windows の場合:コマンド版もありますが、エクスプローラに統合された <a href="http://tortoisesvn.tigris.org/";>TortoiseSVN</a> という強力なクライアントソフトウェアがあります。メニューを日本語化する「Language packs」も提供されています。</li>
-</ul>
-
+</ul></p>
 <p>ただし、Web ページソースから実際の完成品 Web ページに近い「プレビュー」を手元で作成するには、Debian GNU/Linux のほうが便利です。</p>
 
-<h3>4. Web ページソースの取得</h3>
 
+<h3><a name="get" id="get">3. Web ページソースの取得</a></h3>
+
 <p>では、Debian JP Project の Web ページのソースを取得してみましょう。ネットワークに接続している状態で次のように実行します。</p>
 
 <pre>
@@ -67,7 +62,7 @@
 ディレクトリ) の下に "www.debian.or.jp" ディレクトリが作成され、
 その中に 現在 Subversion で管理されているコンテンツが取得されます。管理している場所は「リポジトリ」と呼びます。</p>
 
-<h3>5. 中身を見てみよう</h3>
+<h3><a name="look" id="look">4. 中身を見てみよう</a></h3>
 
 <p>Debian JP Project の Web ページでは、Template Toolkit (TT) という Perl を基盤にしたテンプレートシステムを採用しています。このシステムは機能はさほど多くありませんが、わかりやすく、たくさんの静的な Web ページを生成・管理するのに便利です。Debian では、libtemplate-perl パッケージをインストールすると利用できます。</p>
 
@@ -120,7 +115,10 @@
 <ol>
 <li>取得したディレクトリ  (www.debian.or.jp/) 直下をカレントディレクトリとします。</li>
 <li>まず次のパッケージ (およびその依存パッケージ) をインストールします: libtemplate-perl,  libxml-parser-perl, libxml-rss-perl, libtext-iconv-perl, nkf, wget</li>
-<li>Iconv.pm を /usr/lib/perl5/Template/Plugin/ にコピーするかシンボリックリンクを作成します。</li>
+<li>libtemplate 2.15 以降を利用している場合は、XML 関連のモジュールが分離されて別配布となっているので
+<a href="http://search.cpan.org/~abw/Template-XML-2.17/lib/Template/Plugin/XML.pm";>CPAN からソースを取得</a>して 
+dh-make-perl コマンドでパッケージの雛形を作り、libtemplate-xml-perl パッケージとしてインストールします。</li>
+<li>libtemplate 用のプラグインファイル Iconv.pm を /usr/lib/perl5/Template/Plugin/ にコピーするかシンボリックリンクを作成します。</li>
 <li>ttreerc を ~/.ttreerc にコピーし、src を「取得したディレクトリ/src」(たとえば /home/kmuto/www.debian.or.jp/src)に、dest をプレビューページを出力するディレクトリ (たとえば /home/kmuto/public_html/www.debian.or.jp) に、lib を「取得したディレクトリ/include」(たとえば /home/kmuto/www.debian.or.jp/include) に変更します。</li>
 <li>「progs/fetch-dsa debug」を実行します。これでトップページに挿入される DSA 情報が /tmp に用意されます (こうしておかないと、トップページの作成時にエラーが発生します)。プレビューなので、ファイルさえ残っていれば一度だけでかまいません。</li>
 <li>「ttree -v」を実行します(-v は冗長メッセージモードです)。これで、src ディレクトリからファイルのコピーおよび TT 変換が実行されて dest で指定したディレクトリに配備されます。</li>
@@ -131,29 +129,18 @@
 <p>ttree は追加/更新のみで、src からファイルがなくなっても dest からの削除は行いません。削除する場合には dest に対して手動で行う必要があります。</p>
 
 
-<h3>6. 作業の一般的な流れ</h3>
-
+<h3><a name="workflow" id="workflow">5. 作業の一般的な流れ</a></h3>
+<p>
+<img src="../image/www-workflow.png" alt="ワークフロー概要図" height="468" width="438"></p>
 <ol>
-<li>誰かがリポジトリを更新したかもしれないので、最初に手元の作業ディレクトリを更新しておきましょう。「svn up」で更新が行われます。ファイルが変更された場合は「U 〜」、追加された場合は「A 〜」、削除された場合は「D 〜」のようにずらずらと表示され、最後に「リビジョン 98 です。」のように表示されるでしょう。「G 〜」や「C 〜」のように表示された場合には少し注意が必要です (後述)。「M 〜」と出るのはあなたが手元で修正をしていてまだリポジトリには反映されていないファイルです。</li>
-<li>前節の内容にあるように、TT ファイルを編集したり、新規のファイルを置いたりしたあと、プレビュー確認しておきます。</li>
-<li>では、リポジトリに反映 (コミット) しましょう。ここでようやく「Debian JP Project 会員」の資格が生かされるときです。既存のファイルを変更しただけであれば、「svn ci -m "コミットメッセージ" 対象ファイル名」を実行します。"コミットメッセージ" は、変更内容を簡潔に記したメッセージ文です (たとえば「fixed a typo」など)。日本語も利用できないことはないですが、現時点では英語を使うことをお勧めします。はじめてのコミットのときには、SSL の自己証明書の許可、
-<pre>
- - ホスト名: svn.debian.or.jp
- - 有効範囲: Tue, 02 Jan 2007 11:21:11 GMT から Wed, 02 Jan 2008 11:21:11 GMT まで - 発行者: admin, Debian JP Project, Tokyo, JP
- - フィンガープリント: 6a:0b:f5:1d:7d:bb:48:1e:f4:29:2b:21:87:4f:1e:39:5e:86:d8:15
-</pre>
-ユーザ名とパスワード (会員に提供されたもの) が問い合わせられます。正しく回答してください。<br />
-「送信しています ... ファイルのデータを送信中です ... リビジョン 99 をコミットしました。」のように表示されれば成功です。</li>
-<li>新規のファイルやディレクトリを追加したいときには、「svn add ディレクトリあるいはファイル名」とします (ディレクトリ内のファイル・サブディレクトリは自動的に追加されます)。削除は「svn rm ディレクトリあるいはファイル名」、移動は「svn mv 旧ファイル名(またはディレクトリ名) 新ファイル名(またはディレクトリ名)」です。ただし、移動には1つのファイル名またはディレクトリ名しか指定できないので注意してください。これらの操作は、まだリポジトリには反映されていないので、上記の「コミット (svn ci)」によって反映します。</li>
-<li>あとは1.からの繰り返しです。</li>
+<li>「<strong>svn up</strong>」として、最初に手元の作業ディレクトリを更新しておきましょう。ファイルが変更された場合は「U 〜」、追加された場合は「A 〜」、削除された場合は「D 〜」のようにずらずらと表示され、最後に「リビジョン 98 です。」のように表示されるでしょう。「G 〜」や「C 〜」のように表示された場合には少し注意が必要です (後述)。「M 〜」と出るのはあなたが手元で修正をしていてまだリポジトリには反映されていないファイルです。<br>
+更新後、プレビュー確認しておきます。</li>
+<li>気になった点をピックアップします。大規模な変更が予想されたりする場合や他の作業者と被らない様に調整が必要な場合であれば、メーリングリストで事前にコミュニケーションしておきましょう。</li>
+<li>お気に入りのエディタでソースファイルを頑張って編集します。</li>
+<li>変更点が分かりやすくなるように「<strong>LANG=C svn diff src/index.tt2>/tmp/index.tt2</strong>」などとして手元の編集したファイルと元のファイルとの変更点を取得しましょう (ここで LANG=C しているのは、subversion のメッセージが UTF-8 で記録され、ソースファイルの EUC-JP エンコーディングと混在してしまうので、エディタによってはうまく開けないのを避けるためです)。</li>
+<li>取得した diff を説明とともにメーリングリストに送付しましょう。</li>
+<li>webmaster チームを中心とした Debian JP Project 会員が diff による変更をコミットして web に反映します。</li>
 </ol>
-
-<p>コミットは単一ファイルに基いて説明しましたが、Subversion のコミット単位はファイル単位ではなく、前回のコミットから今回のコミットまでに行われたすべてをもって1単位です。つまり、複数のファイルの変更・追加・移動・削除 (その他に属性の設定など) を一度のコミットで行うこともできます (ファイル名を複数指定するか、何も指定しない (対象を全部コミットすることになる) )。全体に対して大規模に何か行ったものの、手戻りに備えたいときなどには、このように一度のコミットにしておくことで簡単に操作できるようになります。</p>
-
-<p>include/ 内のファイルを操作するときには注意してください。ttreeがエラーなく進み、プレビューできることを確認しておくのがよいでしょう。不安なようであれば、Debian JP WWW メーリングリストに問い合わせてください。</p>
-
-<p>用語や注意については取得したディレクトリにある www.memo.txt も参照してください。</p>
-
 <p>「svn up」を実行したときに、「G 〜」や「C 〜」が表示されたときには注意すべきであると述べました。これらはいずれも手元で変更してコミットしていないファイルに対し、リポジトリ側で更新が行われた (つまりほかの人が先に変更をコミットした) ことを示します。「G 〜」は、Subversion が賢く変更をマージできたことを意味します。とはいえ、形而上マージに成功しただけで、意味的にマージするわけではないので、悪影響を及ぼしていないか確認する必要があります。「C 〜」は、手元の変更とリポジトリの変更で「競合」が発生した状態です。競合している場合、ディレクトリには〜.r99のようにリビジョン数字が付いたリポジトリ内での状態のファイルと、〜.mineの手元で変更したファイルが置かれ、競合の発生したファイル自体は次のようになります。</p>
 <pre>
 ...
@@ -162,15 +149,18 @@
 =====
  (リポジトリでの変更内容)
 &gt;&gt;&gt;&gt;&gt;.r99
-...
-</pre>
-<p>競合を解決するには、手元の変更を破棄する方法と、手動で変更をマージする方法の2つがあります。前者は「svn revert ファイル名」で、手元の変更は破棄され、リポジトリのものに戻されます (svn revert は競合の解決に限らず、手元でいろいろ修正したものの「やり直し」をしたいときにも便利です)。後者は、上記の不等号で囲まれたファイル内容を適切に修正したあと、「svn resolved ファイル名」で競合解決を知らせます。このあとにコミット (svn ci) 作業をすれば、競合解決の済んだファイルをコミットできます (競合内容を抱えたまま競合解決指示およびコミットしないよう注意してください)。
-</p>
+...</pre>
+<p>
+競合を解決するには、手元の変更を破棄する方法と、手動で変更をマージする方法の2つがあります。
+前者は「svn revert ファイル名」で、手元の変更は破棄され、リポジトリのものに戻されます (svn revert は競合の解決に限らず、手元でいろいろ修正したものの「やり直し」をしたいときにも便利です)。
+後者は、上記の不等号で囲まれたファイル内容を適切に修正したあと、「svn resolved ファイル名」で競合解決を知らせます。
+このあとにコミット (svn ci) 作業をすれば、競合解決の済んだファイルをコミットできます (競合内容を抱えたまま競合解決指示およびコミットしないよう注意してください)。</p>
 
 <p>詳細については、「<a href="http://subversion.bluegate.org/doc/index.html";>Subversion によるバージョン管理</a>」および書籍『Subversion実践入門』(オーム社) などを参照してください。</p>
 
-<h3>7. blog 記事の編集</h3>
 
+<h3><a name="blog" id="blog">6. blog 記事の編集</a></h3>
+
 <p>blog/ で示される記事には、blosxom というシンプルな blog システムを採用しています。</p>
 <p>blosxom/ ディレクトリが blosxom の本体です。plugins は機能拡張プラグインで、最小限のプラグインを登録してあります (実際に使用するには /etc/blosxom/plugins へのリンクが必要となります。新しいプラグインの登録が必要なときは管理チームに問い合わせてください)。data/flavours は見た目のテンプレートファイルです。この中にある maketemplate.pl ファイルは、head.html と foot.html を src/blog/dummy.tt2 の TT 変換後データから生成するものです (ヘッダ、メニュー、フッタの更新に対応させるため)。記事は、data ディレクトリ直下にコミットします。記事の拡張子は .d、文字エンコーディングは EUC-JP にしてください。記事は次のような構成になります。</p>
 
@@ -184,38 +174,76 @@
 
 <p>日付を指定する必要はありません。ファイルの作成・更新時間に基づいて自動的に blog 上で表現されます。</p>
 
-<h3>7. いつ反映されるの ?</h3>
 
-<p>修正が登録されるとコミットログが Debian JP WWW メーリングリストに流れます。
-1時間ごとに、修正された内容が
-<a href="http://www.debian.or.jp/";>Debian JP Web ページ</a>に反映されます。
-</p>
+<h3><a name="joinjp" id="joinjp">7. Debian JP Project の会員になろう</a></h3>
 
-<h3>8. どんどん勝手に変えちゃっていい ?</h3>
+<p>これまで述べた通り、Debian JP Project の Web ページはいずれも Subversion で管理されています。
+Subversion は非常に強力な共同作業ツールで、Debian だけでなく、Windows などで作業することも可能です。</p>
 
+<p>ただ、誰にでも変更を許してしまうと悪い人に書き換えられてしまうかもしれませんから :)、
+Debian JP Project では、会員 (正会員) のみに書き換えの権限 (コミット権) を許可しています
+(手元にソースを取得して中身を見ることは誰でもできます)。</p>
+
+<p>これまでの作業内容を理解し、もっともっと積極的に Debian JP Project 
+のページを良くしていきたい、と思われた方は<a 
+href="./join.html">参加方法</a>の説明を読んで 
+Debian JP Project への参加手続きを行ってください。
+参加にあたっては<a href="[% wwworg %]/social_contract">Debian 社会契約</a>への賛同と
+Debian JP Project の<a href="./regulation.html">会則</a>の遵守
+が前提となります。</p>
+
+
+<h3><a name="commit" id="commit">8. 変更を反映しよう</a></h3>
+<ol>
+<li>無事 Debian JP Project 会員となったら、リポジトリに提案や作業内容やを反映 (コミット) しましょう。
+既存のファイルを変更しただけであれば、「svn ci -m "コミットメッセージ" 対象ファイル名」を実行します。
+"コミットメッセージ" は、変更内容を簡潔に記したメッセージ文です (たとえば「fixed a typo」など)。
+日本語も利用できないことはないですが、現時点では英語を使うことをお勧めします。
+はじめてのコミットのときには、SSL の自己証明書の許可、
+<pre>
+ - ホスト名: svn.debian.or.jp
+ - 有効範囲: Tue, 02 Jan 2007 11:21:11 GMT から Wed, 02 Jan 2008 11:21:11 GMT まで - 発行者: admin, Debian JP Project, Tokyo, JP
+ - フィンガープリント: 6a:0b:f5:1d:7d:bb:48:1e:f4:29:2b:21:87:4f:1e:39:5e:86:d8:15</pre>
+ユーザ名とパスワード (会員に提供されたもの) が問い合わせられます。正しく回答してください。<br>
+「送信しています ... ファイルのデータを送信中です ... リビジョン 99 をコミットしました。」のように表示されれば成功です。</li>
+<li>新規のファイルやディレクトリを追加したいときには、「svn add ディレクトリあるいはファイル名」とします (ディレクトリ内のファイル・サブディレクトリは自動的に追加されます)。削除は「svn rm ディレクトリあるいはファイル名」、移動は「svn mv 旧ファイル名(またはディレクトリ名) 新ファイル名(またはディレクトリ名)」です。ただし、移動には1つのファイル名またはディレクトリ名しか指定できないので注意してください。これらの操作は、まだリポジトリには反映されていないので、上記の「コミット (svn ci)」によって反映します。</li>
+<li>
+コミットは単一ファイルに基いて説明しましたが、Subversion のコミット単位はファイル単位ではなく、前回のコミットから今回のコミットまでに行われたすべてをもって1単位です。つまり、複数のファイルの変更・追加・移動・削除 (その他に属性の設定など) を一度のコミットで行うこともできます (ファイル名を複数指定するか、何も指定しない (対象を全部コミットすることになる) )。全体に対して大規模に何か行ったものの、手戻りに備えたいときなどには、このように一度のコミットにしておくことで簡単に操作できるようになります。</li>
+<li>
+include/ 内のファイルを操作するときには注意してください。ttreeがエラーなく進み、プレビューできることを確認しておくのがよいでしょう。不安なようであれば、Debian JP WWW メーリングリストに問い合わせてください。</li>
+<li>
+用語や注意については取得したディレクトリにある www.memo.txt も参照してください。</li>
+<li>あとはワークフローの通り、繰り返しです。</li></ol>
+
+<p>
+会員は何時でもウェブページの修正を実施できます。
+修正が登録されるとコミットログが Debian JP WWW メーリングリストに流れます。
+そして、1時間ごとに修正された内容が
+<a href="http://www.debian.or.jp/";>Debian JP Web ページ</a>に反映されます。</p>
+
+
+<h3><a name="agreement" id="agreement">9. どんどん勝手に変えちゃっていい?</a></h3>
+
 <p>ちょっとした (明らかな入力ミスなどの) 修正なら、
-特に確認なしで「svn up」した内容を見て
-どんどん行ってかまいません。</p>
+特に確認なしで「svn up」した内容を見てどんどん行ってかまいません。</p>
 
 <p>内容の大幅な変更や、ベーステンプレート、ファイル構成の変更を含む場合には、
-まず Debian JP WWW メーリングリスト に変更案を出して、
-ほかの Webmasters たちの意見を聞いてみましょう。
-そのためのメーリングリストですから。</p>
+まずメーリングリストに変更案を出して、意見を聞いてみましょう。</p>
 
-<h3>9. Subversion で管理されていないページ</h3>
+<h3><a name="exclude" id="exclude">10. Subversion で管理されていないページ</a></h3>
 
 <p>Debian JP Project の Web ページの大部分は Subversion で管理されていますが、
 一部、自動生成する必要から Subversion では管理されていなかったり、TT のスクリプトで自動生成しているページもあります。</p>
 <ul>
- <li>DSA 情報<br />
+ <li>DSA 情報<br>
 トップページの右にある DSA 情報は、cron で 30 分ごとに更新されています。</li>
- <li><a href="http://lists.debian.or.jp/";>http://lists.debian.or.jp/</a><br />
+ <li><a href="http://lists.debian.or.jp/";>http://lists.debian.or.jp/</a><br>
  Debian JP Project が管理するメーリングリストのアーカイブです。
  lists.debian.or.jp (osdn.debian.or.jp) の
  /org/lists.debian.or.jp/mhonarc/archive-inject が生成スクリプトです。</li>
- <li><a href="../../using/book.html">書籍情報</a><br />
+ <li><a href="../using/book.html">書籍情報</a><br>
  書籍情報は、include/book.txt をデータベースとして、TT で自動生成しています。</li>
- <li><a href="../../using/mirror.html">ミラーサイト</a><br />
+ <li><a href="../using/mirror.html">ミラーサイト</a><br>
  ミラーサイトは、MirrorsJP.list をデータベースとして progs/make-sources.list.sh を実行して更新します (progs/update mirror)。</li>
 </ul>
 
@@ -223,10 +251,11 @@
 debian-www メーリングリストで相談してください。
 </p>
 
-<h3>10. おわりに</h3>
 
+<h2>おわりに</h2>
+
 <p>Debin JP Project の Web ページが「完成」することはありません。
 全体構成についても「このほうがナビゲーションとして良いのでは」
 「こういうドキュメントもあると良いのでは」ということがあることでしょう。
 あなたもぜひ、Web コンテンツの作成を通して自分の「作品」を
-Debian JP Project に contribute しませんか ?</p>
+Debian JP Project に contribute しませんか ?</p>tim