==TraM 0.3==

TraM(Trac Multi) は同一インスタンスを利用しているプロジェクトを俯瞰するツールです

==必要なもの==
* TraM0.3はTrac0.11でのみ動作します。
  (Trac0.10用のTraMが必要な場合はhttp://trac.rectang.com/projects/tram/にアクセスしてください) 
* Apacheとmod_pythonもしくはfcgi(実験的サポート)

==インストール==
* (Linux) http://trac.edgewall.org/ticket/7823　を参照してt7823-genshi_modpython-r8333-011.diffのパッチを適用してください。
* (Windows) Windowsへのインストール　の章を参照
* python setup.py install　を実行
* 個別プロジェクト側でallへのリンクを張るためにはコンポーネントを有効にします。
trac.iniを以下のように編集
[components]
tramplugin.* = enabled

* allのプロジェクト側ではレポートのリンクを出さないよう設定します。
trac.iniを以下のように編集
[components]
trac.ticket.report.* = disabled

* apacheのmod_pythonの設定で"trac.web.modpython_frontend"となっている箇所を"tram.modpython_frontend"に変更
* allという名前で新しいTracプロジェクトを作成
* apacheの再起動

=== WSGIを利用する場合 ===
tram/templates/deploy_trac.wsgiにWSGI用のスクリプトがあります。deploy_trac.wsgiのTRAC_ENV_PARENT_DIRを設定する変数を修正します。例えば下記のようにします。

{{{
os.environ['TRAC_ENV_PARENT_DIR']=C:\TracLight\projects\trac
}}}

編集したファイルを適当なディレクトリ(例えばTracLight\CollabNetSVN\httpd\cgi-bin\tram.wsgi)にコピーします。
Apacheの設定ファイル(CollabNet/httpd/conf/httpd.conf)のTracのWSGIの設定
{{{
WSGIScriptAlias /trac "C:\TracLight\CollabNetSVN\httpd\cgi-bin\trac.wsgi"
}}
を
{{{
WSGIScriptAlias /trac "C:\TracLight\CollabNetSVN\httpd\cgi-bin\tram.wsgi"
}}
のようにします。


==Windows環境へのインストール==
trac/web_ui/__init__.py.を修正する必要があるみたい。
trac/web/__init__.pyに下記の行を追加して、Tracを再インストール。

from pkg_resources import get_distribution
if not os.path.isdir(get_distribution('genshi').location):
    try:
+        from trac.web.api import *
        import mod_python.apache
        import sys

==その他==
以下のチケットについては、本モジュールで解決しています。
#23 http://trac.rectang.com/projects/tram/ticket/23
#24 http://trac.rectang.com/projects/tram/ticket/24
#35 http://trac.rectang.com/projects/tram/ticket/35

==オプション(allプロジェクト側)==
[tram]セクションでオプション設定が可能です。

old_style_index = true | false

　TracHoleSearchとの連携
　trueに設定すると、/tracにアクセスした場合は簡素なプロジェクト一覧を表示します。
　falseに設定するか、もしくはこの行を設定しない場合は、/trac/allと同じ画面が表示されます。

bar_color = RGB値

　例：＃B00
　トップページのゲージの色(デフォルト緑)を変更できます。

show_tickets_in_project_list = true | false

　プロジェクト一覧ページに自分が担当しているチケット一覧を表示します。
　デフォルトはfalse

expand = true | false

　プロジェクト一覧ページに自分のチケットを表示する際に、予め全ての
　チケットを表示するかどうか決定します。
　デフォルトはtrue

check_auth= true | false

　対象プロジェクト抽出の際に、権限をチェックするかどうか。
　デフォルトはfalseで、全てのプロジェクトを権限に関わらず抽出します。

permission = <Tracの権限>

　check_authオプション設定時に、権限の抽出条件を設定します。
　デフォルトはTRAC_ADMINで、管理者権限を持つプロジェクトのみ抽出します。

[components]
tramplugin.admin.TraMAdminModule = enabled

　TraMの管理画面の「一般」→「新規プロジェクト作成」から新規プロジェクトを作成することができます。


==オプション(個別プロジェクト側)==
[tram]セクションでオプション設定が可能です。

include_project_list = true | false

　当該個別プロジェクトをTraMのプロジェクト一覧に表示するか決定します。
　デフォルトはtrue

==ライセンス==
GPL

==作者==
For Trac 0.10 or lower 
* Andrew "HandyAndE" Williams <andy@handyande.co.uk>

For Trac 0.11
* Ryutaro "Ryuzee" YOSHIBA <ryuzee@users.sourceforge.jp>
  http://www.ryuzee.com

* Takashi OKAMOTO <okamototk@users.sourceforge.jp>
  http://tidus.ultimania.org/diary/


==謝辞==
原作者のAndrew "HandyAndE" Williams氏に感謝します。

Trac0.11対応に際して、以下の方の多大なるご協力を頂きました。ありがとうございます。
かぬさん
かおるんさん
syoさん
torinさん
jun66j5さん
