trac(WEBでプロジェクト管理) †

• Memo/Subversion/trac/AccountManagerPlugin
  • AccountManagerPlugin
    • 概要
    • インストール
    • スクリーンショット
    • 参考リンク
• Memo/Subversion/trac/install
  • Trac インストール
    • 概要
    • 必要パッケージ
    • インストール
    • アクセスしてみる
    • 基本認証によるユーザ管理
    • ユーザ権限
    • コマンド
      • trac-admin
    • プラグイン
      • Web Admin Plugin - Webで権限管理
• Memo/Subversion/trac/TraM
  • TraM (Trac Multi)
    • 概要
    • インストール
    • スクリーンショット
    • 参考リンク
• Memo/Subversion/trac/webadmin
  • Web Admin Plugin
    • 概要
    • インストール
    • 権限詳細
    • スクリーンショット

Tips †

post-commitスクリプトの引数 †

• trac 0.10.4

  /var/svn/SandBox 70

チケットのインポート †

• Bugzilla, Sourceforge, Mantis, CSV
  • http://trac.edgewall.org/wiki/TracImport

Tracの通知メールの差出人が化ける †

• v0.10.4では解消
• v0.9.6で確認

MIMEMultipartメールなのだが、Becky 2.30でみると差出人が化けて表示されるようだ。
Fromの部分だけエンコーディングされていないのが原因。
デフォルトでは以下のようにプロジェクト名＋差出人となっている。

• /usr/lib/python2.3/site-packages/trac/Notify.py

  msg['From'] = '%s <%s>' % (projname, self.from_email)

• プロジェクト名を表示しないように変更
  • /usr/local/src/trac-0.9.6-ja-1/trac/Notify.py 2006-02-16 10:47:21.000000000 +0900

    +++ Notify.py   2007-03-14 15:21:24.000000000 +0900
    @@ -132,7 +132,7 @@
             msg['X-Trac-Project'] =  projname
             msg['X-URL'] =  self.config.get('project','url')
             msg['Subject'] = Header(self.subject, 'utf-8')
    -        msg['From'] = '%s <%s>' % (projname, self.from_email)
    +        msg['From'] = '%s' % (self.from_email)
             msg['Sender'] = self.from_email
             msg['Reply-To'] = self.replyto_email
             msg['To'] = rcp
    ----
    # service httpd graceful

Tracからのメールが飛ばない場合 †

• /var/log/maillog

  Mar 13 22:04:49 ts01x036 postfix/smtpd[30163]: connect from localhost.localdomain[127.0.0.1]
  Mar 13 22:04:49 ts01x036 postfix/smtpd[30163]: lost connection after CONNECT from localhost.localdomain[127.0.0.1]
  Mar 13 22:04:49 ts01x036 postfix/smtpd[30163]: disconnect from localhost.localdomain[127.0.0.1]

• trac.iniでログを出力するように変更し、apacheを再起動

  22:04:49 Trac[web_ui] ERROR: Failure sending notification on change to ticket #21: (-2, 'Name or service not 
  known')
  Traceback (most recent call last):
  

• 名前が見つからないらしい。
  • /etc/hostsに追加したら直った。pingで確認すると良い。

ログ出力 †

• trac.iniを書き換えて、apacheを再起動させるとlog/にログファイルができる。

  # vi conf/trac.ini
  ----
  [logging]
  log_file = trac.log
  log_level = DEBUG
  log_type = file
  ----
  # service httpd graceful

source:リンクで画像を表示しない †

標準では画像ファイル(.png, .gif, .jpg)へリンクすると自動的に展開し、表示されます。
これを抑制したい場合、末尾に/を付けると良いようです。
ちなみにリンク[]では使えませんでした。イリーガルな使い方のようです。

source:trunk/〜/foo.jpg/

英語版Tracから日本語版Tracへの移行 †

1. trac-admin wiki upgrade
2. DBに含まれている文字列は日本語化されないので以下を実施

• レポート表示(上部メニューの「チケットを見る」)の日本語化
  • 日本語版からダンプ

    sqlite> .output report_ja.sql
    sqlite> .dump report
    sqlite> .exit

  • ダンプしたSQLをちょっと編集し、create tableを削除と既存のレポート削除
    report_ja.sql
  • 更新

    $ su
    # sqlite -init report.sql /var/trac/mappl/db/trac.db
    Loading resources from report.sql
    SQLite version 2.8.16
    Enter ".help" for instructions
    sqlite> .exit
    

SQLite 2.x -> 3.x。または 3.x -> 2.xへ移行 †

SQLiteの3.xと2.xにはファイルフォーマットに互換性が無い。以下のエラーの場合は、データベースのバージョンが異なるので、エクスポート/インポートしなくてはいけない。

Unable to open database "trac.db": file is encrypted or is not a database

1. エクスポート
   • 2.x -> 3.x

     # cd /trac-repository/db
     # sqlite trac.db .dump | sqlite3 trac.db.3

   • 3.x -> 2.x

     # cd /trac-repository/db
     # sqlite3 trac.db .dump | sqlite trac.db.2

2. 移動

   # mv trac.db.x trac.db

キャッシュディレクトリを明示的に指定する †

「/etc/init.d/httpd restart」だとエラー、「service httpd restart」だと正常に起動する場合の対策。

起動ユーザのホームディレクトリにキャッシュディレクトリを作成しようとする模様。
「/root/.python-eggs」にキャッシュディレクトリを作成しようとして失敗している。

• 明示的にキャッシュディレクトリを指定(予め /var/www/.python-eggs ディレクトリは作成し、chown apache. /var/www/.python-eggsしておく)

  <Location /projects>
    ...
    SetEnv PYTHON_EGG_CACHE /var/www/.python-eggs
  </Location>

権限のグループ化 †

• 権限をまとめてグループにして、グループ単位で設定することができます。

  # trac-admin /path/to permission add developers TICKET_CREATE LOG_VIEW TICKET_MODIFY
  # trac-admin /path/to permission add spy developers

• TICKET_CREATE LOG_VIEW TICKET_MODIFY権限を持つdevelopersグループを作り、それをspyユーザに設定しています。

ページに目次(アウトライン)を付ける †

v0.9からPageOutline?マクロが標準添付されたので、ページの先頭でこれを記述すれば良い。

[[PageOutline]]

その他標準マクロは、tracのヘルプの「wiki/WikiMacros?」に記述がある。

wikiマクロ集 †

• MacroBazaar
• Trac Hacks

• プロジェクト全体にインストール

  /usr/share/trac/wiki-macros/

• プロジェクト毎にインストール

  /var/trac/SandBox/wiki-macros/

• ページは/で階層構造をとる事ができる。以下の外部プラグインで実現可能。
  • ParentWiki?.py
    親wikiページの表示

    wget -O ParentWiki.py http://trac.edgewall.org/attachment/wiki/MacroBazaar/ParentWiki.py?format=raw

• SubWiki? 子のwikiページの表示

  wget -O SubWiki.py http://trac.edgewall.org/attachment/wiki/MacroBazaar/SubWiki.3.py?format=raw

除外ファイル †

以下、リポジトリに格納しなくともよいファイル

• VisualStudio?

  拡張子	説明
  *.opt	開発環境で使用されるワークスペースのオプションファイル。
  *.clw	ClassWizard? で使用されるファイル。自動生成される。
  *.ncb	コンパイルされないブラウザファイル。自動生成される。
  *.aps	現在のリソーススクリプトファイルのバイナリバージョン。
  *.plg	プロジェクトログ。コンパイル結果などが記録される。

wikiに「Table of contents」を表示させる †

• ページ先頭付近に以下の1行を追加する

  [[TracGuideToc]]

日本語訳 †

• チケットの種類

  defect	不具合
  enhancement	新機能/拡張
  task	タスク

• 優先度

  blocker	極めて重大
  critical	重大
  major	中
  minor	低
  trivial	最低

• 操作

  fixed	修正済み
  invalid	無効
  wontfix	修正しない
  duplicate	重複
  worksforme	再現しない

• ＠IT > IT Architect > 開発プロセス再入門（8）

UTF-8以外のソースコードの表示 †

pythonの内部コードがUTF-8なので、通常UTF-8のみ表示可能。
JapaneseCodecs?を追加すれば、他文字セットも表示可能になる。

1. JapaneseCodecs?がインストールされている事
2. trac.iniの編集
   「/var/trac/sampleproject/conf/trac.ini」の設定を変更
   • EUC-JPの場合

     [trac]
     default_charset = japanese.euc-jp

   • Shift_JISの場合

     [trac]
     default_charset = japanese.shift_jis

   • その他

     default_charset = utf-8
     default_charset = japanese.ms932
     default_charset = japanese.iso-2022-jp

python2.3でsubversionのモジュールが無い時は。 †

subversionのソースから、以下のようにインストールする。

# configure
# make swig-py
# make install-swig-py
# ln -s /usr/local/lib/svn-python/libsvn /usr/lib/python2.3/site-packages/libsvn
# ln -s /usr/local/lib/svn-python/svn /usr/lib/python2.3/site-packages/svn

Subversion リポジトリに格納しているファイルのエンコード... †

Subversion リポジトリに格納しているファイルのエンコードが、ファイルごとに違う場合、svnのmime-type属性にcharsetを追加する。

$ svn propset 'svn:mime-type' 'text/plain; charset=Shift_JIS' *.txt
$ svn propset 'svn:mime-type' 'text/x-csrc; charset=Shift_JIS' *.c

ただし、以下のように[auto-props]では利用できない。「;」と「=」がデリミタとして指定されてる模様。以下のようにすると「charset=Shift_JIS」として登録されてしまう。

*.csv = svn:eol-style=CRLF;svn:mime-type=text/plain;charset=Shift_JIS

mod_pythonを用いる †

• trac.conf

  <Location /var/www/projects/trac.cgi>
     SetHandler mod_python
     PythonHandler trac.web.modpython_frontend
  </Location>
  

複数のプロジェクト用にApacheを設定する †

• index.php
• パスワードファイル

  /var/lib/trac/trac.htpasswd

• http://hostname/projects/ や 存在しないプロジェクトにアクセスした場合は「index.html」が表示される。プロジェクト一覧を表示するphpを用意すれば、便利。
  

# mkdir /var/www/projects
# cp /usr/share/trac/cgi-bin/trac.cgi /var/www/projects/
# cp index.php /var/www/projects/
# mkdir /var/lib/trac
# vi /etc/httpd/conf/trac.conf
----------------------------------------------------------
RewriteEngine on
RewriteRule ^/projects/+$			/projects/index.html [L]
RewriteCond /var/lib/trac/$1			-d
RewriteRule ^/projects/([[:alnum:]]+)(/?.*)	/projects/trac.cgi$2 [S=1,E=TRAC_ENV:/var/lib/trac/$1]
RewriteRule ^/projects/(.*)			/projects/index.html

<Directory "/var/www/projects">
	AllowOverride None
	Options ExecCGI -MultiViews +SymLinksIfOwnerMatch
	AddHandler cgi-script .cgi
	Order allow,deny
	Allow from all
</Directory>

<LocationMatch "/projects/[[:alnum:]]+/login">
	AuthType Basic
	AuthName "trac"
	AuthUserFile /var/lib/trac/trac.htpasswd
	Require valid-user
</LocationMatch>
----------------------------------------------------------

• RewriteEngine? はVirtualHost?毎に必要なので、Includeする

  # vi /etc/httpd/conf/httpd.conf
  ----------------------------------------------------------
  <VirtualHost 対象>
  Include "/etc/httpd/conf/trac.conf"
  </VirtualHost>
  ----------------------------------------------------------
  # svnadmin create --fs-type fsfs /var/svn/testproj
  # trac-admin /var/lib/trac/testproj initenv
  # chown -R apache:apache /var/lib/trac/testproj
  # service httpd restart

スクリプト †

• svnリポジトリ&trac作成
  
• basic認証ユーザ作成
• サンプル構成インポート
  svn-scripts.zip

サンプルwiki †

• PocketWikiMemo
• TracInstallPlatforms
• TracMultipleProjects

リンク †

• Tracおすすめプラグイン
• 日本語版trac
• Trac（BTS+Wiki+SVN）を試してみる
• trac導入の薦め