Changes between Initial Version and Version 1 of TracEnvironment


Ignore:
Timestamp:
08/26/08 23:10:13 (11 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracEnvironment

    v1 v1  
     1= Trac Environment =
     2
     3Trac はプロジェクトのデータを保存するために、ディレクトリ構造とデータベースを使用します。このディレクトリを "Environment" と呼びます。
     4
     5== Environment の作成 ==
     6
     7新しい Trac Environment を作成するには、 [wiki:TracAdmin trac-admin] コマンドを使用します:
     8{{{
     9$ trac-admin /path/to/projectenv initenv
     10}}}
     11
     12[wiki:TracAdmin trac-admin] はあなたに、プロジェクトの名前、
     13データベースに接続するための文字列 (以下に説明します) 、
     14ソースコードリポジトリの種類とパスを尋ねてきます。
     15
     16''Note: Environment のディレクトリ配下は、 Web サーバの実行ユーザに書き込みパーミッションを
     17与える必要があります。適切なパーミッションの付与を忘れないようにしてください。
     18書き込みパーミッションの付与は、 Trac が最終的に使用している Subversion のリポジトリにも当てはまります。
     19ただし、あなたが Subversion リポジトリに Barkley DB のファイルシステムを使用していないならば、
     20Trac は読み取りパーミッションしか必要としません。''
     21
     22== データベースに接続するための文字列 ==
     23
     24バージョン 0.9 以降の Trac では [http://sqlite.org/ SQLite],
     25[http://www.postgresql.org/ PostgreSQL] と [http://mysql.com/ MySQL] をバックエンドのデータベースとして
     26利用可能になりました。通常では SQLite を使用します。たぶんほとんどのプロジェクトにとっては SQLite で十分です。
     27データベースファイルは Environment のディレクトリに保存されます。そして、
     28[wiki:TracBackup Trac のバックアップ] で Environment の残りの部分 (データベースファイル以外のファイル)
     29と一緒にバックアップすることができます。
     30
     31組み込みの SQLite データベースに接続するための文字列は以下の通りです:
     32{{{
     33sqlite:db/trac.db
     34}}}
     35
     36もしあなたが、 PostgreSQL や MySQL を代わりに使用する場合、
     37異なる接続用文字列を使用しなければなりません。 例えば、 PostgreSQL に接続するとき、
     38ユーザ名 `johndoe` でパスワード `letmein` で
     39ローカルホストの `trac` と呼ばれるデータベースに接続するには以下のように指定します:
     40{{{
     41postgres://johndoe:letmein@localhost/trac
     42}}}
     43
     44もし、 PostgreSQL がデフォルト以外のポート番号 (例えば、 9432) で起動しているときはこのようにします:
     45{{{
     46postgres://johndoe:letmein@localhost:9342/trac
     47}}}
     48
     49PostgreSQL を使用するとき、 `trac-admin initenv` を実行する前に
     50データベースを作成しなければいけません。
     51
     52PostgreSQL データベースの名前は "trac" にしてください。そのほうが都合がいいです:
     53また、 trac-user-name に大文字を使用すると動きません。
     54{{{
     55sudo su - postgres -c createdb trac
     56sudo su - postgres -c psql trac
     57CREATE USER trac-user-name WITH PASSWORD 'trac-pass-name';
     58}}}
     59
     60(sudo/su を設定していなければ、手動で createdb と psql を実行する必要があることに留意してください。このドキュメントを読んで最初そのことを理解するまで少し時間がかかりました。 (訳注: この一文は本家サイトの Wiki に寄せられた感想のようです))
     61
     62== ソースコードリポジトリ ==
     63
     64最初にリポジトリの ''type'' を指定しなければなりません。 (例 Subversion ならば `svn` 、
     65これがデフォルトです)、そしてリポジトリの ''path'' を指定しなければなりません。
     66
     67リポジトリなしで、 Trac を使用したいときは、単に ''path'' 部分に何も入力しないままにして下さい。
     68(その場合''type'' の情報は影響しません)
     69
     70リポジトリシステムによっては、リポジトリへのパスだけではなく、リポジトリ内の ''scope'' を設定
     71することもできます。 Trac はそのスコープ以下に限定したファイルとチェンジセット
     72に関連する情報を表示します。 Trac のバックエンドで  Subversion を 使う場合
     73このようなことが可能です; 他のリポジトリシステムについては、対応するプラグインのドキュメントで確認して下さい。
     74
     75Subversion リポジトリの設定の一例です:
     76{{{
     77[trac]
     78repository_type = svn
     79repository_dir = /path/to/your/repository
     80}}}
     81
     82スコープを絞った Subversion リポジトリの設定の一例です:
     83{{{
     84[trac]
     85repository_type = svn
     86repository_dir = /path/to/your/repository/scope/within/repos
     87}}}
     88
     89== ディレクトリ構造 ==
     90
     91一つのプロジェクトの Environment のディレクトリは通常以下に示すファイルとディレクトリから成り立ちます。
     92
     93 * `README` - Environment について記述したドキュメント。
     94 * `VERSION` - Environment のバージョン識別情報。
     95 * `attachments` - 全ての添付ファイルはここに保存されます。
     96 * `conf`
     97   * `trac.ini` - メインとなる設定ファイル。詳細は TracIni に記述しています。
     98 * `db`
     99   * `trac.db` - SQLite データベース (SQLite を使用しているならば)
     100 * `plugins` - Environment に固有の [wiki:TracPlugins プラグイン] (Python eggs)
     101 * `templates` - カスタム (プロジェクトに固有の) テンプレート
     102   * `site_css.cs` - カスタム CSS スタイルシート
     103   * `site_footer.cs` - カスタムフッタ
     104   * `site_header.cs` - カスタムヘッダ
     105 * `wiki-macros` - Environment に固有の [wiki:WikiMacros Wiki マクロ]
     106
     107  '''Note: Trac Environment のディレクトリとソースコードリポジトリのディレクトリを一緒にしないで下さい。
     108上記のディレクトリ構造は Subversion リポジトリのディレクトリ構造をざっくりと真似ているだけですが、
     1092つは同じ場所においては ''いけません'' 。'''
     110
     111----
     112See also: TracAdmin, TracBackup, TracIni, TracGuide