Version 1 (modified by trac, 16 years ago) (diff) |
---|
TracLinks は Trac の基礎となる機能です。というのも、 TracLinks によってシステムのエントリ間 - チケット、レポート、チェンジセット、Wikiページ、マイルストーン、ソースファイルなど - で簡単にハイパーリンクすることができるからです。
TracLinks は通常、 type:id (id はコンポーネントの 番号や名前、パス) の形式で記述しますが、よく使われるコンポーネントについては、 下の例のように表記を省略することもできます。
例:
表示:
Note: wiki:CamelCase の書式が使われることはほとんどありませんが、 ページ名が WikiPageNames のルールに従っていないページ (一文字、 アルファベット以外の文字、etc.) をリンクしたい場合には便利です。 WikiPageNames に Wiki ページ名へのリンクに関する特記事項が書いてあるので見て下さい。
フル表記の (簡略形でない) Trac リンクでは、次のようにしてリンクタイトルを カスタマイズすることもできます:
[ticket:1 これは1番目のチケットへのリンクです].
表示: これは1番目のチケットへのリンクです.
タイトルが省略された場合、 ID のみ(コロンの後ろ側)が表示されます。
[ticket:1]
表示: 1
もし名前空間の一部が省略されていたら、 wiki がデフォルトの値です。(バージョン 0.10 以降):
[SandBox the sandbox]
表示: the sandbox
TracLinks はとてもシンプルなアイディアですが、実際にはとても複雑な情報網になっています。実際、使う分にはとても直感的で簡単ですし、 "リンクの追跡" がプロジェクトでおこったことやなぜある事象が起こったのかを理解するのにとても役に立ちます。
以下に示すセクションは特定のリンクの種類の詳細について記述しています。 TracLinks の上級者向けの使用方法も同時に記述します。
添付ファイルへのリンクのシンタックスは次に示すとおりです:
source:/some/path 形式のリンクは、パスがディレクトリを示しているならば ディレクトリブラウザを開き、それ以外の場合はリビジョンログを表示します。 また、source:/some/file@123 のように表記することで、特定のリビジョンにリンクしたり、 source:/some/file@latest で、最新のリビジョンにリンクすることもできます。 リビジョンを特定している場合、 source:/some/file@123#L10 の書式で特定の行にリンクすることができます。
TracSearch#リンク検索 と TracQuery#TracLinks を使用する 参照。
SubWiki ページへ SubWiki リンクするには '/' を使います。:
[wiki:WikiPage/SubWikiPage].
他に、プレフィックスを自由に定義して、他の Web アプリケーションのリソースをポイントさせることができます。プレフィックスと対応する Web アプリケーションの URL の定義は特殊な Wiki ページ、 InterMapTxt ページで定義されます。 他の TracEnvironment へのリンクを作ることもできますが、より柔軟に他の TracEnvironment を指す特別な方法があることを覚えておいてください。
上記の TracLinks はすべて一つの TracEnvironment におけるものでした。他の TracEnvironment をあらわすプレフィックスにコロンを付けたものを TracLinks につけると、実際に他の TracEnvironment に存在するリソースを参照します。他の TracEnvironment は登録しなければなりません。詳しくは InterTrac を参照して下さい。
サーバ上の静的コンテンツや、 /register ページ(訳注:一般的なアカウント登録用ページをあらわしています) など、 Trac リンク機能自体ではリンクを生成できないような同じサーバ上のオブジェクトにリンクすることが出来たら便利なこともあるでしょう。 サーバのルートからの絶対パスか 現在のページの URL からの相対リンクを指定するだけで、そのようなことを実現出来るようになりました:
[../newticket newticket] [/ home]
表示: newticket? home
TracLinks のプレフィックスの後ろにスペースを含んだターゲットがある場合、 シングルクォーテーションかダブルクォーテーションで囲みます。 例:
TracLinks が使えるのは:
その他、 WikiFormatting を利用可能なことが明示されているすべてのテキストフィールド。
TracLinks を無効化するには、先頭に '!' (エクスクラメーションマーク)を付けます。
!NoLinkHere. ![42] is not a link either.
表示:
NoLinkHere. [42] is not a link either.
See also: WikiFormatting, TracWiki, WikiPageNames, InterTrac, InterWiki