9 | | * チケット: '''!#1''' or '''!ticket:1''' |
10 | | * チケットのコメント: '''!comment:ticket:1:2''' |
11 | | * レポート: '''!{1}''' or '''!report:1''' |
12 | | * チェンジセット: '''!r1''', '''![1]''', '''!changeset:1''' or (restricted) '''![1/trunk]''', '''!changeset:1/trunk''' |
13 | | * リビジョンログ: '''!r1:3''', '''![1:3]''' or '''!log:@1:3''', '''!log:trunk@1:3''' |
14 | | * Diffs ([http://trac.edgewall.org/milestone/0.10 0.10] 以降): '''!diff:@1:3''', '''!diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default''' or '''!diff:trunk/trac@3538//sandbox/vc-refactoring@3539''' |
15 | | * Wiki ページ: '''CamelCase''' or '''!wiki:CamelCase''' |
| 20 | * チケット: '''!#1''', '''!ticket:1''' |
| 21 | * チケットのコメント: '''!comment:1:ticket:2''' |
| 22 | * レポート: '''!{1}''', '''!report:1''' |
| 23 | * チェンジセット: '''!r1''', '''![1]''', '''!changeset:1''', (ディレクトリを限定) '''![1/trunk]''', '''!changeset:1/trunk''' |
| 24 | * リビジョンログ: '''!r1:3''', '''![1:3]''', '''!log:@1:3''', '''!log:trunk@1:3''', '''![2:5/trunk]''' |
| 25 | * Diff ([http://trac.edgewall.org/milestone/0.10 0.10] 以降): '''!diff:@1:3''', '''!diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default''', '''!diff:trunk/trac@3538//sandbox/vc-refactoring@3539''' |
| 26 | * Wiki ページ: '''!CamelCase''', '''!wiki:CamelCase''' |
| 27 | * 親ページ: '''![..]''' |
25 | | * チェンジセット: r1, [1], changeset:1, or (restricted) [1/trunk], changeset:1/trunk |
26 | | * リビジョンログ: r1:3, [1:3] or log:@1:3, log:trunk@1:3 |
27 | | * Diffs ([http://trac.edgewall.org/milestone/0.10 0.10] 以降): diff:@20:30, diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default or diff:trunk/trac@3538//sandbox/vc-refactoring/trac@3539 |
28 | | * Wiki ページ: CamelCase or wiki:CamelCase |
| 37 | * チェンジセット: r1, [1], changeset:1, (ディレクトリを限定) [1/trunk], changeset:1/trunk |
| 38 | * リビジョンログ: r1:3, [1:3], log:@1:3, log:trunk@1:3, [2:5/trunk] |
| 39 | * Diff ([http://trac.edgewall.org/milestone/0.10 0.10] 以降): diff:@1:3, diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default, diff:trunk/trac@3538//sandbox/vc-refactoring/trac@3539 |
| 40 | * Wiki ページ: CamelCase, wiki:CamelCase |
| 41 | * 親ページ: [..] |
65 | | TracLinks はとてもシンプルなアイディアですが、実際にはとても複雑な情報網になっています。実際、使う分にはとても直感的で簡単ですし、 "リンクの追跡" がプロジェクトでおこったことやなぜある事象が起こったのかを理解するのにとても役に立ちます。 |
66 | | |
67 | | 以下に示すセクションは特定のリンクの種類の詳細について記述しています。 TracLinks の上級者向けの使用方法も同時に記述します。 |
68 | | |
69 | | == attachment: リンク == |
70 | | |
71 | | 添付ファイルへのリンクのシンタックスは次に示すとおりです: |
72 | | * !attachment:the_file.txt は、現在のオブジェクトに添付されたファイル the_file.txt へのリンクを生成します。 |
73 | | * !attachment:wiki:MyPage:the_file.txt は、 Wiki ページ !MyPage に添付されたファイル the_file.txt へのリンクを生成します。 |
74 | | * !attachment:ticket:753:the_file.txt は、チケット 753 に添付されたファイル the_file.txt へのリンクを生成します。 |
75 | | |
76 | | == ソースファイルへのリンク == |
77 | | |
78 | | source:/some/path 形式のリンクは、パスがディレクトリを示しているならば |
79 | | ディレクトリブラウザを開き、それ以外の場合はリビジョンログを表示します。 |
80 | | また、source:/some/file@123 のように表記することで、特定のリビジョンにリンクしたり、 |
81 | | source:/some/file@latest で、最新のリビジョンにリンクすることもできます。 |
82 | | リビジョンを特定している場合、 !source:/some/file@123#L10 の書式で特定の行にリンクすることができます。 |
83 | | |
84 | | == search: リンクと query: リンク == |
85 | | |
86 | | [wiki:TracSearch#リンク検索 "TracSearch#リンク検索"] と [wiki:TracQuery#TracLinksを使用する "TracQuery#TracLinks を使用する"] 参照。 |
87 | | |
88 | | == !SubWiki リンク == |
89 | | !SubWiki ページへ !SubWiki リンクするには '/' を使います。: |
90 | | {{{ |
91 | | [wiki:WikiPage/SubWikiPage]. |
92 | | }}} |
93 | | |
94 | | == InterWiki リンク == |
| 78 | TracLinks はとてもシンプルなアイディアですが、実際にはとても複雑な情報網になっています。実際、使う分にはとても直感的で簡単ですし、 "リンクを追跡する" ことによってプロジェクトでおこったことやなぜある事象が起こったのかを理解するのにとても役に立ちます。 |
| 79 | |
| 80 | |
| 81 | == TracLinks の高度な利用 == #AdvanceduseofTracLinks |
| 82 | |
| 83 | === 相対リンク === #Relativelinks |
| 84 | |
| 85 | ページ内の特定アンカーにリンクするには '#' を使用します: |
| 86 | {{{ |
| 87 | [#Relativelinks 相対リンク] |
| 88 | }}} |
| 89 | 表示: |
| 90 | [#Relativelinks 相対リンク] |
| 91 | |
| 92 | Hint: セクションのタイトルにマウスオーバしたときに、文字 '¶' が表示されます。これはそのセクションへのリンクですので、 `#...` の部分をコピーすれば、相対リンクのアンカーとして使用できます。 |
| 93 | |
| 94 | [http://trac.edgewall.org/wiki/SubWiki SubWiki] ページにリンクするには '/' を使用します: |
| 95 | {{{ |
| 96 | WikiPage/SubWikiPage or ./SubWikiPage |
| 97 | }}} |
| 98 | |
| 99 | [http://trac.edgewall.org/wiki/SubWiki SubWiki] ページから親ページにリンクするには、単に '..' を使用します: |
| 100 | {{{ |
| 101 | [..] |
| 102 | }}} |
| 103 | |
| 104 | [http://trac.edgewall.org/wiki/SubWiki SubWiki] ページから兄弟の位置にあるページにリンクするには '../' を使用します: |
| 105 | {{{ |
| 106 | [../Sibling see next sibling] |
| 107 | }}} |
| 108 | |
| 109 | ''(0.11 で変更された箇所です)'' Trac 0.10 では `[../newticket]` のように書くと、トップレベル URL の /newticket にリンクする動作でした。しかし 0.11 では Wiki の名前空間にとどまり、兄弟の位置にあるページにリンクします。新しいシンタックスについては [#Server-relativelinks サーバ相対リンク] を参照してください。 |
| 110 | |
| 111 | === InterWiki リンク === #InterWikilinks |
98 | | == InterTrac リンク == |
99 | | |
100 | | 上記の TracLinks はすべて一つの TracEnvironment におけるものでした。他の TracEnvironment をあらわすプレフィックスにコロンを付けたものを TracLinks につけると、実際に他の TracEnvironment に存在するリソースを参照します。他の TracEnvironment は登録しなければなりません。詳しくは InterTrac を参照して下さい。 |
101 | | |
102 | | |
103 | | == サーバ上の相対リンク == |
104 | | |
105 | | サーバ上の静的コンテンツや、 `/register` ページ(訳注:一般的なアカウント登録用ページをあらわしています) |
106 | | など、 Trac リンク機能自体ではリンクを生成できないような同じサーバ上のオブジェクトにリンクすることが出来たら便利なこともあるでしょう。 |
107 | | サーバのルートからの絶対パスか |
108 | | 現在のページの URL からの相対リンクを指定するだけで、そのようなことを実現出来るようになりました: |
109 | | |
110 | | {{{ |
111 | | [../newticket newticket] |
| 115 | === InterTrac リンク === #InterTraclinks |
| 116 | |
| 117 | InterWiki リンクと同じ要領で使用できますが、リンクする対象を他の Trac プロジェクトに特化した機能です。 |
| 118 | |
| 119 | プレフィックスとして定義した他の Trac Environment の名前とコロンに続けて、あらゆる種類の Trac リンクを記述することで、一つの Trac Enviroment から他の Trac Environment のリソースを参照することができます。このリモートの Trac Environment は、名前そのものかエイリアスとして、あらかじめ登録しておく必要があります。詳しくは InterTrac を参照してください。 |
| 120 | |
| 121 | InterWiki リンクに対する InterTrac リンクの利点は、 InterTrac リンクが Trac リンクの短縮書式を解釈できることにあります。例えば、チケットへのリンクは `#T234` (T は Trac Project へのエイリアスに設定されているとします) と書くことができ、チェンジセットへのリンクは `[trac 1508]` と書くことができます。 |
| 122 | |
| 123 | === サーバ相対リンク === #Server-relativelinks |
| 124 | |
| 125 | 静的リソースや `newticket` のような固定リンク、 `/register` ページのような |
| 126 | サーバ内で共有するリソースなど、 Trac のリンク機構にビルトインされていない |
| 127 | リソースに対して Project 内でリンクする機能は時折、有用になります。 |
| 128 | |
| 129 | Project 内のリソースにリンクするためには、 Project root からの絶対パスか、 |
| 130 | 現在のページの URL からの相対リンクを使用します (''0.11 で変更された箇所です''): |
| 131 | |
| 132 | {{{ |
| 133 | [/newticket Create a new ticket] |
| 169 | |
| 170 | === パラメータつきの Trac リンク === #ParameterizedTraclinks |
| 171 | |
| 172 | Trac リンクの対象となる Trac リソースは通常、パラメータで制御される複数の表示形式を持っています。例えば、 Wiki ページでは `version` や `format` パラメータを使用でき、レポートでは動的変数の使用ができます。 |
| 173 | |
| 174 | あらゆる種類の Trac リンクは、 URL のクエリパラメータに相当する方法で記述できる。任意の組み合わせのパラメータを持っています。例えば: |
| 175 | - `wiki:WikiStart?format=txt` |
| 176 | - `ticket:1?version=1` |
| 177 | - `[/newticket?component=module1 create a ticket for module1]` |
| 178 | |
| 179 | |
| 180 | == TracLinks リファレンス == #TracLinksReference |
| 181 | 以下に示すセクションは特定のリンクの種類の詳細について記述しています。 TracLinks の上級者向けの使用方法も同時に記述します。 |
| 182 | |
| 183 | === attachment: リンク === #attachment:links |
| 184 | |
| 185 | 添付ファイルへのリンクのシンタックスは次に示すとおりです: |
| 186 | * !attachment:the_file.txt は、現在のオブジェクトに添付されたファイル the_file.txt へのリンクを生成します。 |
| 187 | * !attachment:the_file.txt:wiki:MyPage は、 Wiki ページ !MyPage に添付されたファイル the_file.txt へのリンクを生成します。 |
| 188 | * !attachment:the_file.txt:ticket:753 は、チケット 753 に添付されたファイル the_file.txt へのリンクを生成します。 |
| 189 | |
| 190 | Note: 古い記法ではファイル名を最後に書いていました。この記法はまだ使うことができます: !attachment:ticket:753:the_file.txt |
| 191 | |
| 192 | 添付ファイルページではなく、添付ファイルの内容に直接リンクしたい場合は `attachment:` の代わりに `raw-attachment:` を使用してください。 |
| 193 | |
| 194 | このリンクは HTML ドキュメントなどを直接指す目的では使いやすいですが、この方法を使うためには `[attachment] render_unsafe_content = yes` (See TracIni#attachment-section) を設定し、 Web ブラウザに内容を表示できるように設定しなければなりません。注意: この設定を行うのはファイルを添付するユーザのことを 100% 信頼できる場合だけにしてください。そうでない場合、サイトが [http://ja.wikipedia.org/wiki/クロスサイトスクリプティング クロスサイトスクリプティング] 攻撃に晒されることになります。 |
| 195 | |
| 196 | See also [#export:links]. |
| 197 | |
| 198 | === comment: リンク === #comment:links |
| 199 | |
| 200 | 該当するチケットの内部では、 !comment:3 と書くと 3 番目の更新のコメントにリンクします。 |
| 201 | それ以外の場所であっても、チケットを特定することで、どこからでもコメントへのリンクが可能です: |
| 202 | - !comment:3:ticket:123 |
| 203 | - !ticket:123#comment:3 (Note: !#123#!comment:3! という書き方は間違っています) |
| 204 | |
| 205 | === query: リンク === #query:links |
| 206 | |
| 207 | TracQuery#UsingTracLinks と [#ticket:links] を参照してください。 |
| 208 | |
| 209 | === search: リンク === #search:links |
| 210 | |
| 211 | TracSearch#SearchLinks を参照してください。 |
| 212 | |
| 213 | === ticket: リンク === #ticket:links |
| 214 | |
| 215 | 通常使用される `ticket:id` 形式のほか、 `id` の代わりにチケットのリストやチケットの範囲を指定できます。これはカスタムクエリの検索結果ビューへのリンクを生成します。検索結果は指定したチケット固定です。 |
| 216 | |
| 217 | 例: |
| 218 | - `ticket:5000-6000` |
| 219 | - `ticket:1,150` |
| 220 | |
| 221 | ''(Trac 0.11 以降)'' |
| 222 | |
| 223 | === timeline: リンク === #timeline:links |
| 224 | |
| 225 | タイムラインへのリンクは ISO:8601 形式で日付を指定して生成できます。日付の指定には、任意で時刻の指定を続けることもできます。この時刻は UTC 時刻で解釈されますが、 UTC 時刻を使用したくない場合はタイムゾーンを続けて指定することで、ローカルタイムを使用できます。 |
| 226 | |
| 227 | 例: |
| 228 | - `timeline:2008-01-29` |
| 229 | - `timeline:2008-01-29T15:48` |
| 230 | - `timeline:2008-01-29T16:48Z+01` |
| 231 | |
| 232 | ''(Trac 0.11 以降)'' |
| 233 | |
| 234 | === wiki: リンク === #wiki:links |
| 235 | |
| 236 | WikiPageNames と、このページの [#QuotingspaceinTracLinks Trac リンクで空白文字をエスケープする] を参照してください。 |
| 237 | |
| 238 | === バージョン管理に関連するリンク === #VersionControlrelatedlinks |
| 239 | ==== source: リンク ==== #source:links |
| 240 | |
| 241 | source:/some/path 形式のリンクは、パスがディレクトリを示しているならば |
| 242 | ディレクトリブラウザを開き、それ以外の場合はリビジョンログを表示します。 |
| 243 | |
| 244 | 特定のリビジョンを指定してリンクすることもできます : |
| 245 | - `source:/some/file@123` - file のリビジョン 123 にリンクします。 |
| 246 | - `source:/some/file@head` - file の最新リビジョンにリンクします。 |
| 247 | ディレクトリブラウザを開き、それ以外の場合はリビジョンログを表示します。 |
| 248 | |
| 249 | リビジョンを指定した場合はさらに特定の行番号にリンクすることさえできます : |
| 250 | - `source:/some/file@123#L10` |
| 251 | - `source:/tag/0.10@head#L10` |
| 252 | |
| 253 | さらに、特定の行をハイライト表示することもできます : |
| 254 | - `source:/some/file@123:10-20,100,103#L99` - 10 行目から 20 行目、 100 行目、 103 行目をハイライトします。 |
| 255 | ''(0.11 以降)'' |
| 256 | |
| 257 | ==== export: リンク ==== #export:links |
| 258 | |
| 259 | ブラウザでリンクをクリックしたときに、リポジトリ内をブラウザに表示するのではなく、ダウンロードを強制するためには `export` リンクを使用します。いくつかの形式が使用できます : |
| 260 | * `export:/some/file` - file の最新リビジョンをダウンロードします。 |
| 261 | * `export:123:/some/file` - file の リビジョン 123 をダウンロードします。 |
| 262 | * `export:/some/file@123` - file の リビジョン 123 をダウンロードします。 |
| 263 | |
| 264 | リポジトリにチェックインされている XML や HTML 文書を、正しいスタイルシートと画像で表示する場合などには非常に使いやすいですが、この方法を使うためには `[browser] render_unsafe_content = yes` (See TracIni#browser-section) を設定し、 Web ブラウザに内容を表示できるように設定しなければなりません。設定されていない場合、セキュリティを確保するため、そのファイルを Web ブラウザ上で表示せず、添付ファイルと同じようにダウンロードさせます。 |
| 265 | |
| 266 | 特定のファイルの代わりにリポジトリのディレクトリのパスが指定されると、ソースブラウザはディレクトリを表示します (`source:/some/dir` と同じ) 。 |
| 267 | |
| 268 | ==== log: リンク ==== #log:links |
| 269 | |
| 270 | `log:` リンクはリビジョンの範囲を表示するために使用します。最も単純な形式では、特定パスの最新のリビジョン群へのリンクを生成します。リビジョンを指定することで、最新以外の任意のリビジョンを表示することもできます。 |
| 271 | - `log:/` - リポジトリのルートディレクトリでの最新のリビジョン群 |
| 272 | - `log:/trunk/tools` - `trunk/tools` での最新のリビジョン群 |
| 273 | - `log:/trunk/tools@10000` - `trunk/tools` での 10000 から始まるリビジョン群 (訳注: 10000 以前のリビジョン) |
| 274 | - `log:@20788,20791:20795` - リビジョン 20788 と 20791 から 20795 までの範囲のリビジョンを表示する |
| 275 | - `log:/trunk/tools@20788,20791:20795` - リビジョン 20788 と 20791 から 20795 までの範囲のリビジョンのうち、 `/trunk/tools` に影響したものを表示する |
| 276 | |
| 277 | リビジョン範囲の短縮形式は以下の通りです: |
| 278 | - `[20788,20791:20795]` |
| 279 | - `[20788,20791:20795/trunk/tools]` |
| 280 | - `r20791:20795` (ただし `r20788,20791:20795` や `r20791:20795/trunk` は使用できません) |
| 281 | |
| 282 | 最後に、上記のすべてについて、リビジョン範囲の書式は `x:y` と `x-y` のどちらでも使用することができます。 |
| 283 | |