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を書いても、?とか表示されなくなります。