ヒビノログ

一昨年から個人的に参加させていただいているTracのコミュニティ「Shibuya.trac」の勉強会が7月7日（水）に行われます。

今回は、Tracの設定方法や、チームへ、社内へどうやって導入したか、また、実際の業務でどのように使っているか、といった内容が主になりそうです。
Tracは知ってるけど実際どうなの、とか、個人的に使ってるけどどうやって周囲に広めていったらいいの、というような思いを持っている方には参考になるのではと思ってます。
最近リリースされたtracの最新バージョン0.12についての話もありますので、ヘビーユーザーな方々にもおすすめ。
ちなみにShibuyaと付いていながら7回目にして初めての渋谷での勉強会らしいですｗ

申し込みはこくちーずのサイトで。
http://kokucheese.com/event/index/2886/

日時: 2010/7/7(水) 19:00-22:00 (開場18:45)
場所: マイクロソフト 新宿本社 6階 セミナールームC（東京都 渋谷 区代々木 2-2-1 小田急サザンタワー）
料金: 1,000円（予定、ビアバッシュ形式で、ビールやソフトドリンクとピザを勉強会中にお出しします）

詳しい内容はこちらのページにてご確認ください。
http://sourceforge.jp/projects/shibuya-trac/wiki/meeting%2F07

Tracをアジャイル開発向けにしてしまう強力なプラグイン、Agiloを入れてみたんだけど、ちょっとハマったので書いとく。
環境はインタアクト社が提供しているTrac日本語版の0.11.1.ja1。

まずsf.jpから最新をCheckoutしてきてセットアップ。

svn checkout http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/Agilo_ja/branches/agilo-0.8.3-r1918-20090925/
cd agilo-0.8.3-r1918-20090925
sudo python setup.py install

上記の操作までは問題なく終了。
で、プラグイン適用対象のプロジェクトにアクセスしてみる。
（ちなみにTraMを導入済みの環境）

Mod_python error: “PythonHandler tram.modpython_frontend”
（中略）
ImportError: cannot import name IRequestHandler

業務で使ってるほかのプロジェクトを確認してみると同じエラー。
うわーなんか壊してしまったーそんなつもりなかったのにー

で、Agilo入れてるときに流れるログを見ていて、ちょっと気になったことがあって。
Agilo以外にいくつか他のeggファイルも一緒にインストールされたんですよね。
自分の環境では以下の２つ。

• simplejson-2.1.1-py2.4-linux-x86_64.egg
• Genshi-0.5.1-py2.4-linux-x86_64.egg

そういえば、Trac 0.11.1 ではGenshiのeggファイルが圧縮されてるとエラーになることを思い出して（参考）上記のeggファイルを削除してGenshiを非圧縮で入れなおしてみました。

easy_install –always-unzip Genshi==0.5.1

apache再起動したら直って、Agilo入れたプロジェクトも動くようになった。

ただ、「バックログ」のメニューをクリックすると以下のようなエラーが表示される。

Traceback (most recent call last):
File “/usr/lib/python2.4/site-packages/Trac-0.11.1.ja1-py2.4.egg/trac/web/api.py”, line 339, in send_error
‘text/html’)
（略）
File “/usr/lib/python2.4/site-packages/Trac-0.11.1.ja1-py2.4.egg/trac/templates/error.html”, line 126, in
File "/usr/lib/python2.4/site-packages/Genshi-0.5.1-py2.4-linux-x86_64.egg/genshi/template/eval.py", line 279, in _die
raise UndefinedError(self._name, self._owner)
UndefinedError: "message" not defined

Tracの日本語パンフレット的なものを作りました。

Trac説明資料（Shibuya.trac OSC2010-Spring版）

海外の、特にオープンソースソフトウェアの日本語の情報については、基本的には自力で検索するなどして調べる必要があることが多いです。

好きでやる分にはそれでいいのですが、Tracのようにプロジェクトの見える化を促進するようなツールの場合、プロジェクトに関わるすべての人たち（様々な立場、様々な技術レベルの方々）にもわかってもらわないと意味がありません。

ということは、敷居ができるだけ低い方がいい。

Tracがどういうものか聞かれたとき、あるいは導入を提案するとき、今までは実際に画面を見せながら説明してたのですが、紙の資料があった方が話が早い場合がしばしばあり、もどかしさを感じていました。

今回、OSCでShibuya.tracのお手伝いをするにあたり、ちょうどいい機会だと思ったのでTracの説明用の資料を作ってみました。OSCで実際にブースに来た方々と話すうちにいくつか修正したいところも出てきたのですが、ひとまず公開してみます。

何かありましたらコメントやTwitterでお知らせいただければ。

Trac説明資料（Shibuya.trac OSC2010-Spring版）

あとは簡易マニュアルみたいなものもあるといいんですけどねー。
次回以降の課題ということで。

2年半ほど前、社内でTracを最初に使い始めたことから
Tracお世話人のようなものを任されていて、
新しい案件ができると、新規プロジェクトを作成して
メンバーや権限設定して、という作業をやってるんだけど、
Tracのスタートページに書く内容が固まってきた感があるので
まとめておこうと思った。

議事録、作業ログ

• 議事録や作業ログページへのリンク。
• 「次回の会議」ページも作ってアジェンダを書いてる。会議もTracの画面を見ながらやって、その場で議事録作成までやってしまう。

環境関連の情報

• サーバやクライアントのOS、ミドルウェアの種類、バージョン
• ネットワーク構成、システムに設定してるパラメータとか。

直近のTODO

• 関連するチケットの一覧をトップページに直接出してもいいし、一覧ページへのリンクでもいい。
• スクラムで言うところのスプリントバックログ、かな。

主な資料

• この欄についてはプロジェクトによってまちまちなんだけど、どんな条件でどんな操作をするとどんな結果を得るか、といったことを機能別にまとめて、そのページへのリンクを書いたりしてる。
• それとテーブル定義書とか、ER図とか
• あとは、開発環境の作り方、SVNへのコミット、テスト、デプロイ手順など開発に関するお約束へのページへのリンクなど。

プロジェクトの説明と関係者一覧

• このプロジェクトで実現することは何か、どんな意図があって、どんな想いが込められているか、といったようなことを書いておく。プロジェクトが苦しくなってきても心が折れずに済む、かもしれないｗ
• あとは関係者の名前、連絡先とか。

Twitterで

kurikazu : TraMのタイムライン表示でエラーになるなー。なんでだろ。

とPOSTしたらTraMの作者のRyuzeeさん召喚してしまった。申し訳ない･･･orz

エラーメッセージとしては、

'ascii' codec can't encode characters in position 0-20: ordinal not in range(128)
internal: none

というもので、文字コードが ascii として処理されている。
この場合、/usr/lib/python2.4/site-packages/ ディレクトリに、sitecustomize.py というファイルを作って、

import sys
sys.setdefaultencoding("utf-8")

と書いて保存する。Apache再起動したら直った。

今までTraM以外でも前述のようなエラーが出た事があって対処しきれずにいたけど、今回の修正以降はエラー発生してない。

【参考】
http://www.ryuzee.com/contents/blog/941
http://d.hatena.ne.jp/SumiTomohiko/20070120/1169300624