![(please configure the [header_logo] section in trac.ini)](/python/trac/mypz/chrome/common/trac_logo_mini.png){kind=logo}
Trac 設定ファイル
目次
Trac の設定は <projectenv>/conf/ にある trac.ini というファイルを編集して行います。変更した内容は通常、即座に反映されますが、 [components] セクションや [logging] セクションへの変更では Web サーバを再起動する必要があります。また、グローバルな設定ファイルを新しく作成した直後も Web サーバを再起動しなければなりません。
trac.ini 設定ファイルとそのファイルのあるディレクトリは Web サーバから書き込み可能でなければなりません。 Trac は現在のところ、キャッシュを破棄するために完全に Environment を再読み込みするトリガーとして利用しています。
グローバルな設定
0.11 より前のバージョンでは、グローバルな設定ファイルは $prefix/share/trac/conf/trac.ini や /etc/trac/trac.ini などディストリビューションに依存した特定の位置に配置されていました。アップグレードする場合は、設定を継承するファイルを明示しなければなりません。以前のバージョンから 0.11 にアップグレードした場合、プロジェクトの trac.ini ファイルに [inherit] セクションを追加しなければなりません。カスタマイズしたテンプレートや画像のファイルは $prefix/share/trac/... から他の場所に移動することもできます。
グローバルな設定は Environment 固有の設定とマージされます。ローカルの設定はグローバルの設定を上書きます。グローバルな設定ファイルは以下のように指定します:
[inherit] file = /path/to/global/trac.ini
カンマ区切りにすることで、複数のファイルを指定することができます。
Note: 新しいプロジェクトを作る時に trac-admin の initenv コマンドに --inherit=/path/to/global/trac.ini オプションを追加することで、グローバル設定ファイルを指定することができます。オプションを追加せずにプロジェクトを作成した場合でも、新しく作成された conf/trac.ini ファイルを編集して、グローバルファイルの設定で上書きしたいエントリを削除すれば、新しい Environment でグローバル設定ファイルを使用することができます。
[inherit] セクションには、共有するテンプレートの配置先を指す templates_dir と、共有するプラグインを指す plugins_dir という二つのエントリもあります。これらがグローバル設定ファイルに指定することができます。この場合、他の [inherit] file が指定されていれば、設定ファイルは順次読み込まれます。
TracEnvironment の templates/ ディレクトリ内のテンプレートは、 [inherit] templates_dir で見つかるテンプレートより優先されます。次に、[inherit] templates_dir のテンプレートはインストールされているテンプレートより優先されます。これらを設定するには注意が必要です。特に、デフォルトのテンプレートをオーバーライドする場合、 Trac を新しいバージョンにアップデートする際には必ず変更点を再読み込みして下さい。 ( TracInterfaceCustomization を行うために推奨する方法は、適切に ITemplateStreamFilter の変更が行えるカスタムプラグインを作成することです。)
リファレンス
現在利用できる設定項目のリファレンスとデフォルトの設定です。(訳注: 0.12 ではデフォルトの値は表示されません。)
[attachment]
| max_size | 添付ファイルの上限サイズを指定します (バイト単位) | 262144 |
| max_zip_size | .zip ダウンロードを許可する合計に対する上限サイズ (バイト単位) です。-1 を指定した場合は .zip でのダウンロード機能を無効にします。(1.0 以降) | 2097152 |
| render_unsafe_content | 添付ファイルをブラウザ上で表示するか、単にダウンロード可能にしておくかどうかを指定します。 ブラウザはほとんどのファイルを HTML として解釈するため、悪意のあるユーザにクロスサイトスクリプティング攻撃を行うファイルの作成を許すことになります。 匿名ユーザが添付ファイルを作成できるような公開サイトでは、このオプションを無効 (これがデフォルトです) のままにしておくことを推奨します。 | false |
[browser]
| color_scale | 時期列の色付けを行うかどうかを指定します。 これにはソースコードの注釈と同じカラースケールを使います。青が古く、赤が新しいものとなります。 (0.11 以降) | enabled |
| downloadable_paths | ダウンロードできるようにするリポジトリのパスをリストで指定します。 ダウンロードを無効にしたい場合は空にします。そうでない場合は、許可するパスをカンマ区切りで指定します (ワイルドカードとして "*" が使えます)。 マルチリポジトリ環境でパスがデフォルトのリポジトリを指していない場合には、そのパスはリポジトリ名付きで指定する必要があります (例えば /reponame/trunk)。 また、パスのプレフィックスマッチング処理はシンプルhもので、自動でエイリアスの解決は行わないことに注意してください。 (0.10 以降) | /trunk, /branches/*, /tags/* |
| hide_properties | リポジトリブラウザで非表示にするバージョン管理のプロパティをカンマ区切りで指定します。 (0.9 以降) | svk:merge |
| intermediate_color | カラースケールの2つの線形補間を行う場合の中間部分に対応する色を (r,g,b) で指定します (intermediate_point 参照)。指定しない場合は、oldest_color と newest_color の中間色を使います。 (0.11 以降) | (デフォルトなし) |
| intermediate_point | 0より大きく1未満の値を設定すると、カラースケールの補間処理で設定した位置で intermediate_color の色を使うようになります。 (0.11 以降) | (デフォルトなし) |
| newest_color | 最新のものに対応する色を (r,g,b) で指定します。color_scale が有効の場合に、注釈履歴やソースブラウザの時期列で使います。 (0.11 以降) | (255, 136, 136) |
| oldest_color | 最古のものに対応する色を (r,g,b) で指定します。color_scale が有効の場合に、注釈履歴やソースブラウザの時期列で使います。 (0.11 以降) | (136, 136, 255) |
| oneliner_properties | リポジトリブラウザで1行スタイルの Wiki として描画するバージョン管理のプロパティをカンマ区切りで指定します。 (0.11 以降) | trac:summary |
| render_unsafe_content | ファイルをそのままブラウザで表示するか、単にダウンロードになるようにするかどうかを指定します。 ブラウザはほとんどのファイルを HTML として解釈するため、悪意のあるユーザにクロスサイトスクリプティング攻撃を行うファイルの作成を許すことになります。 誰でもファイルをチェックインできる公開リポジトリでは、この設定を無効のままにすることを推奨します。(これがデフォルトです) | false |
| wiki_properties | リポジトリブラウザで Wiki として描画するバージョン管理のプロパティをカンマ区切りで指定します。 (0.11 以降) | trac:description |
[changeset]
| max_diff_bytes | チェンジセットページで差分をインラインで表示するファイルの合計の上限バイト数 (旧サイズと新サイズの和) を指定します。(0.10 以降) | 10000000 |
| max_diff_files | チェンジセットページで差分をインラインで表示するファイルの最大数を指定します。(0.10 以降) | 0 |
| wiki_format_messages | チェンジセットのメッセージに Wiki フォーマットを適用するかどうかを指定します。 この設定を無効にすると、チェンジセットのメッセージは pre フォーマットのテキストとして表示します。 | true |
[components]
このセクションは、プラグインが提供するコンポーネント、および、Trac 自身のコンポーネントを有効または無効にするのに使います。有効/無効にするコンポーネントは、オプションの名前で特定します。オプションの値で有効なのかどうかを決定します。値を enabled または on に設定するとそのコンポーネントは有効になります。その他の値 (通常は disabled または off) だとそのコンポーネントは無効になります。
オプション名は、コンポーネントの完全修飾名、または、コンポーネントに対するモジュール/パッケージのプレフィックスのどちらかです。前者は特定のコンポーネントを有効/無効にし、後者は特定のパッケージ/モジュールのコンポーネントを有効/無効にします。
次にあげる設定 (抜粋) を考えてみます。
[components] trac.ticket.report.ReportModule = disabled webadmin.* = enabled
1つ目のオプションは、レポートモジュールを無効にするように指定しています。 2つ目のオプションは、webadmin パッケージのすべてのコンポーネントを有効にするように指定しています。注意することは、末尾のワイルドカードはモジュール/パッケージにマッチさせるのに必要であることです。
アクティブなコンポーネントの一覧を参照するには、Trac についてのプラグインページにアクセスします (CONFIG_VIEW 権限が必要です)。
関連項目: TracPlugins
[header_logo]
| alt | ヘッダロゴ画像の代替テキストを指定します。 | (please configure the [header_logo] section in trac.ini) |
| height | ヘッダロゴ画像の高さをピクセル単位で指定します。 | -1 |
| link | ヘッダロゴからリンクする URL を指定します。 | (デフォルトなし) |
| src | ヘッダロゴに使う画像の URL を指定します。これには完全 URL、サーバ相対 URL、または、相対 URL が指定できます。 相対 URL の場合、/chrome URL 配下に対するものとなります。site/your-logo.png にすると、環境中にある htdocs フォルダにある your-logo.png を指します。common/your-logo.png にすると、htdocs_location URL に対応したフォルダにある your-logo.png を指します。単に your-logo.png を指定した場合は、後者と同じになります。 | site/your_project_logo.png |
| width | ヘッダロゴ画像の幅をピクセル単位で指定します。 | -1 |
[inherit]
| htdocs_dir | 共有する htdocs ディレクトリのパスを指定します。 このディレクトリの静的リソースを common と site URL に対して追加で、環境配下の URL である /chrome/shared にマッピングします。 複数の Trac 環境のインターフェイスに対して共通のカスタマイズを site.html で行うのに便利です。 (1.0 以降) | (デフォルトなし) |
| plugins_dir | 共有させるプラグインディレクトリへのパスを指定します。 このディレクトリのプラグインは、この環境にある plugins ディレクトリのものに加えて、優先してロードします。 (0.11 以降) | (デフォルトなし) |
| templates_dir | 共有するテンプレートディレクトリのパスを指定します。 このディレクトリのテンプレートを環境中の templates ディレクトリにあるテンプレートに加えてロードしますが、後者を優先して使用します。 (0.11 以降) | (デフォルトなし) |
[intertrac]
このセクションは InterTrac プレフィックスを設定します。名前に "." を含んでいる設定は、"." までの設定名に対する InterTrac プレフィックスを定義します。名前に "." を含んでいない設定はエイリアスを定義します。
.url は他の Trac の URL を示すのに必ず指定します。同じサーバにある Trac 環境を示すのに相対 URL にすることもできます。
.title 情報は InterTrac リンクの上にカーソルを持っていたときのツールチップを表示するのに使います。
.compat は互換モードを有効または無効にするのに使います。
- 対象の Trac が 0.10 以下のバージョン (正確には r3526) で動作している場合、InterTrac リンクを処理する方法を知らないのでローカルの Trac が正しいリンクを用意します。すべてのリンクが機能するとは限らないが、大抵は動作します。これを互換モードと呼んでいて false を設定します。これがデフォルトです。
- リモートの Trac が InterTrac リンクを処理する方法を知っている場合は、明示的にこの互換モードを無効にすることができ、そのときは any を設定して TracLinks を InterTrac リンクにすることができます。
設定例:
[intertrac] # -- エイリアスの設定例: t = trac # -- 外部 Trac へのリンク: trac.title = Edgewall's Trac for Trac trac.url = http://trac.edgewall.org
[interwiki]
[interwiki] セクションのオプションは、各々で InterWiki プレフィックスを定義します。オプションの名前はプレフィックスを定義し、値は URL と任意で説明を定義します。空白で区切った URL の続きが説明となります。パラメータ付きの URL をサポートしています。
例:
[interwiki] MeatBall = http://www.usemod.com/cgi-bin/mb.pl? PEP = http://www.python.org/peps/pep-$1.html Python Enhancement Proposal $1 tsvn = tsvn: TortoiseSvn に渡します
[logging]
| log_file | log_type が file の場合、ログファイルのパスを指定します。相対パスは、Trac 環境にある log ディレクトリから相対的に解釈します。 | trac.log |
| log_format | ログフォーマットを指定します。 何も設定しない場合は、以下のものを使用します。 Trac[$(module)s] $(levelname)s: $(message)s Python logging ライブラリ (http://docs.python.org/library/logging.html 参照) がサポートしている標準のキー名に加えて、使えるものがあります。
%(...)s の代わりに $(...)s を使っていることに注意してください。後者の形式は ConfigParser 自身が解釈を行います。 例: ($(thread)d) Trac[$(basename)s:$(module)s] $(levelname)s: $(message)s (0.10.5 以降) | (デフォルトなし) |
| log_level | ログレベルを指定します。 (CRITICAL, ERROR, WARN, INFO, DEBUG) のうちのどれかを指定します。 | DEBUG |
| log_type | ロギングに使用する出力先を指定します。 (none, file, stderr, syslog, winlog) のうちのどれかを指定します。 | none |
[milestone]
| stats_provider | ITicketGroupStatsProvider を実装しているコンポーネントの名前を指定します。 これはマイルストーンの表示でチケットのグループごとに集計を行うのに使います。 | DefaultTicketGroupStatsProvider |
[milestone-groups]
チケットのワークフローは現在設定できるようになっているため、たくさんのチケットステータスを用意できますが、単純にクローズしているチケットとそれ以外のチケットで表示することは大抵の場合で適切ではありません。このセクションでは、マイルストーンのプログレスバーで個々の配色で表示されるようにステータスのグループを作成することができます。
チケットのステータスでのみグループ化し、それ以外ではグループ化できないことに注意してください。特に、クローズしているチケットを解決方法で分類することはできません。
3つのグループ closed、new、active の設定例 (デフォルトでは closed と active のみです)
# 'closed' グループは 'closed' チケットに対応
closed = closed
# .order: プログレスバーでの順序
closed.order = 0
# .query_args: 対応するクエリの任意のパラメータです。
# この例では2つの列 ('作成' と '変更') を追加し
# '作成' でソートするようにデフォルトを変更しています。
closed.query_args = group=resolution,order=time,col=id,col=summary,col=owner,col=type,col=priority,col=component,col=severity,col=time,col=changetime
# .overall_completion: 完了として割合を計算するグループを示します
closed.overall_completion = true
new = new
new.order = 1
new.css_class = new
new.label = 新規
# ※ このグループは他のステータスをひとまとめにする
active = *
active.order = 2
# .css_class: この区間に対する CSS クラス
active.css_class = open
# .label: このグループに表示するラベル
active.label = in progress
この定義に含めるステータスをカンマ区切りで指定します。また、'*' は任意のステータスを意味し、残りのすべてのステータスを1つのグループに関連付けるのに使用することができます。
CSS クラスは new (黄色)、open (無色)、closed (緑色) のいずれかにできます。それ以外のスタイルはカスタム CSS ルールを使って簡単に追加できます。例えば table.progress td.<class> { background: <color> } を site/style.css ファイルに追加します。
(0.11 以降)
[mimeviewer]
| max_preview_size | HTML プレビューするファイルの上限サイズを指定します。(0.9 以降) | 262144 |
| mime_map | 追加する MIME タイプとキーワードのマッピングのリストを指定します。 マッピングはカンマ区切りで、MIME タイプごとに関連するキーワードまたはファイル拡張子のコロン区切り (":") のリストを持ちます。(0.10 以降) | text/x-dylan:dylan, text/x-idl:ice, text/x-ada:ads:adb |
| mime_map_patterns | 追加する MIME タイプとそれに対応させるファイルパターンを指定します。マッピングはカンマ区切りで、マッピングごとに MIME タイプとファイルマッチングに使う Python 正規表現をコロン (:) で区切るようにします。(1.0 以降) | text/plain:README|INSTALL|COPYING.* |
| tab_width | ファイルのプレビューで表示するタブの幅を指定します。(0.9 以降) | 8 |
| treat_as_binary | バイナリデータとして扱わせる MIME タイプをカンマ区切りで指定します。(0.11.5 以降) | application/octet-stream, application/pdf, application/postscript, application/msword, application/rtf |
[notification]
| admit_domains | メールアドレス (localdomain のような) として有効だと判定させたいドメイン名をカンマ区切りで指定します。 | (デフォルトなし) |
| always_notify_owner | 常にチケット担当者に通知を送信するかどうかを指定します。( 0.9 以降) | false |
| always_notify_reporter | 常に報告者フィールドにあるアドレスに通知を送信するかどうかを指定します。 | false |
| always_notify_updater | チケットを変更した人とこれまでにそのチケットを変更した人に常に通知を送信するかどうかを指定します。 | true |
| ambiguous_char_width | 通知メールのテーブルで使用する ambiguous 文字の幅 ('single' または 'double') を指定します。 'single' の場合、US-ASCII 文字と同じ幅となります。これは大部分のユーザが期待するものです。'double' の場合、US-ASCII 文字の倍の幅になります。これは CJK ユーザが期待するものです。 (0.12.2 以降) | single |
| batch_subject_template | ticket_subject_template に似ていますが一括更新用のものです。 デフォルトでは $prefix Batch modify: $tickets_descr になります (1.0 以降)。 | $prefix Batch modify: $tickets_descr |
| email_sender | IEmailSender を実装しているコンポーネントの名前を指定します。 このコンポーネントは、メール送信による通知処理で使います。Trac は今のところ SMTP サーバと接続を行う SmtpEmailSender と sendmail と互換性のあるコマンドを実行する SendmailEmailSender を用意しています。(0.12 以降) | SmtpEmailSender |
| ignore_domains | メールアドレスだと判定させたくないドメイン名をカンマ区切りで指定します。(Kerberos ドメイン付きのユーザ名のため) | (デフォルトなし) |
| message_id_hash | Hash algorithm to create unique Message-ID header. (since 1.0.13) | md5 |
| mime_encoding | メールの MIME エンコーディングを指定します。 有効な設定は、Base64 エンコーディングの base64、Quoted-Printable の qp、エンコーディングなしの none で内容がすべて ASCII コードなら 7bit、そうでないなら 8bit として送信します。(0.10 以降) | none |
| sendmail_path | Path to the sendmail executable. The sendmail program must accept the -i and -f options. (since 0.12) | sendmail |
| smtp_always_bcc | 通知を常に送信するメールアドレスを指定します。メールアドレスは見えないようになります (Bcc:)。 (0.10 以降) | (デフォルトなし) |
| smtp_always_cc | 通知を常に送信するメールアドレスを指定します。メールアドレスはすべての受信者が見ることができます (Cc:)。 | (デフォルトなし) |
| smtp_default_domain | ドメインがないアドレスに付加するデフォルトのホスト名/ドメイン名を指定します。 | (デフォルトなし) |
| smtp_enabled | メール通知機能を有効にするかどうかを指定します。 | false |
| smtp_from | 通知メールに使用する送信者アドレスを指定します。 | trac@localhost |
| smtp_from_author | 通知メールの送信者として実行者の名前を使うかどうかを指定します。(1.0 以降) | false |
| smtp_from_name | 通知メールに使用する送信者名を指定します。 | (デフォルトなし) |
| smtp_password | SMTP サーバのパスワードを指定します。(0.9 以降) | (デフォルトなし) |
| smtp_port | メール通知に使用する SMTP サーバのポート番号を指定します。 | 25 |
| smtp_replyto | 通知メールに使用する返信先アドレスを指定します。 | trac@localhost |
| smtp_server | メール通知に使用する SMTP サーバのホスト名を指定します。 | localhost |
| smtp_subject_prefix | 通知メールの件名の先頭に追加するテキストを指定します。 設定が定義されていない場合は、[$project_name] プレフィックスとなります。 プレフィックスが必要ない場合は、空を指定すると無効になります。(0.10.1 以降) | __default__ |
| smtp_user | SMTP サーバのユーザ名を指定します。(0.9 以降) | (デフォルトなし) |
| ticket_subject_template | 通知メールの件名を生成するのに使う Genshi テキストテンプレートを指定します。 デフォルトでは、件名のテンプレートは $prefix #$ticket.id: $summary です。 $prefix は smtp_subject_prefix の設定値になります。 (0.11 以降) | $prefix #$ticket.id: $summary |
| use_public_cc | 受信者アドレスを Cc で他の更新者から見えるようにするかどうかを指定します。 このオプションに無効 (デフォルト) を設定している場合、受信者アドレスは Bcc に列挙します。(0.10 以降) | false |
| use_short_addr | ホスト名/ドメイン名なし (つまりユーザ名のみ) のメールアドレスを許可するかどうかを指定します。 SMTP サーバはそれらのアドレスを受け入れて、FQDN を追加する、またはローカル配送のどちらかを行うべきです。(0.10 以降) | false |
| use_tls | SMTP 接続により通知を送信する際に SSL/TLS を使用するかどうかを指定します。(0.10 以降) | false |
[project]
| admin | プロジェクト管理者のメールアドレスを指定します。 | (デフォルトなし) |
| admin_trac_url | この Trac で発生したエラーの報告先になる Trac サイトのベース URL を指定します。 これには、完全 URL または相対 URL、もしくはこの Trac を指す '.' を指定できます。空の値にすると報告用のボタンは使えなくなります。 (0.11.3 以降) | . |
| descr | プロジェクトの概要を指定します。 | My example project |
| footer | ページフッタのテキストを指定します (右揃え)。 | Visit the Trac open source project at<br /><a href="http://trac.edgewall.org/">http://trac.edgewall.org/</a> |
| icon | プロジェクトアイコンの URL を指定します。 | common/trac.ico |
| name | プロジェクトの名前を指定します。 | My Project |
| url | プロジェクトに対するメインの Web サイトの URL を指定します。通常は base_url のサイトにあります。通知メールでこれを使います。 | (デフォルトなし) |
[query]
| default_anonymous_query | 匿名ユーザ向けのデフォルトのクエリを指定します。このクエリは、クエリ言語 シンタックス、または query: Trac リンクで使う ? で始まる URL クエリ文字列のどちらかを指定します。 (0.11.2 以降) | status!=closed&cc~=$USER |
| default_query | 認証しているユーザ向けのデフォルトのクエリを指定します。このクエリは、クエリ言語 シンタックス、または query: Trac リンクで使う ? で始まる URL クエリ文字列のどちらかを指定します。 (0.11.2 以降) | status!=closed&owner=$USER |
| items_per_page | チケットクエリで1ページあたりに表示するチケット数のデフォルトを指定します (0.11 以降) | 100 |
| ticketlink_query | チケットの値にリンクを作成するときに使用するベースのクエリを指定します。これは query: Trac リンク で使う ? で始まる URL クエリ文字列です。 (0.12 以降) | ?status=!closed |
[report]
| items_per_page | チケットのレポートで1ページあたりに表示するチケット数のデフォルトを指定します (0.11 以降) | 100 |
| items_per_page_rss | レポートの RSS フィードに表示するチケット数を指定します (0.11 以降) | 0 |
[repositories]
リポジトリを新規登録するやり方の1つは、trac.ini の [repositories] セクションに追加することです。 これは便利なエイリアスや一時的なリポジトリの設定、インストール時の初期段階中に特に適しています。
このセクションで使用する書式の詳細については TracRepositoryAdmin を、他の方法についてはこのページの続きを参照してください。
(0.12 以降)
[revisionlog]
| default_log_limit | TracRevisionLog の limit 引数に対するデフォルト値を指定します。 (0.11 以降) | 100 |
| graph_colors | TracRevisionLog のグラフ表示に使う配色をカンマ区切りで指定します。(1.0 以降) | #cc0,#0c0,#0cc,#00c,#c0c,#c00 |
[roadmap]
| stats_provider | ITicketGroupStatsProvider を実装しているコンポーネントの名前を指定します。 これはロードマップの表示でチケットのグループごとに集計を行うのに使います。 | DefaultTicketGroupStatsProvider |
[search]
| default_disabled_filters | 検索ページのフィルタをデフォルトで無効にするものを指定します。クイック検索機能のフィルタにも適用します。デフォルトのコンポーネントが定義しているフィルタ名は wiki、ticket、milestone、changeset です。プラグインについては、ISearchSource インターフェイスの実装を探してください。get_search_method() メソッドが返すタプルの最初の要素になります。無効にしても、検索ページでユーザが手動でフィルタを有効にすることができます。(0.12 以降) | (デフォルトなし) |
| min_query_length | 検索の実行を許可する検索文字列の最小の長さを指定します。 | 3 |
[sqlite]
| extensions | SQLite 拡張のパスを Trac 環境ディレクトリからの相対パス、または、絶対パスで指定します。(0.12 以降) | (デフォルトなし) |
[svn]
| branches | ブランチとして分類させるパスをカンマ区切りで指定します。 パスが '*' で終わっている場合は、そのパス配下にあるすべてのエントリになります。 例: /trunk, /branches/*, /projectAlpha/trunk, /sandbox/* | trunk, branches/* |
| eol_style | svn:eol-style プロパティが native の場合の改行文字列を指定します。 native (デフォルト) の場合、サーバ上での改行コードに展開されます。それ以外の LF, CRLF, CR の場合、指定した改行コードに展開されます。 (1.0.2 以降) | native |
| tags | タグとして分類させるパスをカンマ区切りで指定します。 パスが '*' で終わっている場合は、そのパス配下にあるすべてのエントリになります。 例: /tags/*, /projectAlpha/tags/A-1.0, /projectAlpha/tags/A-v1.1 | tags/* |
[svn:externals]
Subversion に対する TracBrowser はフォルダの svn:externals プロパティを解釈できるようになっています。Trac はリモートにあるリポジトリを参照できないため、デフォルトでは単に URL をリンクに変換するだけです。
しかし、対象のリポジトリを参照できるようにしている Trac (または ViewVC などのリポジトリブラウザ) がある場合は、外部参照の URL に対してそのリポジトリブラウザを使うように設定することができます。このマッピングは TracIni の [svn:externals] セクションで行います。
例:
[svn:externals] 1 = svn://server/repos1 http://trac/proj1/browser/$path?rev=$rev 2 = svn://server/repos2 http://trac/proj2/browser/$path?rev=$rev 3 = http://theirserver.org/svn/eng-soft http://ourserver/viewvc/svn/$path/?pathrev=25914 4 = svn://anotherserver.com/tools_repository http://ourserver/tracs/tools/browser/$path?rev=$rev
上記では、外部参照 svn://anotherserver.com/tools_repository/tags/1.1/tools を http://ourserver/tracs/tools/browser/tags/1.1/tools?rev= にマッピングするようになります。(また外部参照がリビジョン番号を指定している場合 rev にはリビジョン番号が割り当てられます。詳細は SVN Book on externals を参照してください)。
注意事項として、設定ファイルのパーサーの制限により URL 自体をキーにすることができないため、上記セクションのキーに単なるプレースホルダとして数字を使っています。
最後に、Subversion 1.5 から導入された相対 URL はまだサポートしていません。
(0.11 以降)
[ticket]
| default_cc | 新規登録チケットに対するデフォルトの関係者を指定します。 | (デフォルトなし) |
| default_component | 新規登録チケットに対するデフォルトのコンポーネントを指定します。 | (デフォルトなし) |
| default_description | 新規登録チケットに対するデフォルトの詳細を指定します。 | (デフォルトなし) |
| default_keywords | 新規登録チケットに対するデフォルトのキーワードを指定します。 | (デフォルトなし) |
| default_milestone | 新規登録チケットに対するデフォルトのマイルストーンを指定します。 | (デフォルトなし) |
| default_owner | 新規登録チケットに対するデフォルトの担当者を指定します。 | < default > |
| default_priority | 新規登録チケットに対するデフォルトの優先度を指定します。 | major |
| default_resolution | 解決 (クローズ) になるチケットに対するデフォルトの解決方法を指定します (0.11 以降)。 | fixed |
| default_severity | 新規登録チケットに対するデフォルトの重要度を指定します。 | (デフォルトなし) |
| default_summary | 新規登録チケットに対するデフォルトの概要 (タイトル) を指定します。 | (デフォルトなし) |
| default_type | 新規登録チケットに対するデフォルトの分類を指定します。(0.9 以降) | defect |
| default_version | 新規登録チケットに対するデフォルトのバージョンを指定します。 | (デフォルトなし) |
| max_comment_size | コメントの最大文字数で指定します。(0.11.2 以降) | 262144 |
| max_description_size | チケットの詳細の最大文字数を指定します。(0.11 以降) | 262144 |
| max_summary_size | 概要の最大文字数で指定します。(1.0.2 以降) | 262144 |
| preserve_newlines | Wiki フォーマッタが Wiki テキスト中の改行を考慮するかどうかを指定します。 'default' を設定した場合、新規作成した環境下では 'yes' となりますが、アップグレードしてきた環境では以前の挙動のまま (つまり 'no') となります。 (0.11 以降) | default |
| restrict_owner | チケットの担当者フィールドにドロップダウンメニューを使うようになります。 このオプションを有効にする前にパフォーマンスに対する影響を把握するようにしてください。ドロップダウンで担当振り分けを参照。 ドロップダウンメニュー中ではメールアドレスを隠せないことに注意してください。そのため、メールアドレスを保護したままにしないといけない場合には、このオプションを使用するべきではありません。 (0.9 以降) | false |
| workflow | チケットのアクションに使用するワークフローコントローラを順番に指定します。(0.11 以降) | ConfigurableTicketWorkflow |
[ticket-custom]
このセクションでは、チケットに追加したいフィールドを定義することができます。詳細については TracTicketsCustomFields を参照してください。
[ticket-workflow]
チケットのワークフローはプラグインで制御します。デフォルトで制御しているのは ConfigurableTicketWorkflow コンポーネントのみです。 そのコンポーネントは trac.ini ファイルのこのセクションでワークフローを設定するようになっています。詳細については TracWorkflow を参照してください。
(0.11 以降)
[timeline]
| abbreviated_messages | Wiki フォーマットしたイベントメッセージを切り詰めるかどうかを指定します。 これは描画のみに有効でイベントプロバイダは無視することができます。詳細は個々のドキュメントを参照してください。 (0.11 以降) | enabled |
| changeset_collapse_events | 同じ更新者で完全に同じメッセージを持っている連続したチェンジセットを1つのイベントになるようにするかどうかを指定します。このイベントは、更新履歴ページでのチェンジセットの範囲にリンクするようになります。 (0.11 以降) | false |
| changeset_long_messages | Wiki フォーマットになっているチェンジセットのメッセージを複数行になるようにするかそうでないようにするかを指定します。 この設定を指定しないか false にして wiki_format_messages を true にすると、チェンジセットのメッセージは1行スタイルになり、箇条書きなどの書式は反映されないようになります。 | false |
| changeset_show_files | 表示するファイル数を指定します。(-1は無制限、0は無効になります) location を指定することもできます。変更ファイルの共通しているプレフィックスを表示するようになります。(0.11 以降) | 0 |
| default_daysback | タイムラインに表示する日数のデフォルトを指定します。 (0.9 以降) | 30 |
| max_daysback | タイムラインに表示できる最大日数 (-1 は無制限) を指定します。(0.11 以降) | 90 |
| newticket_formatter | 新規登録チケットの詳細を表示する際にどのフォーマッタを使用するかを指定します (例えば 'html' や 'oneliner')。 'oneliner' の場合は、[timeline] abbreviated_messages の設定内容を適用します。 (0.11 以降) | oneliner |
| ticket_show_details | タイムラインにチケットの登録と解決だけでなくすべてのチケットの変更を表示するかどうかを指定します。(0.9 以降) | false |
[trac]
| auth_cookie_lifetime | 認証用クッキーの生存期間を秒単位で指定します。 この値を使って、ブラウザは認証情報をどれくらいの間キャッシュするか、つまり、ユーザのアクセスがどれくらいない時には再度ログインする必要があるか、を決めます。デフォルト値は0で、ブラウザの終了時にクッキーは期限切れになります。(0.12 以降) | 0 |
| auth_cookie_path | 認証用クッキーのパスを指定します。クッキーを他の Trac インスタンスと共有したい場合には、共通になるベースのパスを設定します。(0.12 以降) | (デフォルトなし) |
| authz_file | Subversion authz ファイル のパスを指定します。 authz 権限チェックを有効にするには、AuthzSourcePolicy 権限ポリシーを [trac] permission_policies に追加してください。 | (デフォルトなし) |
| authz_module_name | authz_file で使うデフォルトのリポジトリに対応するモジュール名を指定します。空の場合はグローバルセクションを使用します。 | (デフォルトなし) |
| auto_preview_timeout | 操作のないときに実行する Wiki プレビューの自動更新の時間を秒で指定します。この設定には浮動小数点を指定できます。値を小さくするとサーバが大量のリクエストを処理することになります。0を指定すると自動プレビューを無効にします。デフォルトは2.0秒です。(0.12 以降) | 2.0 |
| auto_reload | テンプレートの変更後に自動でリロードするかどうかを指定します。 | disabled |
| backup_dir | データベースバックアップの場所を指定します。 | db |
| base_url | Trac の展開先を指す URL を指定します。 これは Web アクセスではないところからドキュメントを提示する場合に使用するベース URL です。例えば、通知メールで Trac のリソースを指し示す URL を入れる場合などです。 | (デフォルトなし) |
| check_auth_ip | 認証チェックに IP アドレスを使用するかどうかを指定します。(0.9 以降) | false |
| database | このプロジェクトのデータベース接続文字列を指定します。 | sqlite:db/trac.db |
| debug_sql | DEBUG レベルのときに SQL クエリをログに表示するかどうかを指定します。(0.11.5 以降) | disabled |
| default_charset | 文字コードが不明な場合に使用する文字コードを指定します。 | utf-8 |
| default_date_format | 日付書式を指定します。有効な設定は ISO 8601 形式になる 'iso8601' で、空のままにするとブラウザの言語設定に基づいたデフォルト日付書式となります。(1.0 以降) | (デフォルトなし) |
| default_dateinfo_format | 日付情報の書式を指定します。有効な設定は相対書式で表示する 'relative' と絶対書式で表示する 'absolute' です。(1.0 以降) | relative |
| default_handler | ベース URL へのリクエストを処理するコンポーネントの名前を指定します。 選択肢には TimelineModule、RoadmapModule、BrowserModule、QueryModule、ReportModule、TicketModule、WikiModule があり、デフォルトは WikiModule です。(0.9 以降) | WikiModule |
| default_language | 個人設定がない場合に使う言語を指定します。(0.12.1 以降) | (デフォルトなし) |
| default_timezone | デフォルトで使うタイムゾーンを指定します。 | (デフォルトなし) |
| genshi_cache_size | テンプレートローダがメモリにキャッシュするテンプレートの最大数を指定します。デフォルト値は128です。もっと多くのテンプレートを使っていてメモリに余裕がある場合は、大きな値にすることもできます。メモリが少ない場合には、小さくすることもできます。 | 128 |
| htdocs_location | /chrome/common/ 配下の静的リソースを処理するベース URL を指定します。 空のままにすることもでき、Trac が自分で単にそのリソースを処理するようになります。 上級者は trac-admin ... deploy <deploydir> を一緒に使って Web サーバが直接 Trac の静的リソースを処理するようにできます。しかし、<deploydir>/htdocs/common ディレクトリにしか適用されず、デプロイしているリソース (例えばプラグインのリソース) に対してはこの方法は有効ではありません。Web サーバに対し、追加でリライトルールが必要になります。 | (デフォルトなし) |
| ignore_auth_case | ログイン名を小文字に変換するかどうかを指定します。(0.9 以降) | false |
| jquery_location | jQuery JavaScript ライブラリ (バージョン 1.7.2) の URL を指定します。 空の値を指定すると、Trac にバンドルしているコピーを使って jQuery をロードします。 もしくは、jQuery を CDN からロードすることができます。例えば http://code.jquery.com/jquery-1.7.2.min.js、http://ajax.aspnetcdn.com/ajax/jQuery/jquery-1.7.2.min.js または https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js を指定します。 (1.0 以降) | (デフォルトなし) |
| jquery_ui_location | jQuery UI JavaScript ライブラリ (バージョン 1.8.21) の URL を指定します。 空の値を指定すると、Trac にバンドルしているコピーを使って jQuery UI をロードします。 もしくは、jQuery UI を CDN からロードすることができます。例えば https://ajax.googleapis.com/ajax/libs/jqueryui/1.8.21/jquery-ui.min.js または http://ajax.aspnetcdn.com/ajax/jquery.ui/1.8.21/jquery-ui.min.js を指定します。 (1.0 以降) | (デフォルトなし) |
| jquery_ui_theme_location | jQuery UI JavaScript ライブラリ (バージョン 1.8.21) で使用するテーマの URL を指定します。 空の値を指定すると、Trac にバンドルしているコピーからカスタムの Trac jQuery UI テーマをロードします。 もしくは、jQuery UI テーマを CDN からロードすることができます。例えば https://ajax.googleapis.com/ajax/libs/jqueryui/1.8.21/themes/start/jquery-ui.css または http://ajax.aspnetcdn.com/ajax/jquery.ui/1.8.21/themes/start/jquery-ui.css を指定します。 (1.0 以降) | (デフォルトなし) |
| mainnav | mainnav ナビゲーションバーに表示する項目の順番を ID で指定します。TracNavigation も参照してください。 | wiki, timeline, roadmap, browser, tickets, newticket, search |
| metanav | metanav ナビゲーションバーに表示する項目の順番を ID で指定します。TracNavigation も参照してください。 | login, logout, prefs, help, about |
| mysqldump_path | MySQL データベースのバックアップに使う mysqldump の場所を指定します。 | mysqldump |
| never_obfuscate_mailto | show_email_addresses が false、または、EMAIL_VIEW 権限がない場合でも、Wiki 中に明示的に記述してある mailto: リンクを隠さないようにするかどうかを指定します。(0.11.6 以降) | false |
| permission_policies | 適用する順番で IPermissionPolicy を実装しているコンポーネントのリストを指定します。それらのコンポーネントは Trac のソリースに対して細かい粒度のアクセス制御を行います。 DefaultPermissionPolicy (0.11 以前の挙動) と LegacyAttachmentPolicy (ATTACHMENT_* 権限を個々のレルムの権限にマッピング) がデフォルトです。 | DefaultPermissionPolicy, LegacyAttachmentPolicy |
| permission_store | IPermissionStore を実装しているコンポーネントの名前を指定します。これはユーザとグループの権限を管理するのに使います。 | DefaultPermissionStore |
| pg_dump_path | Postgres データベースのバックアップに使う pg_dump の場所を指定します。 | pg_dump |
| repository_dir | デフォルトのリポジトリへのパスを指定します。これは相対パスにすることもできます。(0.11 以降) このオプションは非推奨で、リポジトリは repositories セクションで定義、もしくは「リポジトリ」管理パネルを使うようにしてください。(0.12 以降) | (デフォルトなし) |
| repository_sync_per_request | ページのリクエストのたびに同期を行うリポジトリのリストを指定します。 post-commit フックから trac-admin $ENV changeset added を実行するようにすべてのリポジトリで設定しているなら、このオプションを空にしてください (推奨)。そうでないのであれば、リポジトリの名前をカンマ区切りで指定します。注意事項として、これはパフォーマンスに悪影響があり、チェンジセット・リスナーが指定したリポジトリからのイベント取得を妨げることになります。デフォルトは、下位互換のためデフォルトのリポジトリと同期を行います。(0.12 以降) | (default) |
| repository_type | デフォルトになるリポジトリの接続方法を指定します。(0.10 以降) TracIni#repositories-section repositories セクションで定義するリポジトリや「リポジトリ」管理パネルなどでも使用します。(0.12 以降) | svn |
| request_filters | リクエストに適用するフィルタを順番に指定します。 (0.10 以降) | (デフォルトなし) |
| resizable_textareas | <textarea> フィールドをリサイズできるようにするかどうかを指定します。JavaScript が必要になります。 (0.12 以降) | true |
| secure_cookies | HTTPS 接続でのみ Cookie を使用するかどうかを指定します。 true に設定すると、すべての Cookie に secure フラグを設定することでサーバへ HTTPS 接続でのみ Cookie を送信するようにします。Trac を HTTPS 経由でだけアクセス可能にする場合、これを指定します。(0.11.2 以降) | disabled |
| show_email_addresses | ユーザ名の代わりにメールアドレスを表示するかどうかを指定します。false の場合、EMAIL_VIEW 権限を持たないユーザにはメールアドレスを表示しないようになります。(0.11 以降) | false |
| show_ip_addresses | リソース編集時の IP アドレスを表示するかどうかを指定します (例えば Wiki)。 1.0.5 でこのオプションは非推奨となり 1.3.1 で削除予定です。(0.11.3 以降) | false |
| timeout | データベース接続のタイムアウトを秒単位で指定します。 タイムアウトなしを指定するには '0' を使います。(0.11 以降) | 20 |
| use_base_url_for_redirect | [trac] base_url の設定値をリダイレクトに使用するかどうかを指定します。 HTTP プロキシの背後で Trac を実行するような環境では、アクセスに使用した URL を自動で再構成することはできません。強制的に base_url 設定値にリダイレクトさせるこのオプションを設定しなければいけないかも知れません。これにより、リダイレクトに使われるこの URL からだけこの環境を利用できるような制限が設けられます。(0.10.5 以降) | disabled |
| use_chunked_encoding | 有効の場合、HTTP/1.1 の chunked エンコーディングでコンテンツを送信します。そうでない場合には、コンテンツの全体を描画してから Content-Length ヘッダ付きでコンテンツを送信します。(1.0.6 以降) | false |
| use_xsendfile | true の場合、Web サーバがファイルの中身を処理できるように、ファイル送信時に X-Sendfile ヘッダを送信し中身を送信しません。Apache の mod_xsendfile や lighttpd のように、このようなヘッダを処理できるようにする必要があります。(1.0 以降) | false |
| wiki_toolbars | Wiki <textarea> の上部にシンプルなツールバーを追加するかを指定します。(1.0.2 以降) | true |
| xsendfile_header | use_xsendfile が有効の場合に使用するヘッダを指定します。Nginx を使用している場合には、X-Accel-Redirect を設定してください。(1.0.6 以降) | X-Sendfile |
[versioncontrol]
| allowed_repository_dir_prefixes | リポジトリ管理パネルで追加や変更の際に、リポジトリのディレクトリとして許可するプレフィックスをカンマ区切りで指定します。このリストが空の場合は、すべてのディレクトリを許可します。 (0.12.1 以降) | (デフォルトなし) |
[wiki]
| ignore_missing_pages | 存在しないページを指す CamelCase リンクをハイライトするかどうかを指定します。 (0.9 以降) | false |
| max_size | Wiki ページの最大文字数を指定します。(0.11.2 以降) | 262144 |
| render_unsafe_content | 危険性のある <script> や <embed> のような HTML タグを HTML WikiProcessor で有効にするかどうかを指定します。(0.10.4 以降) 匿名ユーザが Wiki を編集できるような公開サイトでは、このオプションは無効のまま (デフォルト) にしておくことを推奨します。 | false |
| safe_schemes | 「安全」とみなす URI スキームのリストを指定します。[wiki] render_unsafe_content が false の場合に、外部リンクとして表示します。 (0.11.8 以降) | cvs, file, ftp, git, irc, http, https, news, sftp, smb, ssh, svn, svn+ssh |
| split_page_names | WikiPageNames を空白文字で分割するかどうかを指定します。(0.10 以降) | false |
See also: TracGuide, TracAdmin, TracEnvironment