TracIniの詳細カスタマイズ

Tracの標準ドキュメントと、より詳細な記載を合わせて紹介します。テーブルで表示されているものが詳細ドキュメントで、Trac-0.10.3-ja標準添付のもの（つまり、インタアクト社の方が翻訳したドキュメント）です。その下にあるのは私が書いたコメントです。

Error: Failed to load processor TOC

No macro or processor named 'TOC' found

大きな添付ファイルをアップロードしたい

添付ファイルの最大サイズはデフォルトでは262144バイトです。小さいですね。イントラネットで使うなら3MB位にしといたほうがいいかと。 trac.iniを以下のように指定します。（参照： TracIni ）

[attachment]
max_size = ファイルの最大サイズ(バイト単位)

サーバのリソースやイントラかインターネットかを含めて変更しましょう。

ちなみに MailArchive プラグインでも、添付ファイルのサイズはこの指定に従います。

[attachment]

max_size	チケットと Wiki の添付ファイルの最大サイズをバイト数で 指定します。
render_unsafe_content	添付ファイルをブラウザ上に表示するか、 単にダウンロード可能にしておくかどうかを設定します。 ブラウザがほとんどのファイルを HTML として解釈することがあるため、 悪意のあるユーザにクロスサイトスクリプティング攻撃を可能にするファイル の添付を許すことになります。 誰でもファイルを添付できるような公開サイトでは、このオプションを無効に 設定しておくことを推奨します (デフォルトは、無効に設定されています)。

max_sizeについて

添付ファイルの最大サイズを指定します。デフォルトでは262144バイトです。小さいですね。イントラネットで使うなら3MB位にしといたほうがいいかと。サーバのリソースやイントラかインターネットかを含めて変更しましょう。

ちなみに MailArchive プラグインでも、添付ファイルのサイズはこの指定に従います。

[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 以降)

downloadable_pathsについて

Trac0.10からの機能で、リポジトリブラウザからファイルをzip形式でダウンロードできるようになっています。どのフォルダをダウンロード可能にするかをここで指定します。
設定しておくと、リポジトリブラウザでフォルダを開いたときに、下のほうに「Zip Archive」というリンクができます。

デフォルトでは/trunkはダウンロードできますが、/trunkの下はダウンロードできません。このサイトのように/trunkの下に機能別にフォルダを作っている場合や、/trunkではサイズが大きすぎる場合は、 /trunkの下のフォルダを指定しておくといいでしょう。
たとえば、/trunk/*と指定すると、trunk自体はダウンロード不可になり、trunkの下のフォルダ（その配下も）がダウンロード可能になります。 /trunk/mailarchiveと指定すると、指定したフォルダのみがダウンロード可能になります。

ちなみに、 Tracリンク ではダウンロード用の直リンクをつくることはできないようです。 http...と書いて外部リンクのようにするのが嫌なら、 DownloadsPlugin を使ってみるといいかもしれません。

[header_logo]

alt	ヘッダロゴに使用する alt テキストを設定します。
height	ヘッダロゴの高さを pixel で設定します。
link	ヘッダロゴがリンクする URL を設定します。
src	ヘッダロゴに使用するイメージファイルの URL を設定します。
width	ヘッダロゴの幅を pixel で設定します。

左上に表示されるロゴの画像をここで変更できます。heightとwidthに-1を指定すると、画像ファイルのサイズがそのまま使われるようです。

[logging]

log_file	log_type が file のときのログファイルへのパスを設定します。
log_format	ログのフォーマットをカスタマイズします。 デフォルトでは以下のフォーマットが使用されます : Trac[$(module)s] $(levelname)s: $(message)s Python のロガーライブラリがサポートしている標準のキー (http://docs.python.org/lib/node422.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) の、どれかでなければなりません。

log_type=fileにしておき、log_fileに出力パスを指定すると、ログがファイル出力されます。プラグインを入れたのに表示されない場合などは、ログ出力するよう指定しておくと、原因がつかめたりします。

[wiki]

ignore_missing_pages	存在しないページへの CamelCase リンクをハイライトするかどうかを設定します (0.9 以降).
render_unsafe_content	<script> や <embed> のようなセキュリティ上安全とはいえない HTML タグを HTML Wiki プロセッサ で使用可能にするかどうかを設定します。 (0.10.4 以降). 誰でも Wiki を編集できるような公開サイトでは、このオプションを無効に 設定しておくことを推奨します。 (デフォルトは、無効に設定されています)。
split_page_names	スペースで WikiPageNames を区切るのを可能にするかどうかを設定します (0.10 以降).

ignore_missing_pagesについて

wikiを理解している人が少ない環境でTracを使う場合は、ignore_missing_pages = trueにするのがオススメ。意図せずCamelCaseを書いても、?とか表示されなくなります。

aa

TracをApacheで動かした場合、なにも設定しないと静的リソース(PNGファイルとかCSSとか)へのリクエストは、一度tracがファイルを読み込んでレスポンスを生成するという動きをします。

特にプラグインをいっぱい組み込んでいる場合、静的リソースへアクセスに対してもいろんなプラグインが動いてしまい、無駄なCPUリソースを使ってしまいます。レスポンスにも目に見えて影響があります。

テストはテスト