| 1 | = reStructuredText における TracLinks = #TracLinksinreStructuredText |
| 2 | |
| 3 | このドキュメントは reStructuredText での ``..trac::`` ディレクティブの使い方を説明します。 |
| 4 | |
| 5 | {{{ |
| 6 | {{{ |
| 7 | #!rst |
| 8 | |
| 9 | 例: |
| 10 | * チケット: :trac:`#1`, :trac:`ticket:1` |
| 11 | * チケットのコメント: :trac:`comment:ticket:1:2` |
| 12 | * レポート: :trac:`{1}`, :trac:`report:1` |
| 13 | * チェンジセット: :trac:`r1`, :trac:`[1]`, :trac:`changeset:1` |
| 14 | * リビジョンログ: :trac:`r1:3`, :trac:`[1:3]`, :trac:`log:@1:3`, :trac:`log:trunk@1:3` |
| 15 | * Diff (バージョン 0.10 以降): :trac:`diff:@20:30`, :trac:`diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default`, :trac:`diff:trunk/trac@3538//sandbox/vc-refactoring/trac@3539` |
| 16 | * Wiki ページ: :trac:`CamelCase`, :trac:`wiki:CamelCase` |
| 17 | * マイルストーン: :trac:`milestone:1.0` |
| 18 | * 添付ファイル: :trac:`attachment:ticket:944:attachment.1073.diff` |
| 19 | * ファイル: :trac:`source:trunk/COPYING` |
| 20 | * 特定のリビジョンのファイル: :trac:`source:/trunk/COPYING@200` |
| 21 | * 特定のリビジョンのファイルの特定の行: :trac:`source:/trunk/COPYING@200#L25` |
| 22 | |
| 23 | }}} |
| 24 | }}} |
| 25 | |
| 26 | docutils がインストールされていれば、上記のブロックは以下のように表示されます: |
| 27 | ---- |
| 28 | {{{ |
| 29 | #!rst |
| 30 | |
| 31 | 例: |
| 32 | * チケット: :trac:`#1`, :trac:`ticket:1` |
| 33 | * チケットのコメント: :trac:`comment:ticket:1:2` |
| 34 | * レポート: :trac:`{1}`, :trac:`report:1` |
| 35 | * チェンジセット: :trac:`r1`, :trac:`[1]`, :trac:`changeset:1` |
| 36 | * リビジョンログ: :trac:`r1:3`, :trac:`[1:3]`, :trac:`log:@1:3`, :trac:`log:trunk@1:3` |
| 37 | * Diff (バージョン 0.10 以降): :trac:`diff:@20:30`, :trac:`diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default`, :trac:`diff:trunk/trac@3538//sandbox/vc-refactoring/trac@3539` |
| 38 | * Wiki ページ: :trac:`CamelCase`, :trac:`wiki:CamelCase` |
| 39 | * マイルストーン: :trac:`milestone:1.0` |
| 40 | * 添付ファイル: :trac:`attachment:ticket:944:attachment.1073.diff` |
| 41 | * ファイル: :trac:`source:trunk/COPYING` |
| 42 | * 特定のリビジョンのファイル: :trac:`source:/trunk/COPYING@200` |
| 43 | * 特定のリビジョンのファイルの特定の行: :trac:`source:/trunk/COPYING@200#L25` |
| 44 | |
| 45 | }}} |
| 46 | ---- |
| 47 | |
| 48 | 上記の例のいずれも、異なる記法で書くことができます: |
| 49 | {{{ |
| 50 | {{{ |
| 51 | #!rst |
| 52 | |
| 53 | See _`ticket:123` |
| 54 | |
| 55 | .. trac:: ticket:123 チケット 123 |
| 56 | }}} |
| 57 | }}} |
| 58 | ---- |
| 59 | |
| 60 | {{{ |
| 61 | #!rst |
| 62 | |
| 63 | See _`ticket:123` |
| 64 | |
| 65 | .. trac:: ticket:123 チケット 123 |
| 66 | }}} |
| 67 | ---- |
| 68 | この記法はリンクに対して明示的にラベル (訳注: title 属性ではなく表示される本文) を指定できる利点があります。 |
| 69 | |
| 70 | ---- |
| 71 | See also: WikiRestructuredText, TracLinks |