Context Navigation

Changes between Version 1 and Version 2 of TracInstall

Timestamp:: Aug 13, 2014, 12:08:17 AM (10 years ago)
Author:: trac
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

TracInstall

-              v1
+              v2
 = Trac インストールガイド 0.11 = #TracInstallationGuidefor0.11
+= Trac Installation Guide for 1.0 =
 [[TracGuideToc]]
 Trac は Python で書かれており、データベースとして [http://sqlite.org/ SQLite], [http://postgresql.org/ PostgreSQL], [http://mysql.com/ MySQL] のどれかが必要です。 Trac は HTML レンダリングのために [http://genshi.edgewall.org Genshi] テンプレートシステムを使用します。
+Trac のインストールとセットアップに対する一般的な手順を以下に示します。 Trac を特定のシステムにインストールする手順は Trac Project サイトの [http://trac.edgewall.org/wiki/TracInstallPlatforms TracInstallPlatforms] にありますが、 '''まず最初に以下の一般的な手順を読み通して''' タスクの関係を確実に理解してください。
+すでにインストールした Trac をアップグレードする手順は TracUpgrade を参照してください。
+== リリース済みバージョンの簡単なインストール方法 == #QuickInstallaReleasedVersion
+簡単にインストールするには、まず、 [http://python.org/download Python] (2.3-2.6) と [http://peak.telecommunity.com/DevCenter/EasyInstall#installing-easy-install easy_install] をインストールしておいてください。
+その状態で次のコマンドを実行します (''存在しなければ 'sudo' は外してください'')
+{{{
+sudo easy_install Trac
+}}}
+Trac, SQLite, Genshi などがまとめてインストールされます。
+== インストール条件 == #Requirements
+Trac を動作させるためのハードウェア要件は、当然のことながらデータ (Wiki ページ, チケット, リビジョンの数) のボリュームやトラフィックに強く依存します。とても小さなプロジェクトであれば、 500MHz のプロセッサ一つに 128MB の RAM でも SQLite を使って充分動作させられます。高速なハードディスクであればさらに動作が快適になるでしょう。
+バージョン 0.12 以降、 Trac はローカライズされているため、自分が普段使っている言語に翻訳されているかもしれません。 Trac のインタフェースで別の言語を使用したい場合は、任意のパッケージである [#OtherPythonPackages Babel] をインストールする必要があります。[#InstallingTrac Installing Trac] セクションのローカライゼーションのサポートの手順を参照してください。 Babel がない場合、通常通り、デフォルトの英語バージョンのみ使用することができます。
+新しい言語での翻訳の作成や、すでにある言語での翻訳のエンハンスをコントリビュートした場合は [[trac:TracL10N]] を見てみてください。 (訳注: 日本語の翻訳はすでにコントリビュートされています)
+Trac のインストールとセットアップに対する一般的な手順と必要な条件を以下に示します。 Trac を特定のシステムにインストールする手順は Trac Project サイトの [trac:TracInstallPlatforms TracInstallPlatforms] にありますが、 '''まず最初に以下の一般的な手順を読み通して''' タスクの関係を確実に理解してください。
+[[PageOutline(2-3,インストール手順,inline)]]
+== 依存関係 == #Dependencies
+=== 必須の依存関係 === #MandatoryDependencies
 Trac をインストールするためには以下のソフトウェアパッケージがインストールされていなければなりません:
  * [http://www.python.org/ Python] 2.3 以上 (3.0 以降は未対応)
    * XML 関連が組み込まれた mod_python を使用する場合、 python-2.5 を使用してください。 expat モジュールがネームスペース化されているので、 apache のクラッシュが引き起こされることがなくなります。 (詳細は [http://www.dscpl.com.au/wiki/ModPython/Articles/ExpatCausingApacheCrash ここ] を参照してください) 。
    * RPM ベースのシステムでは、 `python-devel` と `python-xml` パッケージが必要になるかもしれません。
    * 注意事項を参照してください。 [http://trac.edgewall.org/wiki/TracOnWindows/Python2.5 "TracOnWindows/Python2.5"]
+ * [http://trac.edgewall.org/wiki/setuptools setuptools] 0.6 以上
+ * [http://genshi.edgewall.org/wiki/Download Genshi] 0.5 以上 (バージョン 0.4.1 以上という記述は 0.11 のリリース候補以前の場合でした)
  * データベースシステムと対応する Python ドライバが必要です。
+   データベースは SQLite, PostgreSQL, MySQL のどれかが使えます。
+ * プラグインが必要とする場合は [http://www.clearsilver.net/ ClearSilver] が必要です。
+==== SQLiteの場合 ==== #ForSQLite
 Python 2.5 か 2.6 の場合は、必要なライブラリは同梱されています。
+Python 2.3, 2.4 の場合、 pysqlite が必要です。 pysqlite は
+[http://code.google.com/p/pysqlite/downloads/list google code] から Windows
+インストーラやソースからのビルド用の tar.gz アーカイブがダウンロードできます:
+{{{
 $ tar xvfz <version>.tar.gz
+$ cd <version>
+$ python setup.py build_static install
+}}}
 最新の SQLite のバージョンをダウンロードし、バインディングをビルドできます。
+That way, the latest SQLite version will be downloaded and built into the
+bindings.
+SQLite 2.x をまだ使っているのであれば、 pysqlite 1.0.x が必要ですが、この
+パッケージはそう簡単には見つかりません。 SQLite 3.x の場合は pysqlite 2.x
 を使用してください。 pysqlite 1.1.x は、もう古くなっています。
+詳しくは [http://trac.edgewall.org/wiki/PySqlite PySqlite] を参照してください。
+==== PostgreSQLの場合 ==== #ForPostgreSQL
  * [http://www.postgresql.org/ PostgreSQL]
+ * [http://initd.org/projects/psycopg2 psycopg2]
+ * See [http://trac.edgewall.org/wiki/DatabaseBackend#Postgresql DatabaseBackend]
+'''Warning''': PostgreSQL 8.3 は厳密な型チェックメカニズムを採用しています。 Trac で PostgreSQL の バージョン 8.3 を使用するには、 [http://trac.edgewall.org/changeset/6512 trac-0.11] 以降でなければなりません。
+==== MySQLの場合 ==== #ForMySQL
+ * [http://mysql.com/ MySQL] 4.1 以上 ([http://askmonty.org/wiki/index.php/MariaDB MariaDB] might work as well)
  * [http://sf.net/projects/mysql-python MySQLdb] 1.2.1 以上
+詳しくは [http://trac.edgewall.org/wiki/MySqlDb MySqlDb] を参照してください。
 データベースを作成する前に、このページを注意深く読んでください。 ''とても'' 重要なことが記載されています。
 == 非必須の条件 == #OptionalRequirements
+ * [http://www.python.org/ Python], 2.5 以上 3.0 未満
+   (Python 2.4 のサポートは、このリリース（訳注: 1.0）で打ち切られました)
+ * [http://peak.telecommunity.com/DevCenter/setuptools setuptools], 0.6 以上, [http://pypi.python.org/pypi/distribute ディストリビュート] を使用してもかまいません
+ * [http://genshi.edgewall.org/wiki/Download Genshi], 0.6 以上(リリースはされていませんが 0.7dev でも正しく動作します)
+また、データベースと、それに対応する Python のバインディングが必要です。
+データベースは SQLite, PostgreSQL, MySQL のいずれかが使用できます。
+==== SQLite の場合 ==== #ForSQLite
+Python 2.5 、 2.6 、 2.7 には、SQLite データベースのライブラリがPython の標準ディストリビューションに( `sqlite3` モジュールとして)同梱されています。
+もちろん、最新の [[trac:Pysqlite]] をダウンロードすることも可能です。
+[http://code.google.com/p/pysqlite/downloads/list google code] から Windows インストーラやソースからビルドするための
+tar.gz アーカイブがダウンロードできます。
+{{{
+$ tar xvfz <version>.tar.gz
+$ cd <version>
+$ python setup.py build_static install
+}}}
+上記の手順で最新の SQLite コードがダウンロードされバインディングがビルドされます。
+SQLite 2.x のサポートは終了しました。
+既知のバグとして、 PySqlite バージョン 2.5.2-4 では、 Trac のデータベースを
+.11.x から 0.12. にアップグレードすることができません。 2.5.5 以降か 2.5.1 と
+それ以前のバージョンを使用して下さい。詳細については、 [trac:#9434 本家チケット 9434] を参照して下さい。
+[trac:PySqlite PySqlite] にさらに情報があります。
+==== PostgreSQL の場合 #ForPostgreSQL
+下記いずれかの データベースと、データベースに対応した Python バインディングをインストールする必要があります:
+ * [http://www.postgresql.org/ PostgreSQL], バージョン 8.0 以降
+ * [http://pypi.python.org/pypi/psycopg2 psycopg2]
+詳しくは [trac:DatabaseBackend#Postgresql DatabaseBackend] を参照してください。
+==== MySQL の場合 ==== #ForMySQL
+Trac は以下のガイドラインで、 MySQL でも良好に動作するようになりました。
+ * [http://mysql.com/ MySQL], 5.0 以降
+ * [http://sf.net/projects/mysql-python MySQLdb], 1.2.2 以降
+'''非常に''' 重要なことが記載されているので、データベースを作成する前に、[trac:MySqlDb] のページを注意深く読んで下さい。
+=== 任意の依存関係 === #OptionalDependencies
 ==== バージョン管理システム ==== #VersionControlSystem
+'''Please note:''' Subversion を使用するなら Trac を同じマシンにインストールする必要があります。リモートリポジトリは現在サポートされていません。 (Windows では {{{\\machine_name\path\to\svn}}} のような UNC パスは動作します)。
+ * [http://subversion.tigris.org/ Subversion] 1.0 以上 (1.2.4, 1.3.2, 1.4.2 のいずれかが推奨されます) と '''''対応する''''' Python バインディングに対応しています。トラブルシューティングには [http://trac.edgewall.org/wiki///trac.edgewall.org/wiki/TracSubversion TracSubversion] を参照してください。
+   * Trac は Subversion のディストリビューションに含まれる [http://svnbook.red-bean.com/svnbook-1.1/ch08s02.html#svn-ch-8-sect-2.3 SWIG] バインディングを使用します。 [http://pysvn.tigris.org/ PySVN] では '''ありません''' (PySVN は時々、標準の SWIG バインディングと混同されることがあります)。
+   * SWIG バインディングを含まない Subversion が既にインストールされている場合、 Unix であれば `make swig-py` と `make install-swig-py` による Subversion の再構成が必要です。
+   * Win32 の場合、 [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 pre-compiled bindings] から取得してください。
+ * サードパーティから他のバージョン管理システムのサポートが提供されています。 [http://trac.edgewal.org/wiki/PluginList PluginList] と [http://trac.edgewall.org/wiki/VersioningSystemBackend VersioningSystemBackend] を参照してください。
+===== Subversion =====
+ * [http://subversion.apache.org/ Subversion] 1.5.x または 1.6.x と '''''対応する''''' Python バインディング。1.0 から 1.2.4 や 1.3.2 、 1.4.2 などの古いバージョンも今のところ動作します。トラブルシューティングの情報が [trac:TracSubversion#Troubleshooting TracSubversion] のページに記載されていますので、確認してください
+様々なプラットフォーム向けに [http://subversion.apache.org/packages.html SWIG バインディング] が用意されています。(このリストから Windows パッケージ用のコンパイル済みの SWIG バインディングを探してください。TracSubversion には [http://alagazam.net Algazam] がよいです。私も python 2.6 の基、使用しています。)
+Note: Trac は [http://pysvn.tigris.org/ PySVN] のような新しい `ctype` 形式のバインディングでは '''動作しません'''。
+'''重要な Note:''' Subversion を使用するなら Trac を '''同じマシン''' にインストールする必要があります。リモートリポジトリは現在 [trac:#493 サポートされていません]。
+===== その他のバージョン管理システム ===== #Others
+Subversion 以外のバージョン管理システムのサポートはサードパーティから提供されます。 [trac:PluginList] や [trac:VersionControlSystem] を参照して下さい。
 ==== Web サーバ ==== #WebServer
+ * CGI が利用可能な Web サーバ (TracCgi を参照してください) または
+ * [http://www.fastcgi.com/ FastCGI] が利用可能な Web サーバ (TracFastCgi を参照してください) または
+ * [http://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP] 互換の Web サーバ ([http://trac.edgewall.org/wiki/TracOnWindowsIisAjp TracOnWindowsIisAjp] を参照してください) または
+ * [http://httpd.apache.org/ Apache] と [http://code.google.com/p/modwsgi/ mod_wsgi] ([wiki:TracModWSGI] や http://code.google.com/p/modwsgi/wiki/IntegrationWithTrac を参照してください) または
+    * mod_wsgi は非常に新しく、いくらか実験的ですが、これは Apache 1.3, 2.0 または 2.2 で動作するはずで、 mod_python を使用するよりも良いパフォーマンスが出るはずです。
+ * [http://httpd.apache.org/ Apache] と [http://www.modpython.org/ mod_python 3.1.3 以降] (TracModPython を参照してください)
+    * mod_python をインストールするときは、開発向けの Python と Apache が必須になります (実際にはライブラリとヘッダファイル) 。
+Trac を Apache と [http://www.modpython.org/ mod_python 2.7] で動かすことも可能です。([http://trac.edgewall.org/wiki/TracModPython2.7 TracModPython2.7] を参照してください) 。このガイドは 0.8.4 以降更新されていないので動作が異なるかもしれません。
+==== その他の Python ユーティリティ ==== #OtherPythonUtilities
+ * WikiRestructuredText は [http://docutils.sourceforge.net/ docutils] 0.3.9 以降が必要です。
+ * '''シンタックスハイライト''' を行うには [http://pygments.pocoo.org Pygments] が必要です。 [http://silvercity.sourceforge.net/ SilverCity] の 0.9.7 以降や、 [http://gnu.org/software/enscript/enscript.html GNU Enscript] なども併せて使用することができます。詳細は TracSyntaxColoring を参照してください。
+ * [http://pytz.sf.net pytz] からタイムゾーンの完全なリストを取得します。 pytz を使用しなければ Trac は内部実装された短いリストを使用します。
+'''Attention''': これらの依存関係は様々なバージョンで必ずしも置き換えできるとは限らないので、上記のバージョン番号に注意してください。 Trac を動かす上で問題が発生した場合は [http://trac.edgewall.org/wiki/MailingList メーリングリスト] や [http://trac.edgewall.org/wiki/IrcChannel IRC チャネル] で質問をする前にすべての依存関係を再度確認してください。
+これらのパッケージのドキュメンテーションを参照して、それらが最も上手にインストールできる方法を探してください。また [http://trac.edgewall.org/wiki/TracInstallPlatforms プラットフォーム特有の説明] の多くに、これらの依存関係のインストール方法が記述されています。しかしながら [http://trac.edgewall.org/wiki/TracInstallPlatforms プラットフォーム特有の説明] の情報はあなたがインストールしている Trac より古い バージョンについての説明があることを覚えておいてください (なんと Trac 0.8 に関する説明をしているページもあります)。
+== Tracのインストール == #InstallingTrac
+Trac をインストールする 1 つの方法は `setuptools` を使用することです。
+setuptools は subversion のリポジトリから Trac をインストールすることができます;
+.11 のリリースバージョンをインストールするための例を以下に示します:
+{{{
+easy_install http://svn.edgewall.org/repos/trac/tags/trac-0.11
+}}}
+もちろん、ソースディレクトリのトップでの典型的な python セットアップもできます:
+Trac にはサーバ機能が組み込まれているので、 Web サーバは必須ではありません。このページに下にある [#RunningtheStandaloneServer スタンドアロンサーバの起動] セクションを参照してください。
+Trac は下記の環境において動作します。
+ * [http://httpd.apache.org/ Apache] との組み合わせで
+   - [http://code.google.com/p/modwsgi/ mod_wsgi], [wiki:TracModWSGI] と
+    http://code.google.com/p/modwsgi/wiki/IntegrationWithTrac を参照
+   - [http://modpython.org/ mod_python 3.3.1], 非奨励 (TracModPython 参照)
+ * [http://www.fastcgi.com/ FastCGI] 対応 Web サーバ (TracFastCgi 参照)
+ * [http://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP] 対応 Web
+   サーバ ([trac:TracOnWindowsIisAjp TracOnWindowsIisAjp] 参照)
+ * CGI 対応 Web サーバ (TracCgi 参照)。’’’Trac を CGI スクリプトとして使用することは
+   全く推奨されていませんので’’’ 、上記に挙げた方法を選択して下さい
+==== その他の Python パッケージ ==== #OtherPythonPackages
+ * [http://babel.edgewall.org Babel], 0.9.5 以上
+   ローカライズの機能を使用する場合は必要(リリースはされていませんが 1.0dev でも正しく動作します)
+ * [http://docutils.sourceforge.net/ docutils], 0.3.9 以上
+   WikiRestructuredText の機能を使用する場合は必要
+ * [http://pygments.pocoo.org Pygments]
+   [wiki:TracSyntaxColoring シンタックスハイライティング] の機能を使用する場合は必要
+   [http://silvercity.sourceforge.net/ SilverCity] や
+   [http://gnu.org/software/enscript/enscript.html Enscript] も、今のところ使用できますが、
+   サポートを打ち切る予定なので、 Pygments を使用してください
+ * [http://pytz.sf.net pytz] , タイムゾーンの完全なリストを取得する場合に必要
+   pytz がない場合、 Trac は内部で定義している
+   短いタイムゾーンの実装にフォールバックします
+'''Attention''': これらの依存関係は様々なバージョンで必ずしも置き換えできるとは限らないので、上記のバージョン番号に注意してください。 Trac を動かす上で問題が発生した場合は [trac:MailingList メーリングリスト] や [trac:IrcChannel IRC チャネル] で質問をする前にすべての依存関係を再度確認してください。
+これらのパッケージのドキュメンテーションを参照して、それらが最も上手にインストールできる方法を探してください。また [trac:TracInstallPlatforms プラットフォーム特有の説明] の多くに、これらの依存関係のインストール方法が記述されています。しかしながら [trac:TracInstallPlatforms プラットフォーム特有の説明] の情報はあなたがインストールしている Trac より古い バージョンについての説明があることを覚えておいてください (なんと Trac 0.8 に関する説明をしているページもあります)。
+== Trac のインストール == #InstallingTrac
+=== `easy_install` を使用したインストール ===#Usingeasy_install
+Trac をインストールする方法のひとつに [http://pypi.python.org/pypi/setuptools setuptools] の利用があります。
+setuptools を使用すると、 Trac を Subversion リポジトリからインストールすることもできます。
+例:
+ - Trac 1.0 をインストールします:
+   {{{
+   easy_install Trac==1.0
+   }}}
+   (まだ有効になっていない場合)
+ - 開発中の最新バージョン 1.0dev をインストールします:
+   {{{
+   easy_install Trac==dev
+   }}}
+   この場合、ローカライズに対応していないバージョンである可能性があります。
+   リリースされているバージョンを使用するか、ソースからインストールするようにしてください
+=== `pip` を使用したインストール === #Usingpip
+'pip' は easy_install のリプレースであり、とても簡単に素早く Python パッケージをインストールすることができます。
+Trac を 5 分程度でインストール、起動できます:
+pip によってインストールされる場所を `/opt/user/trac` とした場合の例です:
+ -
+{{{
+pip -E /opt/user/trac install trac psycopg2
+}}}
+または
+ -
+{{{
+pip -E /opt/user/trac install trac mysql-python
+}}}
+PostgreSQL (libpq-dev) や MySQL (libmysqlclient-dev) へのバインディングも自動でビルドできるように、 pip が OS 固有のヘッダファイルを確実に利用できるようにして下さい。
+また pip は (Genshi, Pygments などの) 依存関係を解決し、 pypi.python.org から最新のパッケージをダウンロードして、 `/opt/user/trac` の配下にインストールするところまで自動化されています。
+すべてのコマンド (`tracd`, `trac-admin`) は `/opt/user/trac/bin` の配下にインストールされます。 `mod_python` (`PythonHandler` ディレクティブを使用する場合) や `mod_wsgi` (`WSGIDaemonProcess` ディレクティブを使用する場合) においても活用することができます。
+加えて、 Trac プラグインのうちのいくつか ([http://pypi.python.org/pypi?:action=search&term=trac&submit=search ここ] で一覧を見ることができます) も pip からインストールすることが可能です。
+=== ソースからのインストール === #Fromsource
+もちろん、ソースディレクトリのトップに格納されている setup.py を使用してインストールすることもできます。
+(Trac-1.0.tar.gz など)リリースパッケージの .tar.gz や　.zip ファイル、または直接リポジトリからソースを取得することが出来ます(詳細は Trac:SubversionRepository を参照してください)。
 {{{
 $ python ./setup.py install
 }}}
+''Note: このステップを実行するためには root 権限 (または root 権限と同等の権限) が必要です。''
+``このステップを実行するためには root 権限 (または root 権限と同等の権限) が必要です。``
 この操作で Python のソースコードがバイトコンパイルされ、 .egg ファイルかディレクトリが Python インストールの `site-packages` ディレクトリにインストールされます。
 .egg には htdocs や templates のような、ソースファイル以外に標準インストールの Trac が必要とするすべてのリソースが含まれています。
+.egg には htdocs や templates のようなソースファイル以外に標準の Trac が必要とするすべてのリソースが含まれています。
 このスクリプトは [wiki:TracStandalone tracd] スタンドアロンサーバと一緒に、 [wiki:TracEnvironment プロジェクト Environment] を作成し維持するための [wiki:TracAdmin trac-admin] コマンドラインツールをインストールします。
+==== 高度なオプション ==== #AdvancedOptions
+ソースからインストールする場合や、新しい言語で Trac を国際化するためには Babel をインストールしておく必要があります。この場合も `install` を実行するだけです (Babel がインストールされていない状態で、すでに Trac をインストールしてしまった場合でも、 `install` をやり直すことで Babel サポートを有効化できます):
+{{{
+$ python ./setup.py install
+}}}
+また、 `bdist_egg` を実行すると dist ディレクトリに作成される .egg ファイルをインストール先にコピーしたり、 (`bdist_wininst` の実行によって) Windows インストーラを作成しても構いません。
+=== 高度なオプション === #AdvancedOptions
 Trac のインストール場所を変えるなどの高度なインストールオプションを知りたければ以下を実行してください:
 …
 easy_install --prefix=/usr/local --install-dir=/Library/Python/2.5/site-packages
 }}}
+Note: Mac OS X 10.6 上で {{{ easy_install http://svn.edgewall.org/repos/trac/trunk }}} を使用する場合は、オプションを指定しなくても {{{ /usr/local }}} および {{{ /Library/Python/2.6/site-packages }}} にインストールされます。
 上記の例は、 `tracd` と `trac-admin` コマンドを `/usr/local/bin` に、 Trac のライブラリと依存ファイルを `/Library/Python/2.5/site-packages` にインストールします。これらのパスは Apple での Pyhton サードパーティアプリケーションの標準ロケーションです。(訳注: つまり、上記と違うパスにインストールしたい場合のみ、オプションの指定が必要になります)
 == プロジェクト Environment の作成 == #CreatingaProjectEnvironment
 [wiki:TracEnvironment Trac Environment] は Trac が Wiki ページ、チケット、レポート、設定などの情報を保存するバックエンドストレージです。基本的に人間が読み込み可能な構成ファイルと他の様々なファイルやディレクトリで構成されます。
 新しい環境は [wiki:TracAdmin trac-admin] を使用して作成します:
+[TracEnvironment Trac Environment] は Trac が Wiki ページ、チケット、レポート、設定などの情報を保存するバックエンドストレージです。基本的に人間が読み込み可能な [TracIni 構成ファイル] と他の様々なファイルやディレクトリで構成されます。
+新しい Environment は [wiki:TracAdmin trac-admin] を使用して作成します:
 {{{
 $ trac-admin /path/to/myproject initenv
 }}}
+[wiki:TracAdmin trac-admin] はプロジェクト名、 [wiki:TracEnvironment#SourceCodeRepository ソースコードのリポジトリ] のタイプとパス、 [wiki:TracEnvironment#DatabaseConnectionStrings データベース接続文字列] など、 Environment を作成するのに必要な情報の入力を促します。これらのオプションを指定せず、空白を入力するとデフォルト値が使用されます。 SQLite がインストールされている場合、データベース接続文字列はいつでもデフォルト値で動作します。バージョン管理システムのリポジトリへのパスを指定しない場合、バージョン管理に関するすべての機能が無効化されますが、基本システムが動いていればいつでもバージョン管理に関する機能を追加することができます。
+また、 ここで指定した値は [wiki:TracIni] 設定ファイルを直接編集することで後から変更できることに留意してください。
+''Note: Web サーバのユーザアカウントは Environment のディレクトリと、その中のすべてのファイルに対する書き込み権限が必要です。 Linux では、 Web サーバが apache というユーザ、 apache というグループで起動している場合は以下のように入力してください。:''
+  chown -R apache.apache /path/to/myproject
+== スタンドアロンサーバの起動 == #RunningtheStandaloneServer
+[TracAdmin trac-admin] は、プロジェクトの名前や [TracEnvironment#DatabaseConnectionStrings データベース接続文字列] など、 Environment を新規作成するために必要な情報を入力するためのプロンプトを表示します。これらの設定項目について特に変更が必要ない場合は、単に `<Enter>` を押下すると、デフォルト値が使用されます。
+データベース接続文字列のデフォルトは SQLite が使用されます。 SQLite がインストールされている場合は、他の設定は不要です。
+他の [trac:DatabaseBackend データベースバックエンド] を使用する場合は、あらかじめデータベースが使用可能な状態にしておかねばなりません。
+.12 以降で Trac は、新しい Environment の作成時に [TracEnvironment#SourceCodeRepository ソースコードリポジトリ] を尋ねないようになりました。リポジトリを後で [TracRepositoryAdmin 追加する] までの間、バージョン管理のサポートは無効化されます。
+また、 ここで指定した値は [TracIni conf/trac.ini] 設定ファイルを直接編集することで後から変更できます。
+最後に、 Web のフロントエンドを実行しているユーザアカウントは、 Environment のディレクトリと、その中のすべてのファイルに対する書き込み権限が必要です。 `trac-admin ... initenv` の実行を該当するユーザで実行した場合は、この作業は不要ですが、そうでない場合、ただしユーザに権限を付与する作業が必要になります。たとえば Linux で `apache` ユーザ `apache` グループで Web サーバを起動する場合は:
+{{{
+# chown -R apache.apache /path/to/myproject
+}}}
+{{{#!div class=important
+'''Warning:''' アカウント名とプロジェクトパスには ASCII 文字のみを使用して下さい。 unicode 文字はサポートしていません。
+}}}
+== Trac の利用 == #DeployingTrac
+=== スタンドアロンサーバの起動 === #RunningtheStandaloneServer
 Trac 環境を作成した後に、スタンドアロンサーバ [wiki:TracStandalone tracd] を実行することで簡単に Web インタフェースを試すことができます。
 …
 }}}
 ブラウザを起動して、 `http://localhost:8000/` にアクセスしてください。 tracd が認識しているすべての Environment の簡単な一覧が表示されます。作成した Environment へのリンクにアクセスすることで Trac が動作中であることを確認できます。 Trac でプロジェクトをひとつだけ管理したい場合、以下のように起動することで、スタンドアロンサーバは Environment 一覧の表示をスキップして、直接 Environment を表示します:
+ブラウザを起動して、 `http://localhost:8000/` にアクセスしてください。 `tracd` が認識しているすべての Environment の簡単な一覧が表示されます。作成した Environment へのリンクにアクセスすることで Trac が動作中であることを確認できます。 Trac でプロジェクトをひとつだけ管理したい場合、以下のように起動することで、スタンドアロンサーバは Environment 一覧の表示をスキップして、直接 Environment を表示します:
 {{{
 $ tracd -s --port 8000 /path/to/myproject
 }}}
+== Web サーバ上での Trac の起動 == #RunningTraconaWebServer
+Trac に "真の" Web サーバから接続するには 3 つの方法があります: [wiki:TracCgi CGI], [wiki:TracFastCgi FastCGI], [wiki:TracModPython mod_python] です。まともな性能を出すには FastCGI か mod_python のどちらかを使用することが推奨されます。
+また、新しいコードを実行することを恐れていないのであれば [wiki:TracModWSGI mod_wsgi] を実行してみることもできます。 mod_wsgi は mod_python 以上の性能を提供するはずですが、 mod_python に比べ充分テストされたわけではありません。
+Trac では [http://trac.edgewall.org/wiki/TracOnWindowsIisAjp AJP] も使用できます。これを使うと IIS とも接続することができます。
+==== Trac の cgi-bin ディレクトリを生成する ==== #GeneratingtheTraccgi-bindirectory
+Trac を FastCGI や mod_python (訳註: おそらく mod_wsgi の誤り) で正しく機能させるには、 trac.cgi ファイルが必要となります。このファイルは適切な Python コードをロードする実行可能ファイルです。このファイルは [wiki:TracAdmin trac-admin] コマンドの `deploy` オプションを使用することで生成できます。
+若干の「卵が先か鶏が先か」問題があります。 [wiki:TracAdmin trac-admin] コマンドが機能するためには Environment が必要なのですが、 deploy には既に存在するディレクトリは使用できません。これに起因して、 Environment は depoly するディレクトリのサブディレクトリを使用することができません。この制限を回避するには次のようにすます:
+=== Web サーバ上での Trac の起動 === #RunningTraconaWebServer
+Trac には "実際の" Web サーバへ接続するために、いくつかの選択肢があります:
+ - [wiki:TracFastCgi FastCGI]
+ - [wiki:TracModWSGI mod_wsgi]
+ - //[wiki:TracModPython mod_python] (mod_python は現在活発なメンテナンスが行われていないため、推奨されません)//
+ - //[wiki:TracCgi CGI] (最適なパフォーマンスに遠く及ばないため、使用すべきではありません)//
+Trac では [trac:TracOnWindowsIisAjp AJP] もサポートしており、IIS と接続したい場合に選択肢の一つとなるかもしれません。その他の選択肢もあります: [trac:TracNginxRecipe nginx], [http://projects.unbit.it/uwsgi/wiki/Example#Traconapacheinasub-uri uwsgi], [trac:TracOnWindowsIisIsapi Isapi-wsgi] 等。
+==== Trac の cgi-bin ディレクトリを生成する ==== #cgi-bin
+Trac を FastCGI などで正しく機能させるには、 FastCGI であれば `trac.fcgi` ファイル、 mod_wsgi であれば `trac.wsgi` ファイルが必要となります。これらのファイルは適切な Python コードをロードする Python スクリプトです。 [wiki:TracAdmin trac-admin] コマンドの `deploy` オプションを使用することで生成できます。
+若干の「卵が先か鶏が先か」問題があります。 [wiki:TracAdmin trac-admin] コマンドが機能するためには Environment が必要なのですが、 deploy には既に存在するディレクトリは使用できません。これに起因して、 Environment は depoly するディレクトリのサブディレクトリを使用することができません。この制限を回避するには次のようにします:
 {{{
 mkdir -p /usr/share/trac/projects/my-project
 …
 }}}
+==== 静的なリソースをマッピングする ==== #MappingStatcResources
+特に設定することなく Trac はスタイルシートや画像のような静的なリソースを扱うことができます。tracd は唯一基本的な動作環境ですが、 Web サーバがそれら静的リソースを直接供給するように設定することより、はるかに最適になります。(CGI でセットアップした場合、'''極めて望ましくない''' し、著しい性能悪化の原因となります)
+[http://httpd.apache.org/ Apache] のような Web サーバはリソースに対して "Alias" を設定することで仮想の URL を与え、サーバのファイルシステムのレイアウトとは異なる位置にマップすることができます。また、Trac自身によるこれらの要求に対する処理を避けて、直接ファイルシステム上のディレクトリへ静的リソースに対する要求をマッピングすることができます。
+静的なリソースに対する主要な URL パスとして `/chrome/common` と `/chrome/site` があります。プラグインを使用している場合、各々の静的リソースとして `/chrome/<plugin>` のようなパスが追加されていることがありますが、主要なパスに対して追加を行えるだけなので、 `/chrome` に対して `Alias` を設定しても、プラグインが提供する静的リソースに対してアクセスできる訳ではありません。(訳注: このような場合 `trac-admin` の `deploy` で作成された `htdocs` ディレクトリに対して `Alias` を使用してください)
+Note: ファイルシステムにおける静的なリソースを取得するためには、最初に [TracAdmin trac-admin] の ` <environment> deploy` コマンドを使用して、 Trac 関連のリソースを拡張する必要があります。
+[[TracAdminHelp(deploy)]]
+ターゲットの `<directory>` は、以下のように `htdocs` ディレクトリに含まれます:
+ - `site/` - Environment 内の `htdocs/` ディレクトリのコピーです
+ - `common/` - Trac 自身が持つ静的なリソース
+ - `<plugins>/` - Environment で使用可能なプラグインによって管理される個々のリソースディレクトリ
+===== 例: Apache と `ScriptAlias` ===== #ScriptAlias-example
+以下のような環境を仮定すると:
+{{{
+$ trac-admin /var/trac/env deploy /path/to/trac/htdocs/common
+}}}
+Apache の設定ファイル内において `ScriptAlias` や `WSGIScriptAlias` の記述(Trac アプリケーションへの他のすべてのリクエストに対するマップの記述) ''より上に'' 以下のブロックを追記します。 パスは環境に合わせ変更してください:
+{{{
+Alias /trac/chrome/common /path/to/trac/htdocs/common
+Alias /trac/chrome/site /path/to/trac/htdocs/site
+<Directory "/path/to/www/trac/htdocs">
+  Order allow,deny
+  Allow from all
+</Directory>
+}}}
+もし mod_python を使用している場合、この設定を追加した方が良いかもしれません(使用していない場合は、このエイリアスは無視されます):
+{{{
+<Location "/trac/chrome/common/">
+  SetHandler None
+</Location>
+}}}
+Note: `trac.*cgi` スクリプトを `/trac` にマップしている場合、 `/trac/chrome/common` を加えたパスに対するリクエストは、静的リソースで処理するように割り込みを加えます。
+同様に、静的なリソースを project の `htdocs` ディレクトリで使用している場合 (テーマの中で `/trac/chrome/site` を参照しているなど)、 これらのリソースを供給するよう Apache を設定することが出来ます。(再度、.*cgi スクリプトの `ScriptAlias` や `WSGIScriptAlias` ''より上に'' 以下のブロックを記述します。インストール状況に合わせて、ファイル名やロケーションは適宜変更してください):
+{{{
+Alias /trac/chrome/site /path/to/projectenv/htdocs
+<Directory "/path/to/projectenv/htdocs">
+  Order allow,deny
+  Allow from all
+</Directory>
+}}}
+一方で `/trac/chrome/common` をエイリアスとするような場合、 Trac では [wiki:TracIni#trac-section| [trac] htdocs_location] を設定することで、それらリソースに対して直接リンクを生成することができます:
+{{{
+[trac]
+htdocs_location = http://static.example.org/trac-common/
+}}}
+Note: これは 静的なリソースを供給する専用のドメインを簡単に設定します。([http://code.google.com/speed/page-speed/docs/request.html#ServeFromCookielessDomain cookie-less])
+当然、Web サーバのドキュメントルートにディレクトリをコピーする(又は、リンクする)等して、特定の URL で Web サーバに接続できるよう Trac の `htdocs/common` ディレクトリを作成する必要があります。
+{{{
+$ ln -s /path/to/trac/htdocs/common /var/www/static.example.org/trac-common
+}}}
 ==== プラグインキャッシュの設定 ==== #SettingupthePluginCache
 Python プラグインの中にはキャッシュディレクトリを必要とするものがあります。デフォルトではキャッシュディレクトリは、現在のユーザのホームディレクトリに置かれます。 Trac を Web サーバで動作させている場合、ホームディレクトリを持たない専用ユーザであることが多く (強く推奨します)、プラグインの起動が妨げられることがあります。キャッシュディレクトリの場所を変更するには、環境変数 PYTHON_EGG_CACHE を設定してください。設定方法の詳細は使用しているサーバのドキュメントから参照してください。
+Python プラグインの中にはキャッシュディレクトリを必要とするものがあります。デフォルトではキャッシュディレクトリは、現在のユーザのホームディレクトリに置かれます。 Trac を Web サーバで動作させている場合、ホームディレクトリを持たない専用ユーザであることが多く (強く推奨します)、プラグインの起動が妨げられることがあります。キャッシュディレクトリの場所を変更するには、環境変数 PYTHON_EGG_CACHE を設定してください。環境変数を設定する方法の詳細は使用しているサーバのドキュメントから参照してください。
 == 認証の構成 == #ConfiguringAuthentication
+認証のためのユーザアカウントを追加、削除、構成する方法は Trac を起動する方法により異なります。基本的な手順は TracCgi ページの [wiki:TracCgi#AddingAuthentication "認証を追加する"] セクションで説明されていますが、各フロントエンドのための認証をセットアップする方法は、以下のいずれかを参照してください:
+ * TracStandalone スタンドアロンサーバ `tracd` を使用する場合
+ * TracCgi CGI か FastCGI を使用する場合
+ * TracModPython mod_python を使用する場合
+== SVN のチェンジセットを Trac のチケットに自動リンクする方法 == #AutomaticreferencetotheSVNchangesetsinTractickets
+ファイルをリポジトリにコミットした時に、チェンジセットへのリンクをチケットのコメントに自動で追加するように SVN を設定することができます。コミットメッセージには以下に示すいずれかの書式が含まれていなければなりません:
+ * '''Refs !#123''' - このチェンジセットへのリンクをチケット !#123 に追加します
+ * '''Fixes !#123''' - このチェンジセットへのリンクをチケット !#123 に追加し、チケットを ''fixed'' でクローズします。
+SVN リポジトリの ''post-commit'' hook を編集し、 Trac 配布物に含まれる ''trac-post-commit-hook'' が実行されるようにしてください。
+''post-commit'' hook を編集するときは、まず SVN リポジトリ内の hooks フォルダに移動し、 ''post-commit'' 用のテンプレートファイルを rename してファイルを作成します:
+{{{
+$ cd /path/to/svn/repository/hooks
+$ mv post-commit.tmpl post-commit
+$ chmod 755 post-commit
+}}}
+続いて、ファイルをテキストエディタで開き、以下の行を追加します。パスは編集中の SVN リポジトリに接続している Trac environment のパス、および ''trac-post-commit-hook'' スクリプトのパスで置き換えてください:
+{{{
+REPOS="$1"
+REV="$2"
+TRAC_ENV="/path/to/your/trac/project"
+/usr/bin/python /usr/local/bin/trac-post-commit-hook -p "$TRAC_ENV" -r "$REV"
+}}}
+もちろん ''trac-post-commit-hook'' は上記のパスに存在し、 SVN を実行しているユーザの権限で実行できる必要があります。このスクリプトは Trac 配布物中では contrib フォルダに配置されています。最新のバージョンは [http://trac.edgewall.org/browser/trunk/contrib/trac-post-commit-hook trunk/contrib/trac-post-commit-hook] からダウンロードすることができます。
+== プラットフォーム固有のインストール方法 == #Platform-specificsinstallations
+ * [http://trac.edgewall.org/wiki/TracInstallPlatforms TracInstallPlatforms] を参照してください。
+== Tracを使用する == #UsingTrac
+一度 Trac サイトを稼働させれば、 Subversion のリポジトリをブラウズする、チケットを作成する、タイムラインを見るなどが可能になるはずです。
+anonymous (ログインしていない) でアクセスするユーザは、デフォルトでほとんどの機能を使用することができますが、すべての機能を使用できるわけではないことに留意してください。すべての機能を使用するためには認証を構成して、認証されたユーザに対し [wiki:TracPermissions アクセス許可] を与える必要があるでしょう。
+Trac は HTTP 認証を使用します。`.../login` の URL ("ログイン"(英語版では "login") ボタンの仮想パス) がリクエストされた際に、認証を要求するように Web サーバを設定する必要があります。Trac は認証情報を得た後自動的に REMOTE_USER 変数を獲得します。そのため、すべてのユーザの管理は Web サーバ の設定で行います。設定方法等の詳細な情報は、利用している Web サーバのドキュメントを参照してください。
+認証のためのユーザアカウントを追加、削除、設定する方法は Trac を起動する方法により異なります。
+以下に記すセクションを適宜参照してください:
+ * スタンドアロンサーバ `tracd` を使用する場合は TracStandalone#UsingAuthentication
+ * Apache Web サーバ と `mod_wsgi` に代表される `mod_python` や `mod_fcgi`, `mod_fastcgi` といったフロントエンドを使用する場合は [wiki:TracModWSGI#ConfiguringAuthentication TracModWSGI#ConfiguringAuthentication]
+ * Apache 以外の FCGI をサポートしている Web サーバ (Cherokee, Lighttpd, !LiteSpeed, nginx) を使用する場合 TracFastCgi
+== admin ユーザへの管理者権限の付与 == #Grantingadminrightstotheadminuser
+admin ユーザに管理者権限を付与します:
+{{{
+$ trac-admin /path/to/myproject permission add admin TRAC_ADMIN
+}}}
+このユーザは Trac プロジェクトに管理者としてアクセスするため、メニュー内に "管理"(英語版では "Admin") が表示されます。
+== インストールを終えて == #Finishingtheinstall
+=== SVN のチェンジセットを Trac のチケットに自動リンクする方法 === #AutomaticreferencetotheSVNchangesetsinTractickets
+変更をリポジトリにコミットした時に、チェンジセットへのリンクをチケットのコメントに自動で追加するように SVN を設定することができます。コミットメッセージには以下に示すいずれかの書式が含まれていなければなりません:
+ * '''`Refs #123`''' - このチェンジセットへのリンクをチケット `#123` に追加します
+ * '''`Fixes #123`''' - このチェンジセットへのリンクをチケット `#123` に追加し、チケットを ''fixed'' でクローズします
+この機能を使用するためには post-commit フックを [wiki:TracRepositoryAdmin#ExplicitSync TracRepositoryAdmin] に記載したリポジトリにインストールし、  commit updater コンポーネントを有効にせねばなりません。コンポーネントの有効化は、 [wiki:TracIni#components-section trac.ini] ファイルの `[components]` セクションに下記記述を追加するか、 "プラグイン" (英語版では "Plugins") 管理パネルから設定します。
+{{{
+tracopt.ticket.commit_updater.* = enabled
+}}}
+詳細な情報は "プラグイン" 管理パネルの `CommitTicketUpdater` コンポーネントにあるドキュメントを参照してください。
+=== Trac を使用する === #UsingTrac
+一度 Trac サイトを稼働させれば、チケットを作成したり、タイムラインを見たり、 (設定されていれば) バージョン管理のリポジトリを閲覧したりできるはずです。
+//anonymous// (ログインしていない) でアクセスするユーザは、デフォルトではほとんど機能を使用することができません。特に、リソースに対して読み取りのみのアクセスになります。すべての機能を使用できるわけではないことに留意してください。すべての機能を使用するためには認証を構成して、認証されたユーザに対し [wiki:TracPermissions アクセス許可] を与える必要があります。
 '' Enjoy! ''
 [http://trac.edgewall.org/wiki/TracTeam The Trac Team]
+[trac:TracTeam The Trac Team]
 ----
+See also:  [http://trac.edgewall.org/wiki/TracInstallPlatforms TracInstallPlatforms], TracGuide, TracCgi, TracFastCgi, TracModPython, [wiki:TracModWSGI], TracUpgrade, TracPermissions
+See also: [trac:TracInstallPlatforms TracInstallPlatforms], TracGuide, TracUpgrade, TracPermissions