ナビゲーション
Trac 0.11 以降では、メインナビゲーションとメタナビゲーションのエントリを簡単な方法でカスタマイズできるようになりました。
新しく追加されたコンフィグのセクション [mainnav] と [metanav] を使用すると、ナビゲーション項目に使用されるテキストとリンクをカスタマイズしたり、無効化することができます。
[mainnav] は メインナビゲーションバー (main navigation bar) に対応しています。メインナビゲーションは Wiki, タイムライン (英語版では Timeline), ロードマップ (英語版では Roadmap), リポジトリブラウザ (英語版では Browse Source) のようなエントリを含むバーです。このナビゲーションバーは Trac で有効に設定され、現在のユーザがアクセスできるようになっている、各メインモジュールのデフォルトページにアクセスします。
[metanav] は メタナビゲーションバー (meta navigation bar) に対応しています。メタナビゲーションは通常、メインナビゲーションバーの上、 検索 (英語版では Search) ボックスの下に配置されています。 ログイン (英語版では Log in), ログアウト (英語版では Logout), ヘルプ/ガイド (英語版では Help/Guide) などのエントリが含まれています。このナビゲーションバーは Trac プロジェクト全体の情報や、現在のユーザの情報にアクセスします。
[metanav] セクションには特別なエントリを記述できます: logout.redirect を設定することで、ログアウト後に表示するページを指定できます。
記述可能な URL のフォーマット:
設定内容 | リダイレクト先 |
wiki/Logout | /projects/env/wiki/Logout |
http://hostname/ | http://hostname/ |
/projects | /projects |
今のところ、 コンテキストナビゲーションバー (contextual navigation bar) をカスタマイズすることはできません。コンテキストナビゲーションはメインナビゲーションの下に位置するバーです。
例
以下の例では、 Wiki のスタートページへのリンク名を "Home" に変更して、 "ヘルプ/ガイド" (英語版では "Help/Guide") を非表示にします。 さらに、 "チケットを見る" (英語版では "View Tickets") エントリを特定のレポートにリンクさせます。
TracIni からの引用:
[mainnav] wiki.label = Home tickets.href = /report/24 [metanav] help = disabled logout.redirect = wiki/Logout
See also: TracInterfaceCustomization, and the TracHacks:NavAddPlugin or TracHacks:MenusPlugin (still needed for adding entries)