Trac 設定ファイル
Table of Contents
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 が指定されていれば、設定ファイルは順次読み込まれます。
リファレンス
現在利用できる設定項目のリファレンスです。
[attachment]
| max_size | チケットと Wiki の添付ファイルの最大サイズをバイト数で 指定します。 |
| render_unsafe_content | 添付ファイルをブラウザ上に表示するか、 単にダウンロード可能にしておくかどうかを設定します。 ブラウザがほとんどのファイルを HTML として解釈することがあるため、 悪意のあるユーザにクロスサイトスクリプティング攻撃を可能にするファイル の添付を許すことになります。 誰でもファイルを添付できるような公開サイトでは、このオプションを無効に 設定しておくことを推奨します (デフォルトは、無効に設定されています)。 |
[browser]
| color_scale | age 列に色付けされます。 ソースコード注釈と同じカラースケールが使用されます: 青が古く、赤が新しいものを指します。 (0.11 以降) |
| downloadable_paths | ダウンロード可能なリポジトリのパスをリストします。 このオプションに何も設定しない場合、全てのダウンロードを禁止されます。 部分的に許可する場合は、カンマ区切りでダウンロードを許可するパスを設定します (パスには "*" をワイルドカードとして扱うような glob パターンを使用できます) (0.10 以降) |
| hide_properties | カンマ区切りでバージョン管理の属性を設定すると、その属性は リポジトリブラウザで表示されなくなります。 (0.9 以降) |
| intermediate_color | (r,g,b) の 3 色で指定します。この色は中間を指す 色として、 2 色の間のカラースケールとして使用されます (intermediate_point 参照)。 intermediate color をセットしない場合、 oldest_color と newest_color の中間の色が使用されます。 (0.11 以降) |
| intermediate_point | 0 から 1 (最大) の間で値を設定します。 この値は intermediate_color に設定したポイントへの補間に 使用されます。 (0.11 以降) |
| newest_color | (r,g,b) の 3 色で指定します。この色は新しいものを指す 色として 注釈 (blame) や、 color_scale が有効に設定されていれば ブラウザの age 列のカラースケールに使用されます。 (0.11 以降) |
| oldest_color | (r,g,b) の 3 色で指定します。この色は古いものを指す 色として 注釈 (blame) や、 color_scale が有効に設定されていれば ブラウザの age 列のカラースケールに使用されます。 (0.11 以降) |
| oneliner_properties | カンマ区切りでバージョン管理の属性を設定すると、その属性は リポジトリブラウザ上で 1 行スタイルの Wiki コンテンツとして表示されます。 (0.11 以降) |
| render_unsafe_content | ファイルをブラウザ上に表示するか、単にダウンロード可能にしておくか を設定します。 この設定を有効にすると、ブラウザがほとんどのファイルを HTML として解釈 するため、悪意のあるユーザにクロスサイトスクリプティング攻撃を含む ファイルの作成を許すことになります。 誰でもファイルをチェックインできるような公開リポジトリでは、 このオプションを無効に設定しておくことを推奨します (デフォルトは無効に設定されています)。 |
| wiki_properties | カンマ区切りでバージョン管理の属性を設定すると、その属性は リポジトリブラウザ上で Wiki コンテンツとして表示されます。 (0.11 以降) |
[changeset]
| max_diff_bytes | 更新したファイル (旧ファイルのサイズと新ファイルのサイズを足したもの) のサイズの最大をバイト単位で指定します。チェンジセットビューの diff で 直接表示するサイズを制限します (0.10 以降)。 |
| max_diff_files | チェンジセットビューの diff で直接表示する 更新ファイルの最大数を設定します。(0.10 以降)。 |
| wiki_format_messages | Wiki フォーマットをチェンジセットのログメッセージに適用するかどうかを設定します。 このオプションが無効になっている場合、チェンジセットのログメッセージは 整形済みテキストとして表示されます。 |
[header_logo]
| alt | ヘッダロゴに使用する alt テキストを設定します。 |
| height | ヘッダロゴの高さを pixel で設定します。 |
| link | ヘッダロゴがリンクする URL を設定します。 |
| src | ヘッダロゴに使用するイメージファイルの URL を設定します。 |
| width | ヘッダロゴの幅を pixel で設定します。 |
[inherit]
| plugins_dir | 共有するプラグインをおくディレクトリ のパスを指定します。 このディレクトリに配置されたプラグインは、 Environemnt の plugins ディレクトリのプラグインに加えて、 優先してロードされます。 (0.11 以降) |
| templates_dir | 共有するテンプレートディレクトリ のパスを指定します。 指定したパスは環境の templates ディレクトリに加えてロードされますが、 templates ディレクトリが優先となります。 (0.11 以降) |
[logging]
| log_file | log_type が file のときのログファイルへのパスを設定します。 |
| log_format | ログのフォーマットをカスタマイズします。 デフォルトでは以下のフォーマットが使用されます : Trac[$(module)s] $(levelname)s: $(message)s Python のロガーライブラリがサポートしている標準のキー ( http://docs.python.org/library/logging.html 参照) に加えて、 以下のキーを使用することができます: - $(path)s 現在の環境へのパス - $(basename)s 現在の環境のパスの一番最後の部分 - $(project)s プロジェクト名 %(...)s を使用すると ConfigParser が解釈し展開してしまうので、 代わりに $(...)s を使用して下さい。 例: ($(thread)d) Trac[$(basename)s:$(module)s] $(levelname)s: $(message)s (0.10.5 以降) |
| log_level | ログレベルを設定します。 値は (CRITICAL, ERROR, WARN, INFO, DEBUG) の、どれかでなければなりません。 |
| log_type | 出力するログの種類を設定します。 値は (none, file, stderr, syslog, winlog) の、どれかでなければなりません。 |
[milestone]
| stats_provider | ITicketGroupStatsProvider を implement するコンポーネントの名前を設定します。 マイルストーンビューの表示で使用する、チケットのグループでの統計情報を収集する ために使用されます。 |
[mimeviewer]
| max_preview_size | HTML プレビューでのファイルの最大サイズを設定します。 (0.9 以降) |
| mime_map | 追加の MIME タイプとキーワードのマッピングのリストを設定します。 マッピングリストはそれぞれの MIME タイプごとにカンマ区切りで指定します。 MIME タイプと関連するキーワードもしくはファイルの拡張子をコロン (":") 区切りで記述します。 (0.10 以降) |
| tab_width | ファイルをプレビューするときのタブの表示幅を設定します。 (0.9 以降) |
| treat_as_binary | バイナリデータとして取り扱う MIME タイプをカンマ区切りのリストで 設定します。 (0.11.5 以降) |
[notification]
| admit_domains | メールアドレスとして有効とするドメインをカンマ区切りで設定します。 (localdomain など) |
| always_notify_owner | チケットの担当者 (owner) に常に通知メールを送信するかを設定します (0.9 以降) 。 |
| always_notify_reporter | 報告者 (reporter) フィールドにあるアドレスに常に通知メールを 送信するかを設定します。 |
| always_notify_updater | チケット属性が変更された場合に、それまでの全ての変更を行った人に、 常に通知メールを送信するかを設定します。 |
| email_sender | IEmailSender を実装しているコンポーネント名を設定します。 ここに設定されたコンポーネントを使って通知システムはメールを送信します。 現在のところ Trac では SMTP サーバに接続する SmtpEmailSender と、 sendmail 互換の実行可能ファイルを実行する SendmailEmailSender が提供されています。 (0.12 以降) |
| ignore_domains | メールアドレスの一部として有効としないドメインをカンマ区切りで設定します。 (ユーザ名に Kerberos ドメインが付いている場合などの対策) |
| mime_encoding | メールのエンコード方法を設定します。 有効なオプションとして、Base64 エンコーディングの 'base64', Quoted-Printable の 'qp', すべての文字が ASCII の場合は 7bit で、 そうでない場合には適切な 8bit で送信する 'none' があります。 (0.10 以降)。 |
| sendmail_path | sendmail 実行可能ファイルへのパスを設定します。 sendmail プログラムは -i および -f オプションを解釈できる必要が あります。 (0.12 以降) |
| smtp_always_bcc | 常に通知メールを送るメールアドレスを設定します。 設定したアドレスを受信者は見ることができません(Bcc:)。(0.10 以降 )。 |
| smtp_always_cc | 常に通知メールを送るメールアドレスを設定します。 設定したアドレスは、すべての受信者がみることができます (Cc:)。 |
| smtp_default_domain | アドレスにホスト名/ドメインが指定されていなかったときに、付与する 文字列を設定します。 |
| smtp_enabled | メール通知を有効にするかどうかを設定します。 |
| smtp_from | 通知メールに使用する送信者アドレスを設定します。 |
| smtp_from_name | 通知メールに使用する送信者名を設定します。 |
| smtp_password | SMTP サーバの認証パスワードを設定します (0.9 以降)。 |
| smtp_port | メール通知で使用する SMTP サーバのポート番号を設定します。 |
| smtp_replyto | 通知メールに使用する返信アドレスを設定します。 |
| smtp_server | メール通知で使用する SMTP サーバのホスト名を設定します。 |
| smtp_subject_prefix | 通知メールの件名の頭に追加するプレフィックスを設定します。 オプションが定義されていない場合、[$project_name] (訳注: trac.ini の project セクションの name) が設定されます。 プレフィックスが必要ない場合は、オプションに空の値を設定することで、 無効化できます (0.10.1 以降)。 |
| smtp_user | SMTP サーバの認証ユーザ名を設定します (0.9 以降)。 |
| ticket_subject_template | 通知の件名 (Subject) に使用する Genshi のテキストテンプレートの一部を設定します。 デフォルトでは件名のテンプレートは $prefix #$ticket.id: $summary です。 $prefix の箇所は smtp_subject_prefix オプションの値で置き換えられます。 (0.11 以降) |
| use_public_cc | 通知メールの受信者が、 CC された他の受信者のメールアドレスを見ることができるかを設定します。 このオプションが無効になっている場合 (デフォルト)、受信者のメールアドレスは BCC フィールドに設定されます (0.10 以降)。 |
| use_short_addr | ホスト名やドメインがないメールアドレスを許容するかを設定します (ユーザ名のみの場合など)。 SMTP サーバはホスト名やドメインがないメールアドレスも受け入れるべきで、 FQDN を追加するか、ローカル配送を使うべきです (0.10 以降)。 |
| use_tls | メール通知に SSL/TLS を使用するかどうかを設定します (0.10 以降)。 |
[privatewikis]
| private_wikis | Wikis to protect. |
[project]
| admin | プロジェクトの管理者のメールアドレスを設定します。 |
| admin_trac_url | この Trac で発生したエラーを報告する先の Trac インスタンスの ベース URL を設定します。 絶対 URL, 相対 URL, およびこの Trac インスタンスを指す '.' が 指定可能です。空白値を指定すると報告ボタンが表示されなくなります。 (0.11.3 以降) |
| descr | プロジェクトの概要を設定します。 |
| footer | ページのフッタに表示するテキストを指定します (右詰めで表示されます)。 |
| icon | プロジェクトのアイコンの URL を指定します。 |
| name | プロジェクトの名前を設定します。 |
| url | プロジェクトのメインとなる Web サイトの URL を設定します。 通常、 base_url が示すウェブサイトを指定します。 この設定は通知メールで使用されます。 |
[query]
| default_anonymous_query | 認証されていないユーザへのデフォルトのクエリ。このクエリは クエリ言語 のシンタックスか、 query: の Trac リンク でも使われる ? で始まる URL クエリ文字列で記述します (0.11.2 以降)。 |
| default_query | 認証されたユーザへのデフォルトのクエリ。このクエリは クエリ言語 のシンタックスか、 query: の Trac リンク でも使われる ? で始まる URL クエリ文字列で記述します (0.11.2 以降)。 |
| items_per_page | カスタムクエリの検索結果で 1 ページあたり表示するチケット数の デフォルト値 (0.11 以降) |
| ticketlink_query | チケットの属性値からのリンクを生成する際に使用されるベースとなるクエリ。 このクエリは query: Trac リンク でも使われる ? で始まる URL クエリ文字列で記述します。 (0.12 以降) |
[report]
| items_per_page | レポートの検索結果ページで 1 ページに表示するチケット数の デフォルト値 (0.11 以降) |
| items_per_page_rss | レポートの RSS フィードに掲載するチケット数 (0.11 以降) |
[revisionlog]
| default_log_limit | TracRevisionLog での最大表示数のデフォルト値 (0.11 以降)。 |
[roadmap]
| stats_provider | ITicketGroupStatsProvider を implement するコンポーネントの名前を設定します。 ロードマップビューの表示で使用する、チケットのグループでの統計情報を収集する ために使用されます。 |
[search]
| default_disabled_filters | 検索ページでデフォルトで無効化の対象とする検索フィルタを 設定します。ここに設定した値はクイックサーチの機能でも適用 されます。無効化した検索フィルタは、検索ページ上で、ユーザの 操作によって再度有効にすることができます。 (0.12 以降) |
| min_query_length | 検索を実行するときに許容するクエリ文字列の最短の長さを設定します。 |
[sqlite]
| extensions | SQLite 拡張へのパスを Trac Environment からの相対パスか、 絶対パスで設定します。 (0.12 以降) |
[svn]
| branches | ブランチとして分類するパスのカンマ区切りリスト。 パスが '*' で終わっている場合、そのパスに含まれる全ての ディレクトリエントリが含まれます。 例: /trunk, /branches/*, /projectAlpha/trunk, /sandbox/* |
| tags | タグとして分類するパスのカンマ区切りリスト。 パスが '*' で終わっている場合、そのパスに含まれる全ての ディレクトリエントリが含まれます。 例: /tags/*, /projectAlpha/tags/A-1.0, /projectAlpha/tags/A-v1.1 |
[ticket]
| default_cc | 新規登録チケットにデフォルトで設定する関係者リスト。 |
| default_component | 新規登録チケットにデフォルトで設定するコンポーネント。 |
| default_description | 新規登録チケットにデフォルトで設定する説明。 |
| default_keywords | 新規登録チケットにデフォルトで設定するキーワード。 |
| default_milestone | 新規登録チケットにデフォルトで設定するマイルストーン。 |
| default_owner | 新規登録チケットにデフォルトで設定する担当者。 |
| default_priority | 新規登録チケットにデフォルトで設定する優先度。 |
| default_resolution | チケットを解決にする (閉じる) ときに、デフォルトで設定する解決方法 (0.11 以降)。 |
| default_severity | 新規登録チケットにデフォルトで設定する重要度。 |
| default_summary | 新規登録チケットにデフォルトで設定する概要 (タイトル)。 |
| default_type | 新規登録チケットにデフォルトで設定するチケット分類 (0.9 以降)。 |
| default_version | 新規登録チケットにデフォルトで設定するバージョン。 |
| max_comment_size | チケットのコメント (comment) の最大サイズを設定します (0.11.2 以降)。 |
| max_description_size | チケットの記述 (description) の最大サイズを設定します (0.11 以降)。 |
| preserve_newlines | Wiki フォーマッタが Wiki テキスト中の改行を文字を考慮するかを 設定します。 'default' に設定されている場合、新規作成した Environment では 'yes' と同じ意味になりますが、 アップグレードした Environemnt では、以前のふるまいを踏襲します ('no' に相当) (0.11 以降)。 |
| restrict_owner | チケットの担当者のフィールドでドロップダウンメニューを使用するかを設定します。 このオプションを有効にする前に、性能への影響について理解しておいて ください。 担当者をドロップダウンリストにする を参照して下さい (0.9 以降)。 |
| workflow | チケットのアクションに使用するワークフローコントローラを順にリスト形式で設定します。 (0.11 以降)。 |
[timeline]
| abbreviated_messages | WikiFormatting で書かれたメッセージを切り詰めるかどうかを設定します。 このオプションは default のレンダリングでのみ有効です。 特定のイベントプロバイダによって、 設定が上書きされることがあります。詳しくは、イベントプロバイダのドキュメントを参照して下さい (0.11 以降)。 |
| changeset_collapse_events | 全く同じログメッセージで、同一編集者による連続したチェンジセットを 1 つのイベントとして扱います。 この場合、ログビューでは範囲を持つチェンジセットとしてリンクされます。 (0.11 以降) |
| changeset_long_messages | Wiki フォーマットのチェンジセットのログメッセージを複数行表示するかどうかを設定します。 このオプションが設定されないか、 false である場合、かつ wiki_format_messages が true に設定されている場合、チェンジセットのログメッセージは、1 行のみ 表示され、いくつかのフォーマット (中点 (bullet points) など) は無視されます。 |
| changeset_show_files | タイムラインに表示するファイル数を設定します (-1: 無制限, 0: 表示しない)。 また、変更のあったファイルに共通するプレフィックスを 位置 として 表示します (0.11 以降)。 |
| default_daysback | タイムラインに表示する日数にデフォルト値を設定します (0.9 以降)。 |
| max_daysback | タイムラインで表示可能な日数の最大値 (-1 は無制限を意味する) (0.11 以降)。 |
| newticket_formatter | 新規登録チケットの記述 (description) を表示するときに使用する フォーマッタの flavor (例えば 'html' や 'oneliner')を設定します。 'oneliner' を設定した場合、 [timeline] の abbreviated_messages オプションが適用されます (0.11 以降)。 |
| ticket_show_details | タイムラインにオープン/クローズだけでなく、すべてのチケットの変更を 表示するかを設定します (0.9 以降)。 |
[trac]
| auth_cookie_lifetime | 認証用 cookie の生存時間を秒数で設定します。 この値はブラウザがいつまで認証情報をキャッシュするかを指定します。 したがって、ユーザが何もしないままこの時間を経過すると 再びログインしなければなりません。デフォルト値 0 はブラウザのセッション が終了したときに、 cookie の期限が切れます (0.12 以降) |
| auth_cookie_path | 認証用 cookie のパスを指定します。 cookie を複数の Trac のインスタンスで共有させたいならば、 この値を 共有させたい Trac のベースとなるパスを設定して下さい。 (0.12 以降) |
| authz_file | Subversion の 認証 (authz) ファイル へのパスを設定します。 authz ファイルによるパーミッションチェックを有効にするには、 [trac] permission_policies に AuthzSourcePolicy を追加する必要があります。 |
| authz_module_name | デフォルトリポジトリの authz_file で使用しているモジュールの プレフィックスを設定します。空の場合、グローバルセクションが使用されます。 |
| auto_preview_timeout | 自動的に wiki のプレビューが更新される際の無応答に対するタイムアウト値を秒数で 指定します。このオプションは小数点を含む数値を指定することができます。 小さい値を設定した際は、サーバへより多くのリクエストが発生します。 このプレビューの自動更新を無効にするには、 0 を設定して下さい。デフォルト値は 2.0 秒です。 (0.12 以降) |
| auto_reload | 変更があった後、テンプレートファイルを自動的に再読込するかを設定します。 |
| backup_dir | データベースのバックアップ作成位置を設定します。 |
| base_url | Trac がデプロイされている URL を設定します。 ドキュメントを生成するときに使用される base URL です。 Web でブラウズできるコンテキスト外で利用されます。たとえば、 通知メールで Trac のリソースを指す URL を挿入する場合 などです。 |
| check_auth_ip | 認証時に、ユーザの IP アドレスをチェックするかどうかを 設定します (0.9 以降) 。 |
| database | このプロジェクトのデータベースに接続する 文字列 を設定します。 |
| debug_sql | DEBUG レベルのログとして SQL クエリを出力します。 (0.11.5 以降) |
| default_charset | 文字コードが設定されていないときのデフォルト値を設定します。 |
| default_handler | ベース URL へのリクエストを処理するコンポーネント名を設定します。 オプションには TimelineModule, RoadmapModule, BrowserModule, QueryModule, ReportModule, TicketModule, WikiModule などが 使用できます。デフォルトは WikiModule です。 (0.9 以降) |
| default_timezone | デフォルトのタイムゾーンを指定します。 |
| genshi_cache_size | テンプレートローダーがメモリ内にキャッシュできるテンプレートの最大値 です。デフォルト値は 128 です。あなたのサイトがとても多くのテンプレートを使用している場合、 そしてあなたが十分なメモリを割くことができるならば、 より大きい値を選択したいかもしれません。もしメモリに余裕がなければ、値を小さくすることが できます。 |
| htdocs_location | 静的なリソースへアクセスするためのベース URL を指定します。 |
| ignore_auth_case | ログイン名をすべて小文字に変換してから使用するかを設定します (0.9 以降) 。 |
| mainnav | ナビゲーションバーの mainnav に表示する項目の順序を ID のリストで設定します。詳しくは TracNavigation を参照してください。 |
| metanav | ナビゲーションバーの metanav に表示する項目の順序を ID のリストで設定します。詳しくは TracNavigation を参照してください。 |
| mysqldump_path | MySQL データベースバックエンドをバックアップするために使用する mysqldump のパスを設定します |
| never_obfuscate_mailto | Wiki に記載されたあいまいな mailto: をリンクから除外します。 この設定は show_email_addresses や EMAIL_VIEW パーミッションの 設定に優先します (0.11.6 以降)。 |
| permission_policies | IPermissionPolicy を実装するコンポーネントのリストを設定します。設定されている 順に適用されます。これらのコンポーネントは、 Trac リソースへの細かい アクセスコントロールを行います。 デフォルトは DefaultPermissionPolicy (0.11 より前のふるまい) と LegacyAttachmentPolicy (ATTACHMENT_* パーミッションをレルム固有にパーミッションに マップします) です。 |
| permission_store | IPermissionStore を実装しているコンポーネント名を設定します。 ユーザとグループのパーミッションの管理のために使用されます。 |
| pg_dump_path | Postgres データベースバックエンドをバックアップするために使用する pg_dump のパスを設定します |
| repository_dir | デフォルトのリポジトリへのパスを指定します。相対パスをしようできます (0.11 以降)。 このオプションは将来廃止予定です。リポジトリは TracIni#repositories-section repositories セクションにて定義されるか Web アドミンの "リポジトリ" パネルで使用されます (0.12 以降) |
| repository_sync_per_request | ページリクエスト毎に同期処理を行なうリポジトリ のリスト。 このオプションは、すべてのリポジトリの post-commit フックで、 trac-admin $ENV changeset added を呼んでいるならば空に設定して下さい。 ( 推奨 ) そうでなければ、カンマ区切りでリポジトリの名前を 設定して下さい。 Note: この設定は、性能にマイナスの影響を与えます。 そして、 changeset リスナがここで指定したリポジトリからのイベントの受信することを 妨げます。後方互換性を保つためにデフォルト値はデフォルトに設定したリポジトリを 設定しています。 (0.12 以降) |
| repository_type | リポジトリの種類を指定します。 (0.10 以降) このオプションは、 TracIni#repositories-section repositories に 定義されているデフォルトのリポジトリの種類として使用されるか Web アドミンの "リポジトリ" パネルで使用されます。 (0.12 以降) |
| request_filters | すべてのリクエストに適用するフィルタの適用順を設定します (0.10 以降)。 |
| resizable_textareas | <textarea> フィールドのサイズ変更を可能にします。. JavaScript が必要です。 (0.12 以降) |
| secure_cookies | Cookie を HTTPS 接続で使用します。 True に設定された場合、すべての Cookie に secure フラグを付与 することで、 HTTPS 接続でサーバに送信されるようにします。このオ プションは Trac への接続に HTTPS が使える場合だけ、使用するよう にしてください。 (since 0.11.2 以降) |
| show_email_addresses | ユーザ名の代わりにメールアドレスを表示します。 false の場合、 メールアドレスはわかりづらくなります (0.11 以降)。 |
| show_ip_addresses | リソース (Wiki など) を編集した IP アドレスを表示します (0.11.3 以降)。 |
| timeout | データベース接続のタイムアウト秒数を設定します。 '0' を指定すると、 タイムアウトなし になります。 (0.11 以降) |
| use_base_url_for_redirect | [trac] base_url をリダイレクトにも使用するか設定します。 Trac を HTTP プロキシの背後で動作させる設定下では、 自動ではアクセスに使用された URL を再構成できないため、 このオプションを使って、強制的に base_url の設定先にリダイレクトするよう Trac を設定する必要があります。この使用で制限事項が追加されます。 その Environment はリダイレクト先として使用される URL からアクセスしないと 使いづらくなります。 (0.10.5 以降) |
[wiki]
| ignore_missing_pages | 存在しないページへの CamelCase リンクをハイライトするかどうかを設定します (0.9 以降). |
| max_size | Wiki ページで許容する最大のページサイズを設定します。 (0.11.2 以降) |
| render_unsafe_content | <script> や <embed> のようなセキュリティ上安全とはいえない HTML タグを HTML Wiki プロセッサ で使用可能にするかどうかを設定します。 (0.10.4 以降). 誰でも Wiki を編集できるような公開サイトでは、このオプションを無効に 設定しておくことを推奨します。 (デフォルトは、無効に設定されています)。 |
| split_page_names | スペースで WikiPageNames を区切るのを可能にするかどうかを設定します (0.10 以降). |
特殊なセクションのリファレンス
[components]
このセクションは Trac 本体も含めて、プラグインによって提供されるコンポーネントの有効/無効を設定するために使います。有効/無効を設定するコンポーネントは、オプションの名前 (name) を使って特定します。コンポーネントが有効かどうかはオプションの値 (value) によって決定されます; コンポーネントを有効にするには、値を enabled または on に設定します。他の値 (一般的には disabled または off) の場合、コンポーネントは無効になります。
オプションの名前はコンポーネントの完全修飾名、もしくは、コンポーネントのモジュール/パッケージ プレフィックスとなっています。前者は 特定のコンポーネントの有効/無効を設定し、後者は特定のパッケージ/モジュール内のコンポーネントの有効/無効を設定します。
以下の設定ファイルの抜粋を見てください:
[components] trac.ticket.report.ReportModule = disabled webadmin.* = enabled
最初のオプションは レポートモジュール を使用しないように Trac を設定しています。二つ目のオプションは webadmin パッケージのすべてのコンポーネントを使用できるように設定しています。末尾のワイルドカードはモジュール/パッケージのマッチを行う場合、必須です。
アクティブなコンポーネントの一覧を取得するには、 Trac について (訳注: 英語版では About Trac) の Plugins ページを参照してください。 (CONFIG_VIEW パーミッション が必要となります。)
See also: TracPlugins
[milestone-groups]
(0.11 以降)
今やチケットのワークフローは変更可能です。チケットステータスを数多く持つことができます。 単に解決した (closed) チケットと、その他のチケットを対比して表示することが、すべてのケースで 適切とは言えなくなりました。このセクションでは、簡単にステータスの グループ を作成ができます。 グループはマイルストーンのプログレスバーで異なった色で表示させることができます。
設定の例 (closed と active しか持たない場合):
closed = closed # sequence number in the progress bar closed.order = 0 # optional extra param for the query (two additional columns: created and modified and sort on created) 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 # indicates groups that count for overall completion closed.overall_completion = truepercentage new = new new.order = 1 new.css_class = new new.label = new # one catch-all group is allowed active = * active.order = 2 # CSS class for this interval active.css_class = open # Displayed label for this group active.label = in progress
グループの定義は、含めるステータスをカンマ区切りのリストにして構成します。 また、 '*' はあらゆるステータスを意味し、残りのすべてのステータスをキャッチオールグループに 関連付けます。
CSS クラスは次のいずれかを設定します: new (黄色), open (無色), closed (緑色)。 新しくスタイルを追加するには、以下のセレクタを使用します: table.progress td.<class>
[repositories]
(0.12 以降 のマルチリポジトリ)
trac.ini の [repositories] セクションに設定できることは、新しいリポジトリを登録すること以外にもあります。
使い勝手を増すエイリアスや、一時的なリポジトリ、インストール時の初期状態などを設定することができます。
このセクションとその他諸々の書き方についての詳細は TracRepositoryAdmin を参照してください。
[svn:externals]
(0.11 以降)
Subversion 向けの TracBrowser は、フォルダの svn:externals 属性を解釈できます。 デフォルトでは URL をリンクとして処理できるだけであり、 Trac 自身はリモートとなるリポジトリをブラウズすることはできません。
しかしながら、別の Trac インスタンス (または ViewVC のような別のリポジトリブラウザ) がリンク先のリポジトリにをブラウズできるように設定されていれば、別のリポジトリブラウザを指す外部の URL を Trac に設定しておくことができます。
このマッピングは 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 という external は http://ourserver/tracs/tools/browser/tags/1.1/tools?rev= にマップされます (rev は external にリビジョンが指定された場合、適切なリビジョン番号に設定されます。詳細は SVN Book の externals を参照してください)。
Note: 番号はセクション内でのキー項目としてだけ使用されます。 URL 自身はキー項目として扱うことが出来ないという、設定ファイルのパーサの制限事項を回避するためです。
最後に Subversion 1.5 で導入された相対 URL は、現在のところサポートしていません。
[ticket-custom]
このセクションでは、チケットに追加フィールドを定義することができます。詳しくは TracTicketsCustomFields を参照してください。
[ticket-workflow]
(0.11 以降)
チケットのワークフローはプラグインで制御します。 デフォルトでは ConfigurableTicketWorkflow コンポーネントが制御を行います。 このコンポーネントでは、 trac.ini ファイルのこのセクションでワークフローを設定することが可能です。 詳細は TracWorkflow を参照してください。
See also: TracGuide, TracAdmin, TracEnvironment
