3. 環境整備

3.1. subversion リポジトリ

まずは、http://www.momonga-linux.org/ のドキュメント書き用のアカウントを申請しましょう。 アカウント申請ルールをご覧ください。

アカウントができたら、http://www.momonga-linux.org/ のコンテンツを checkout します。 passphrase を聞かれますので自分の passphrase を入力し Enter を押下すれば checkout が始まります。

     $ svn co svn+ssh://your_account@svn.momonga-linux.org/home/svnroot/svnroot_docs/trunk/docs
     Enter passphrase for key '/home/hoge/.ssh/id_rsa': 
     $ svn co svn+ssh://your_account@svn.momonga-linux.org/home/svnroot/svnroot_www/trunk/www
     Enter passphrase for key '/home/hoge/.ssh/id_rsa': 
    

または、anonymous svn でも docs コンテンツの checkout はできます。

     $ svn co svn://anonsvn.momonga-linux.org/svnroot_docs/trunk
    
[メモ] anonymous svn について

anonymous svn では修正したドキュメントの commit はできません。commit したくなったらアカウントを申請してください。

以上のどちらかの操作でカレントディレクトリ以下にwww および docsというディレクトリがあらわれます。 このディレクトリを以下 www および docs ディレクトリと呼ぶことにします。

3.2. 必要なパッケージ

以下に http://www.momonga-linux.org/ のコンテンツをいじるのに必要となるパッケージを列挙します。

     libxml2-devel1
     libxslt2
     docbook-style-xsl3
     docbook-dtds4
     xml-common5
     scrollkeeper
    
1

www ディレクトリの文書に必要。

2

docs 以下の文書に必要。 libxslt-1.0.5-2k 以降で動作確認。

3

docs 以下の文書に必要。 docbook-style-xsl-1.45-4k 以降必須。

4

docs 以下の文書に必要。

5

docs 以下の文書に必要。

です。

Momonga Linux 1.0 以降では、これらは最初から品揃えできています。

3.3. コンテンツの make

docs、www 共にディレクトリにある Makefile を使います。

3.3.1. www ディレクトリ

www では

     $ make
    

とすると、アナウンス関係の自動生成コンテンツ一式 が作成されます。

3.3.2. docs ディレクトリ

docs を初めて svn checkout した時にはまだ Makefile が無いので、 docs ディレクトリにて autogen.sh というスクリプトで Makefile を作成します。

      $ ./autogen.sh
    

その後 make を実行してください。 新規ドキュメントが追加された時にも、Makefile にそのドキュメントのエントリを追加するために autogen.sh を実行の上 make してください。