= Tracd =

Tracd は軽量なスタンドアロンの Trac web サーバです。ほとんどのケースでは [wiki:TracCgi CGI] よりセットアップが簡単で、処理速度も速くなります。

== 利点 ==

 * 依存性が低い: apache その他 web サーバをインストールする必要がありません。
 * 速い: TracModPython バージョン並みに速いはずです ([wiki:TracCgi CGI] よりはずっと速い)。

== 欠点 ==

 * 機能が少ない: Tracd に実装されている web サーバはとてもシンプルで、 Apache HTTPD のような詳細なコンフィグレーションはできません。
 * ネイティブで HTTPS をサポートしない: 代わりに [http://www.rickk.com/sslwrap/ sslwrap] または
   [http://lists.edgewall.com/archive/trac/2005-August/004381.html STUNNEL] を使うことができます。

== 使用例 ==

ポート 8080 に単一のプロジェクトを作成します。 (http://localhost:8080/)
{{{
 $ tracd -p 8080 /path/to/project
}}}
複数のプロジェクト(http://localhost:8080/project1/ と http://localhost:8080/project2/)
{{{
 $ tracd -p 8080 /path/to/project1 /path/to/project2
}}}

trac は異なったプロジェクトの URL の一意性をパスの後方で保持するため、プロジェクト間でこれらを同じにすることは出来ません。
もし /project1/path/to と /project2/path/to を同時に指定した場合、二つ目のプロジェクトだけしか見えなくなります。

== 認証を使用する ==

Tracd は基本認証とダイジェスト認証の両方をサポートします。デフォルトはダイジェスト認証です; 基本認証を使用するためには、以降の例で使用する `--auth` を `--basic-auth` に置き換え、レルムの指定を削除して下さい。

ファイル `/path/to/users.htdigest` に project1 のユーザアカウントをレルム "mycompany.com" として保持している場合、以下に示すコマンドラインで tracd を起動します:
{{{
 $ tracd -p 8080 --auth project1,/path/to/users.htdigest,mycompany.com /path/to/project1
}}}
''Note: `--auth` オプションで指定するプロジェクトの "名前" は、実際には そのプロジェクトの TracEnvironment ディレクトリの basename です。''

もちろん、ダイジェストファイルは複数のプロジェクト間で共有することが出来ます:
{{{
 $ tracd -p 8080 \
   --auth project1,/path/to/users.htdigest,mycompany.com \
   --auth project2,/path/to/users.htdigest,mycompany.com \
   /path/to/project1 /path/to/project2
}}}

== Apache 以外の環境でパスワードを生成する ==

もし Apache が使用できない場合でも、簡単な Python スクリプトでパスワードを生成できます:

{{{
from optparse import OptionParser
import md5

# build the options
usage = "usage: %prog [options]"
parser = OptionParser(usage=usage)
parser.add_option("-u", "--username",action="store", dest="username", type = "string",
                  help="the username for whom to generate a password")
parser.add_option("-p", "--password",action="store", dest="password", type = "string",
                  help="the password to use")
(options, args) = parser.parse_args()

# check options
if (options.username is None) or (options.password is None):
   parser.error("You must supply both the username and password")
   
# Generate the string to enter into the htdigest file
realm = 'trac'
kd = lambda x: md5.md5(':'.join(x)).hexdigest()
print ':'.join((options.username, realm, kd([options.username, realm, options.password])))
}}}

----
See also: TracInstall, TracCgi, TracModPython, TracGuide