![(trac.ini の [header_logo] セクションを設定してください)](/trac/SampleProject/chrome/site/your_project_logo.png){kind=logo}
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 が指定されていれば、設定ファイルは順次読み込まれます。
Note: TracEnvironment の templates/ ディレクトリ内のテンプレートは、 [inherit] templates_dir で見つかるテンプレートより優先されます。次に、[inherit] templates_dir のテンプレートはインストールされているテンプレートより優先されます。これらを設定するには注意が必要です。特に、デフォルトのテンプレートをオーバーライドする場合、 Trac を新しいバージョンにアップデートする際には必ず変更点を再読み込みして下さい。 ( TracInterfaceCustomization を行うために推奨する方法は、適切に ITemplateStreamFilter の変更が行えるカスタムプラグインを作成することです。)
リファレンス
現在利用できる設定項目のリファレンスとデフォルトの設定です。(訳注: 0.12 ではデフォルトの値は表示されません。)
[account-manager]
| account_changes_notify_addresses | List of email addresses that get notified of user changes, ie, new user, password change and delete user. |
| authentication_url | |
| force_passwd_change | Forge the user to change password when it's reset. |
| generated_password_length | Length of the randomly-generated passwords created when resetting the password for an account. |
| hash_method | |
| htdigest_realm | |
| notify_actions | Comma separated list of actions to notify of. Available actions 'new', 'change', 'delete'. |
| password_file | Path to the users file. Leave blank to locate the users file by reading svnserve.conf |
| password_format | |
| password_store | |
| persistent_sessions | Allow the user to be remembered across sessions without needing to re-authenticate. This is, user checks a "Remember Me" checkbox and, next time he visits the site, he'll be remembered |
| reset_password | Set to false if there is no email system setup. |
[attachment]
| max_size | チケットと Wiki の添付ファイルの最大サイズをバイト数で 指定します。 |
| render_unsafe_content | 添付ファイルをブラウザ上に表示するか、 単にダウンロード可能にしておくかどうかを設定します。 ブラウザがほとんどのファイルを HTML として解釈することがあるため、 悪意のあるユーザにクロスサイトスクリプティング攻撃を可能にするファイル の添付を許すことになります。 誰でもファイルを添付できるような公開サイトでは、このオプションを無効に 設定しておくことを推奨します (デフォルトは、無効に設定されています)。 |
[autowikify]
| exclude | List of Wiki pages to exclude from auto-wikification. |
| explicitly_wikify | List of Wiki pages to always Wikify, regardless of size. |
| minimum_length | Minimum page length to perform auto-wikification on. |
[batchmod]
| fields_as_list | field names modified as a value list(separated by ',') |
| list_connector_string | connecter string for 'list' fields |
| list_separator_regex | separator regex used for 'list' fields |
[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 フォーマットをチェンジセットのログメッセージに適用するかどうかを設定します。 このオプションが無効になっている場合、チェンジセットのログメッセージは 整形済みテキストとして表示されます。 |
[complete-user]
| composite_fields | 複数ユーザを補完するフィールド設定します。 |
| name_check | ユーザを検索する際にNameが設定されているユーザのみを検索するかどうかを設定します。 |
| popup_delay | 補完ウィンドウのポップアップ表示までの遅延時間を設定します。 単位は秒で小数点も利用することができます |
| single_fields | 単一ユーザを補完するフィールド設定します。 |
[datefield]
| change_month | Show a month dropdown in datepicker? |
| change_year | Show a year dropdown in datepicker? |
| first_day | First day of the week. 0 == Sunday. |
| format | The format to use for dates. Valid values are dmy, mdy, and ymd. |
| match_request | Additional request paths to match (use input class="datepick") |
| milestone | Use datepicker for milestone due/completed fields? If you turn this on, you must use MM/DD/YYYY for the date format. Set format to mdy and separator to / (default=Off) |
| months | Number of months visible in datepicker |
| panel | Show button panel at bottom? (Today, Done) |
| separator | The separator character to use for dates. |
| weeknumbers | Show ISO8601 week number in calendar? |
[discussion]
| default_message_display | Default display mode for topic messages list. |
| default_topic_display | Default display mode for forum topics list. |
| forum_sort | Column by which will be sorted forum lists. Possible values are: id group name subject time moderators description topics replies lasttopic lastreply |
| forum_sort_direction | Direction of forum lists sorting. Possible values are: asc desc. |
| messages_per_page | Number of messages per page in message list. |
| topic_sort | Column by which will be sorted topic lists. Possible values are: id forum subject time author body replies lastreply. |
| topic_sort_direction | Direction of topic lists sorting. Possible values are: asc desc. |
| topics_per_page | Number of topics per page in topic list. |
[ganttcalendar]
| complete_conditions | The resolutions to change the ticket progress to 100% when ticket closed |
| complete_field | Field define progress value for ticket. |
| default_zoom_mode | Default zoom mode in gantchar. (default: 3) |
| first_day | Begin of week: 0 == Sunday, 1 == Monday (default: 0) |
| format | Date format for due assign and due finish |
| show_ticket_summary | Show ticket summary at gantchart bar. (default: false) |
| show_weekly_view | Set weekly view as default in calendar. (default: false) |
[git]
| cached_repository | wrap GitRepository in CachedRepository |
| git_bin | path to git executable (relative to trac project folder!) |
| git_fs_encoding | define charset encoding of paths within git repository |
| persistent_cache | enable persistent caching of commit tree |
| shortrev_len | length rev sha sums should be tried to be abbreviated to (must be >= 4 and <= 40) |
| trac_user_rlookup | enable reverse mapping of git email addresses to trac user ids |
| use_committer_id | use git-committer id instead of git-author id as changeset owner |
| use_committer_time | use git-committer-author timestamp instead of git-author timestamp as changeset timestamp |
| wiki_shortrev_len | minimum length of hex-string for which auto-detection as sha id is performed (must be >= 4 and <= 40) |
[header_logo]
| alt | ヘッダロゴに使用する alt テキストを設定します。 |
| height | ヘッダロゴの高さを pixel で設定します。 |
| link | ヘッダロゴがリンクする URL を設定します。 |
| src | ヘッダロゴに使用するイメージファイルの URL を設定します。 絶対パス、サーバー上の相対パスまたは、一般的な相対パスが使用できます。 相対パスの場合、一つはロケーション /chrome からの相対パスにします: your-logo.png が TracEnvironment の htdocs に位置するならば、 site/your-logo.png を設定します: your-logo.png が htdocs_location URL に マッピングされたフォルダに位置しているならば、 common/your-logo.png を設定します。 単に your-logo.png と指定した場合は、後者の設定と同等になります。 |
| width | ヘッダロゴの幅を pixel で設定します。 |
[hg]
| encoding | Encoding that should be used to decode filenames, file content, and changeset metadata. If multiple encodings are used for these different situations (or even multiple encodings were used for filenames), simply specify a list of encodings which will be tried in turn (since 0.12.0.24). |
| hgrc | Optional path to an hgrc file which will be used to specify extra Mercurial configuration options (see http://www.selenic.com/mercurial/hgrc.5.html). |
| node_format | Specify how the commit SHA1 hashes should be displayed. Possible choices are: 'short', the SHA1 hash is abbreviated to its first 12 digits, or 'hex', the hash is shown in full. |
| show_rev | Show decimal revision in front of the commit SHA1 hash. While this number is specific to the particular clone used to browse the repository, this can sometimes give an useful hint about the relative "age" of a revision. |
[hudsonplus]
| display_in_new_tab | Open Jenkins page in new tab/window |
| hudson_url | The url of the jenkins top page. This must be an absolute url. This plugin uses this to get information through Jenkins Remote API. |
| jobs | Jobs to display on timeline separated by comma. If you don't specify this at all, show all jobs. |
| main_page | The url of the jenkins main page to which the trac nav entry should link; if empty, no entry is created in the nav bar/timeline/wikimacro. This may be a relative url. |
| navigation_label | The label of navigation tab. |
| password | The password to use to access Jenkins |
| username | The username to use to access Jenkins |
[inherit]
| plugins_dir | 共有するプラグインをおくディレクトリ のパスを指定します。 このディレクトリに配置されたプラグインは、 Environemnt の plugins ディレクトリのプラグインに加えて、 優先してロードされます。 (0.11 以降) |
| templates_dir | 共有するテンプレートディレクトリ のパスを指定します。 指定したパスは環境の templates ディレクトリに加えてロードされますが、 templates ディレクトリが優先となります。 (0.11 以降) |
[iniadmin]
| excludes | Excludes this options. Comma separated list as section:name. |
| passwords | Show input-type as password instead of text. Comma separated list as section:name. |
[logging]
| log_file | log_type が file のときのログファイルへのパスを設定します。 相対パスは TracEnvironment の log ディレクトリ"からの相対パスとして 解決します。 |
| 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 以降) |
| pygments_default_style | Pygments でのシンタックスハイライトでデフォルトで使われるスタイルを設定します。 |
| pygments_modes | Pygments が処理できるMIME タイプを追加します。 それぞれのエントリは mimetype:mode:quality というタプルで 設定しなければなりません。 mimetype には MIME タイプを、 mode には変換に使用する Pygments のモードを、 quality には変換に関連する quality ratio を 設定します。 quality で設定した値で、 Pygments のデフォルトの quality ratio を上書きします。 |
| tab_width | ファイルをプレビューするときのタブの表示幅を設定します。 (0.9 以降) |
| treat_as_binary | バイナリデータとして取り扱う MIME タイプをカンマ区切りのリストで 設定します。 (0.11.5 以降) |
| xdoc2txt_path | path to xdoc2txt |
[notification]
| admit_domains | メールアドレスとして有効とするドメインをカンマ区切りで設定します。 (localdomain など) |
| always_notify_owner | チケットの担当者 (owner) に常に通知メールを送信するかを設定します (0.9 以降) 。 |
| always_notify_reporter | 報告者 (reporter) フィールドにあるアドレスに常に通知メールを 送信するかを設定します。 |
| always_notify_updater | チケット属性が変更された場合に、それまでの全ての変更を行った人に、 常に通知メールを送信するかを設定します。 |
| ambiguous_char_width | 幅の曖昧な文字 (例えば、'single' や 'double') が 通知メールのテーブルに使えるようになりました。 'single' の場合、US-ASCII 文字と同じ文字幅です。これは、 ほとんどのユーザーから要求されています。 'double' の場合、US-ASCII 文字の2倍の文字幅となります。これは、 CJK ユーザーから要求されています。(0.12.2 以降) |
| 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 | プロジェクトのメインとなる ウェブサイトの 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 以降) |
[querychart]
| order | status order |
[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 | 検索ページでデフォルトで無効化の対象とする検索フィルタを 設定します。ここに設定した値はクイックサーチの機能でも適用 されます。デフォルトで定義されているフィルタ名は: Wiki, チケット, マイルストーン, チェンジセット (英語版では wiki, ticket, milestone, changeset) です。 プラグインの場合、ISearchSource インターフェースの実装による get_search_filters() メソッドの戻り値であるタプルの第1項目 を探します。無効化した検索フィルタは、検索ページ上で、 ユーザの操作によって再度有効にすることができます。 (0.12 以降) |
| min_query_length | 検索を実行するときに許容するクエリ文字列の最短の長さを設定します。 |
[section-edit]
| preview_whole_page | |
| serve_ui_files |
[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 |
[theme]
| enable_css | Enable or disable custom CSS from theme. |
| theme | The theme to use to style this Trac. |
[ticket]
| commit_ticket_update_check_perms | Check that the committer has permission to perform the requested operations on the referenced tickets. This requires that the user names be the same for Trac and repository operations. |
| commit_ticket_update_commands.close | Commands that close tickets, as a space-separated list. |
| commit_ticket_update_commands.refs | Commands that add a reference, as a space-separated list. If set to the special value <ALL>, all tickets referenced by the message will get a reference to the changeset. |
| commit_ticket_update_envelope | Require commands to be enclosed in an envelope. Must be empty or contain two characters. For example, if set to "[]", then commands must be in the form of [closes #4]. |
| commit_ticket_update_notify | Send ticket change notification when updating a 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_language | ユーザ設定がない場合に使用するデフォルトの言語を指定します。 (0.12.1 以降) |
| default_timezone | デフォルトのタイムゾーンを指定します。 |
| genshi_cache_size | テンプレートローダーがメモリ内にキャッシュできるテンプレートの最大値 です。デフォルト値は 128 です。あなたのサイトがとても多くのテンプレートを使用している場合、 そしてあなたが十分なメモリを割くことができるならば、 より大きい値を選択したいかもしれません。もしメモリに余裕がなければ、値を小さくすることが できます。 |
| htdocs_location | /chrome/common/ 配下の静的なリソースを提供するための ベース URL を指定します。 空のままにしておくこともできます。この場合、 Trac はただ単にこれらの リソースをそのまま提供します。 アドバンスドユーザーはこのオプションを trac-admin ... deploy <deploydir> と共に使用することで、 Trac の静的リソースをウェブサーバーから直接提供するようにすることができます。 しかし、このオプションは <deploydir>/htdocs/common にのみ 適用可能であることを覚えていて下さい。デプロイされたその他のリソース ( 例 plugins ディレクトリのリソース ) はこの方法を使用することはできません。追加でウェブサーバーに リライトルールを設定する必要があります。 |
| 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 以降)。 このオプションは将来廃止予定です。リポジトリは 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 以降) |
[tracbzr]
| include_sideline_changes | Include sideline changes in the list of changes. This option controls whether sideline changes (i.e. changes with dotted revision numbers only) are included in the list of changes as reported by the timeline view. Note that there might be other plugins using that information as well, so there might be other components beside the timeline view that get affected by this setting. Defaults to True. |
| primary_branches | Ordered list of primary branches. These will be listed first in the Branches macro. When viewing the timeline, each changeset will be associated with the first primary branch that contains it. The value is a comma separated list of globs, as used by the fnmatch module. An empty list element can be used to denote the branch at the root of the repository. Defaults to 'trunk'. |
[tracwysiwyg]
| wysiwyg_stylesheets | Add stylesheets to the WYSIWYG editor |
[user_manager]
| admin_default_panel | Default user admin panel. |
| attribute_provider | Name of the component implementing IAttributeProvider, which is used for storing user attributes |
| user_store | Name of the component implementing IUserStore, which is used for storing project's team |
| wiki_page_attachment | Wiki Page used by TracUserManager? plugin to manage UserProfile?'s picture. |
[versioncontrol]
| allowed_repository_dir_prefixes | リポジトリの管理パネルにリポジトリを追加または編集を行なう際に 許容するリポジトリのディレクトリのプレフィックスのカンマ区切りのリストです。 リストが空の場合、すべてのリポジトリのディレクトリが許容されます。 (0.12.1 以降) |
[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 を編集できるような公開サイトでは、このオプションを無効に 設定しておくことを推奨します。 (デフォルトは、無効に設定されています)。 |
| safe_schemes | "安全" だとみなす URI スキームのリストです。 [wiki] render_unsafe_content の設定が false であったとしても、これらのスキームは外部リンクとしてレンダリングされます (0.11.8 以降) |
| 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 percentage closed.overall_completion = true 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
