Tracのインストールと日本語化

Subversion実践入門 の巻末に紹介されている、Subversionと連携可能なWiki/バグ追跡システムTracが便利そうなので使ってみた。

Debian sargeでのインストールは、既にstableに入っているからそのままaptitudeでOK。その後、 Sarge で trac を使う(まだ途中) を参考にしながらテスト用のプロジェクトを生成した。

# mkdir /var/svn
# svnadmin create --fs-type fsfs /var/svn/testproj
# mkdir /var/trac
# trac-admin /var/trac/testproj initenv
Creating a new Trac environment at /var/trac/testproj

Trac will first ask a few questions about your environment
in order to initalize and prepare the project database.

 Please enter the name of your project.
 This name will be used in page titles and descriptions.

Project Name [My Project]> Test Project

 Please specify the absolute path to the project Subversion repository.
 Repository must be local, and trac-admin requires read+write
 permission to initialize the Trac database.

Path to repository [/var/svn/test]> /var/svn/testproj

 Please enter location of Trac page templates.
 Default is the location of the site-wide templates installed with Trac.

Templates directory [/usr/share/trac/templates]> /usr/share/trac/templates

 Please enter location of Trac default wiki pages.
 Default is the location of the site-wide templates installed with Trac

Default wiki directory [/usr/share/trac/wiki-default]>
Creating and Initializing Project
...
Congratulations!

日本語化するには、システムが使用するテンプレートファイルおよびシステムがWikiの初期状態として使用するデータファイルを翻訳する必要がある。この翻訳をインタアクト株式会社がしてくれているので、 <URL:http://www.i-act.co.jp/project/products/products.html> からダウンロードする。unzipして出てくる中のtemplates/,wiki-default/の両ディレクトリで/usr/share/trac/templates/と/usr/share/trac/wiki-default/を上書きし、それから上記trac-adminを再度やり直せば、Wikiやその他のインターフェースが日本語化される。

このとき、インターフェース用のテンプレートはtrac-adminにどのディレクトリを使用するか訊かれるので代わりに/usr/share/trac/templates.jaとかを適切に指定することにすれば、英語版と日本語版の共存が可能だ。でも、Wikiのデフォルト文書の方は訊いてくれず、インストール時に固定されてしまっているので、そのままでは日本語版で英語版を上書きするしかない。この問題は先の参照記事のkinnekoさんも ぶつかっていた

この辺に対応したL10Nは無いもんだろうかとちょっと探してみたけれど、見つからなかったのでちょっとtrac-adminに手を入れてなんとかしてみた。何しろチュートリアルレベル以上のPythonを書くのはこれがほぼ初めてだ。まともなPython使いから見れば酷い出来だろうけれど、取りあえず良い感じに動いている。=> trac-admin_0.8.1-ja.patch

さてと、使い方は次の通り。

  • ダウンロードした翻訳のtemplates/とwiki-default/を/usr/share/trac/templates.ja/と/usr/share/trac/wiki-default.ja/に各移動。
  • /usr/bin/trac-adminにこのパッチをあてる。
  • initenvし直す。今度はTemplate directoryと同じようにDefault wiki directoryも訊かれるので、日本語版を指定してやれば良い。