= Trac インストールガイド =
[[TracGuideToc]]

Trac は軽量なプロジェクト管理ツールで、 Web ベースのアプリケーションとして実装されています。 Trac は Python で記述されており、データベースとして [http://sqlite.org/ SQLite] や [http://www.postgresql.org/ PostgreSQL] を使用することができます。 HTML レンダリングには [http://www.clearsilver.net/ Clearsilver] テンプレートシステムを使用します。

以下に示すのは、 Trac のインストールと設定要件に関する一般的な説明です。 Trac を特定のシステムにインストールするための説明は Trac のメインサイトの [http://projects.edgewall.com/trac/wiki/TracInstallPlatforms TracInstallPlatforms] に掲載されています。インストールに必要なタスクをよく理解するためにこれらの一般的な説明を最初に必ず読んでください。

== インストール要件 ==

ソフトウェア要件:

 * [http://www.python.org/ Python], バージョン 2.3 以上。
   * Python バージョン 2.4 は Windows でサポートされていません。利用できる Windows 用の Subversion bindings がありません。
   * RPM をベースとしたシステムでは `python-devel` と `python-xml` パッケージも必要かもしれません。
 * [http://subversion.tigris.org/ Subversion], バージョン 1.0 以上 (バージョン 1.1 以上を推奨) と 対応する [http://svnbook.red-bean.com/svnbook-1.1/ch08s02.html#svn-ch-8-sect-2.3 Python bindings]。
   * Trac は Subversion の中に含まれている [http://www.swig.org/ SWIG] bindings を使用します。[http://pysvn.tigris.org/ PySVN] ( ときどきSWIG binding と間違えることがあります) '''ではありません。'''
   * もし すでに Subversion が SWIG bindings なしでインストールされていたら、Subversion を re-`configure` し、`make swig-py`, `make install-swig-py` を行う必要があります。
 * [http://www.clearsilver.net/ ClearSilver], バージョン 0.9.3 以上。
   * python-bindings (`./configure --with-python=/usr/bin/python`)

=== SQLite利用 ===

 * [http://www.sqlite.org/ SQLite], バージョン 2.8.x か 3.x
 * [http://pysqlite.org/ PySQLite]
   * version 1.0.x (for SQLite 2.8.x)
   * version 1.1.x or 2.x (for SQLite 3.x)

=== PostgreSQL利用 ===

 * [http://www.postgresql.org/ PostgreSQL]
 * [http://initd.org/projects/psycopg1 psycopg1], [http://initd.org/projects/psycopg2 psycopg2], or [http://pypgsql.sourceforge.net/ pyPgSQL]

=== オプション要件 ===

 * CGI をサポートする Web サーバ (see TracCgi) または
 * [http://www.fastcgi.com/ FastCGI] をサポートする Web サーバ(see TracFastCgi) または
 * [http://httpd.apache.org/ Apache] と [http://www.modpython.org/ mod_python 3.1.3+] (see TracModPython)
 * プラグインを使用する場合 [http://peak.telecommunity.com/DevCenter/setuptools setuptools], バージョン 0.5a13 以上。 (see TracPlugins)
 * WikiRestructuredText を使用する場合 [http://docutils.sourceforge.net/ docutils], バージョン 0.3.3 以上
 * [wiki:TracSyntaxColoring シンタックス ハイライト] を使用する場合 [http://silvercity.sourceforge.net/ SilverCity] または [http://www.gnu.org/software/enscript/enscript.html Enscript] もしくは両方。

''注意''': これらのソフトウェアの依存するパッケージに利用可能なバージョンがいろいろありますが、かならずしも互換性あるとは限りません。上記のバージョン番号に注意してください。もし Trac が動かないようだったら、すべての依存関係をもう一度確認してください。確認したうえで、 [http://projects.edgewall.com/trac/wiki/MailingList メーリングリスト] や [http://projects.edgewall.com/trac/wiki/IrcChannel IRCチャンネル] をたずねてみてください。

これらのパッケージの最もよいインストール方法を理解するためにパッケージ付属のドキュメントを読んでください。加えて、 [http://projects.edgewall.com/trac/wiki/TracInstallPlatforms プラットフォーム特有の説明] にも、インストール時の依存関係が記述されています。

== Trac のインストール ==

多くの Python プログラムと同様、ソースディレクトリの一番上で次のコマンドを実行することで、 Trac の Python パッケージをインストールできます:
{{{
$ python ./setup.py install
}}}

''Note: このステップをおこなうには root 権限、またはそれと同等の権限が必要です。''

この手順は、 Python ソースコードをバイトコンパイルして、 Python の `site-packages` ディレクトリにインストールします。
また、ディレクトリ `cgi-bin`, `template`, `htdocs`, `wiki-default`, `wiki-macros` 配下のすべてのファイルを
`$prefix/share/trac/` ディレクトリにコピーします。  

さらに、このスクリプトでは  [wiki:TracEnvironment Trac environment] を作成したりメンテナンスするためのコマンドラインツールである [wiki:TracAdmin trac-admin] や、スタンドアロンで動作するサーバ [wiki:TracStandalone tracd] をインストールします。

=== 上級ユーザ ===

Trac を上記以外の場所にインストールしたい場合や、その他の高度なインストールオプションを見たい場合は次のコマンドを実行してください:
{{{
$ python ./setup.py --help
}}}

単純にインストールする場所を変えたいのであれば、以下の通りです:
{{{
$ python ./setup.py install --prefix=/path/you/want
}}}


== プロジェクト環境の作成  ==

[wiki:TracEnvironment Trac environment] は Trac が Wiki ページ、チケット、レポート、設定などのような情報を保存するバックエンドストレージです。 [wiki:TracEnvironment Trac environment] は基本的に、人間が読むことができる設定ファイル、その他いろいろなファイルとディレクトリを含んだディレクトリです。 

[wiki:TracAdmin trac-admin] を使用して、新しい Trac environment を作成します。:
{{{
$ trac-admin /path/to/trac_project_env initenv
}}}

[wiki:TracAdmin trac-admin] がプロジェクト環境を作成するのに必要な情報を聞いてきます。たとえば、プロジェクトの名前や、使用する Subversion リポジトリのパス、 [wiki:TracEnvironment#データベースに接続するための文字列 データベースに接続するための文字列] などです。もしこれらのオプションのひとつを何にすればいいのか分からなければ、デフォルト値を使用するために空白にしておいてください。特にデータベースに接続するための文字列は SQLite をインストールしている限り、動くでしょう。ただ唯一デフォルト値を使用した場合に動かないであろうというオプションは Subversion のリポジトリへのパスくらいでしょう。このオプションは確実に修正して下さい。

また、ここで指定した値は後で [wiki:TracIni 設定ファイル] を編集することによって変更できます。

''Note: Web サーバの起動ユーザには、この environment ディレクトリ、
およびその配下のすべてのファイルに対する書き込みパーミッションが必要です。 ''


== スタンドアロンサーバを起動する ==

Trac environment を作成した後, スタンドアロンサーバの [wiki:TracStandalone tracd] を起動することによって簡単に Web インタフェースを使ってみることができます。
{{{
$ tracd --port 8000 /path/to/projectenv
}}}

そして、ブラウザを起動して、 `http://localhost:8000/` にアクセスしてみてください。 tracd が認識しているすべての環境が簡単にリストされます。作成した環境へのリンクをクリックし、実際の Trac を見るべきです。


== Web サーバで Trac を起動する ==

Tracは“"本当の" Web サーバに接続するための 3 つのオプションを提供しています: [wiki:TracCgi CGI], [wiki:TracFastCgi FastCGI] と [wiki:TracModPython mod_python] です。まともなパフォーマンスを引き出すために、 FastCGI か mod_python を使用することをおすすめします。

== 認証の設定 ==

ユーザアカウントの追加・削除・設定はどのような方法で Trac を動かしているかによります。これらのタスクをどのようにこなしていくかを知るために、以下にあげるページを訪れてください:

 * TracStandalone スタンドアロンサーバ `tracd` を使用している場合
 * TracCgi CGI または FastCGI を使用している場合
 * TracModPython mod_python を使用している場合

== Trac を使う ==

一度、 Trac のサイトを構築して起動したら、 Subversion のリポジトリをブラウズしたり、チケットを登録したり、タイムラインを見たりすることができます。

デフォルトの設定では、 anonymous ユーザ (ログインしていないユーザ) でも大半の機能を使用できますが、全てではありません。認証を設定し、認証済みのユーザがすべての機能を利用できるように [wiki:TracPermissions 権限] を追加するのを忘れないで下さい。

''それでは楽しんで!''

[http://projects.edgewall.com/trac/wiki/TracTeam The Trac Team]

----
See also:  TracGuide, TracCgi, TracFastCgi, TracModPython, TracUpgrade, TracPermissions