| 19 | | 例: |
| 20 | | * チケット: '''!#1''', '''!ticket:1''' |
| 21 | | * チケットのコメント: '''!comment:ticket:1:2''' |
| 22 | | * レポート: '''!{1}''', '''!report:1''' |
| 23 | | * チェンジセット: '''!r1''', '''![1]''', '''!changeset:1''', (ディレクトリを限定) '''![1/trunk]''', '''!changeset:1/trunk''', '''![2:5/trunk]''' |
| 24 | | * リビジョンログ: '''!r1:3''', '''![1:3]''', '''!log:@1:3''', '''!log:trunk@1:3''' |
| 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 | | * 親ページ: '''![..]''' |
| 28 | | * マイルストーン: '''!milestone:1.0''' |
| 29 | | * 添付ファイル: '''!attachment:ticket:944:attachment.1073.diff''' |
| 30 | | * ファイル: '''!source:trunk/COPYING''' |
| 31 | | * あるリビジョンのファイル: '''!source:/trunk/COPYING#200''' |
| 32 | | * あるリビジョンのファイルのある行数: '''!source:/trunk/COPYING@200#L25''' |
| 33 | | 表示: |
| 34 | | * チケット: #1, ticket:1 |
| 35 | | * チケットのコメント: comment:ticket:1:2 |
| 36 | | * レポート: {1} or report:1 |
| 37 | | * チェンジセット: r1, [1], changeset:1, (ディレクトリを限定) [1/trunk], changeset:1/trunk, [2:5/trunk] |
| 38 | | * リビジョンログ: r1:3, [1:3], log:@1:3, log:trunk@1:3 |
| 39 | | * Diff ([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, diff:trunk/trac@3538//sandbox/vc-refactoring/trac@3539 |
| 40 | | * Wiki ページ: CamelCase, wiki:CamelCase |
| 41 | | * 親ページ: '''[..]''' |
| 42 | | * マイルストーン: milestone:1.0 |
| 43 | | * 添付ファイル: attachment:ticket:944:attachment.1073.diff |
| 44 | | * ファイル: source:trunk/COPYING |
| 45 | | * あるリビジョンのファイル: source:/trunk/COPYING#200 |
| 46 | | * あるリビジョンのファイルのある行数: source:/trunk/COPYING@200#L25 |
| | 19 | == 概要 == #Overview |
| | 20 | |
| | 21 | ||= Wiki マークアップ =||= 表示 =|| |
| | 22 | {{{#!td |
| | 23 | Wiki ページ :: `CamelCase`, `wiki:CamelCase` |
| | 24 | 親ページ :: `[..]` |
| | 25 | チケット :: `#1`, `ticket:1` |
| | 26 | チケットのコメント :: `comment:1:ticket:2` |
| | 27 | レポート :: `{1}`, `report:1` |
| | 28 | マイルストーン :: `milestone:1.0` |
| | 29 | 添付ファイル :: `attachment:example.tgz` (現在のページの添付ファイル), `attachment:attachment.1073.diff:ticket:944` (絶対パス) |
| | 30 | チェンジセット :: `r1`, `[1]`, `changeset:1`, (特定パス配下) `[1/trunk]`, `changeset:1/trunk` |
| | 31 | リビジョンログ :: `r1:3`, `[1:3]`, `log:@1:3`, `log:trunk@1:3`, `[2:5/trunk]` |
| | 32 | diff :: `diff:@1:3`, `diff:plugins/0.12/mercurial-plugin@9128:9953`, |
| | 33 | `diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default` |
| | 34 | または `diff:trunk/trac@3538//sandbox/vc-refactoring@3539` |
| | 35 | ファイル :: `source:trunk/COPYING`, `source:/trunk/COPYING@200` (バージョン 200 における), `source:/trunk/COPYING@200#L25` (バージョン 200 における, 25 行目) |
| | 36 | }}} |
| | 37 | {{{#!td |
| | 38 | Wiki ページ :: CamelCase, wiki:CamelCase |
| | 39 | 親ページ :: [..] |
| | 40 | チケット :: #1, ticket:1 |
| | 41 | チケットのコメント :: comment:1:ticket:2 |
| | 42 | レポート :: {1}, report:1 |
| | 43 | マイルストーン :: `milestone:1.0` |
| | 44 | 添付ファイル :: `attachment:example.tgz` (現在のページの添付ファイル), `attachment:attachment.1073.diff:ticket:944` (絶対パス) |
| | 45 | チェンジセット :: `r1`, `[1]`, `changeset:1`, (特定パス配下) `[1/trunk]`, `changeset:1/trunk` |
| | 46 | リビジョンログ :: r1:3, [1:3], log:@1:3, log:trunk@1:3, [2:5/trunk] |
| | 47 | diff :: diff:@1:3, diff:plugins/0.12/mercurial-plugin@9128:9953, |
| | 48 | diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default |
| | 49 | または diff:trunk/trac@3538//sandbox/vc-refactoring@3539 |
| | 50 | ファイル :: `source:trunk/COPYING`, `source:/trunk/COPYING@200` (バージョン 200 における), `source:/trunk/COPYING@200#L25` (バージョン 200 における, 25 行目) |
| | 51 | }}} |
| 53 | | フル表記の (簡略形でない) Trac リンクでは、次のようにしてリンクタイトルを |
| 54 | | カスタマイズすることもできます: |
| 55 | | |
| 56 | | {{{ |
| 57 | | [ticket:1 これは1番目のチケットへのリンクです]。 |
| 58 | | }}} |
| 59 | | |
| 60 | | 表示: [ticket:1 これは1番目のチケットへのリンクです]。 |
| 61 | | |
| 62 | | タイトルが省略された場合、 ID のみ (コロンの後ろ側) が表示されます。 |
| 63 | | |
| 64 | | {{{ |
| 65 | | [ticket:1] |
| 66 | | }}} |
| 67 | | |
| 68 | | 表示: [ticket:1] |
| 69 | | |
| 70 | | もし名前空間の一部が省略されていたら、 `wiki` がデフォルトの値です。(''バージョン 0.10 以降''): |
| 71 | | |
| 72 | | {{{ |
| 73 | | [SandBox the sandbox] |
| 74 | | }}} |
| 75 | | |
| 76 | | 表示: [SandBox the sandbox] |
| | 58 | |
| | 59 | {{{#!table class="" |
| | 60 | |||| 完全表記の (簡略形でない) Trac リンクでは、次のようにしてリンクタイトルをカスタマイズすることもできます: || |
| | 61 | {{{#!td |
| | 62 | {{{ |
| | 63 | [ticket:1 これは1番目のチケットへのリンクです] または |
| | 64 | [[ticket:1|これは1番目のチケットへのリンクです]]。 |
| | 65 | }}} |
| | 66 | }}} |
| | 67 | {{{#!td |
| | 68 | [ticket:1 これは1番目のチケットへのリンクです] または |
| | 69 | [[ticket:1|これは1番目のチケットへのリンクです]]。 |
| | 70 | }}} |
| | 71 | |-------------------------------------------------------------------------------------- |
| | 72 | |||| タイトルが省略された場合、 ID のみ (コロンの後ろ側) が表示されます: || |
| | 73 | {{{#!td |
| | 74 | {{{ |
| | 75 | [ticket:1] または [[ticket:2]] |
| | 76 | }}} |
| | 77 | }}} |
| | 78 | {{{#!td |
| | 79 | [ticket:1] または [[ticket:2]] |
| | 80 | }}} |
| | 81 | |-------------------------------------------------------------------------------------- |
| | 82 | |||| 完全表記から名前空間が省略されている場合、デフォルト値として `wiki` が使用されます: || |
| | 83 | {{{#!td |
| | 84 | {{{ |
| | 85 | [SandBox サンドボックス] または |
| | 86 | [[SandBox|サンドボックス]] |
| | 87 | }}} |
| | 88 | }}} |
| | 89 | {{{#!td |
| | 90 | [SandBox サンドボックス] または |
| | 91 | [[SandBox|サンドボックス]] |
| | 92 | }}} |
| | 93 | |-------------------------------------------------------------------------------------- |
| | 94 | |||| ''realm:target'' 形式のリンクで特殊な文字を使用したい場合は、 <...> で囲んでください。 [[br]] (ただし > は使用できません) [[br]] 訳注: target 該当箇所を "" で囲む形式との違いは、バージョンに展開される `@` などのような特殊文字も解釈されずに、そのまま target として使用されることにあります。 || |
| | 95 | {{{#!td |
| | 96 | {{{ |
| | 97 | <wiki:Strange(page@!)> |
| | 98 | }}} |
| | 99 | }}} |
| | 100 | {{{#!td |
| | 101 | <wiki:Strange(page@!)> |
| | 102 | }}} |
| | 103 | }}} |
| 94 | | !SubWiki ページにリンクするには '/' を使用します: |
| 95 | | {{{ |
| 96 | | WikiPage/SubWikiPage or ./SubWikiPage |
| 97 | | }}} |
| 98 | | |
| 99 | | !SubWiki ページから親ページにリンクするには、単に '..' を使用します: |
| 100 | | {{{ |
| 101 | | [..] |
| 102 | | }}} |
| 103 | | |
| 104 | | !SubWiki ページから兄弟の位置にあるページにリンクするには '../' を使用します: |
| 105 | | {{{ |
| 106 | | [../Sibling see next sibling] |
| 107 | | }}} |
| 108 | | |
| 109 | | ''(0.11 で変更された箇所です)'' Trac 0.10 では `[../newticket]` のように書くと、トップレベル URL の /newticket にリンクする動作でした。しかし 0.11 では Wiki の名前空間にとどまり、兄弟の位置にあるページにリンクします。新しいシンタックスについては [#Server-relativelinks サーバ相対リンク] を参照してください。 |
| | 121 | [http://trac.edgewall.org/wiki/SubWiki SubWiki] ページにリンクするには '/' を使用します: |
| | 122 | {{{ |
| | 123 | WikiPage/SubWikiPage または ./SubWikiPage |
| | 124 | }}} |
| | 125 | |
| | 126 | [http://trac.edgewall.org/wiki/SubWiki SubWiki] ページから親ページにリンクするには、 '..' を使用します: |
| | 127 | {{{ |
| | 128 | [..] または [[..]] |
| | 129 | }}} |
| | 130 | [..] または [[..]] |
| | 131 | |
| | 132 | [http://trac.edgewall.org/wiki/SubWiki SubWiki] ページから [=#sibling 兄弟の位置にある] ページにリンクするには、 '../' を使用します: |
| | 133 | {{{ |
| | 134 | [../Sibling 次の兄弟ページ] または [[../Sibling|次の兄弟ページ]] |
| | 135 | }}} |
| | 136 | [../Sibling 次の兄弟ページ] または [[../Sibling|次の兄弟ページ]] |
| | 137 | |
| | 138 | しかし、兄弟の位置にあるページにリンクするために `../` プレフィックスを使用しない方がいい場合もあります。 |
| | 139 | Wiki リンクのロケーションを解決するとき、相対リンクではリンクを記述するページから階層内での近い位置にあるページが選択されます。 |
| | 140 | つまり、階層化されているページの場合、トップレベルにあるページよりも、兄弟の位置にあるページが優先されます。 |
| | 141 | プレフィックスを使用しない場合は [[WikiNewPage#renaming|ページ名変更]] による下位の階層へのページのコピーや移動の際に、 |
| | 142 | リンクを書き換える必要がなくなるので、簡単にできるようになります。 |
| | 143 | |
| | 144 | 明示的に [=#toplevel トップレベル] の Wiki ページへのリンクを記述する場合は、 |
| | 145 | `wiki:/` プレフィックスを使用してください。 |
| | 146 | ただし、 `/` プレフィックスを単独で使う場合 **Wiki ページへのリンクになりません**。 |
| | 147 | `/` で始まるリンクは [#Server-relativelinks サーバ相対リンク] のシンタックスとして解釈されるため、 |
| | 148 | `/wiki/` が付与されない、不完全な URL になってしまいます。 |
| | 149 | |
| | 150 | ''(0.11 で変更された箇所です)'' Trac 0.10 では `[../newticket]` のように書くと、トップレベル URL の `/newticket` にリンクする動作でした。しかし 0.11 では Wiki の名前空間にとどまり、兄弟の位置にあるページにリンクします。 |
| | 151 | 新しいシンタックスについては [#Server-relativelinks サーバ相対リンク] を参照してください。 |
| 187 | | * !attachment:wiki:MyPage:the_file.txt は、 Wiki ページ !MyPage に添付されたファイル the_file.txt へのリンクを生成します。 |
| 188 | | * !attachment:ticket:753:the_file.txt は、チケット 753 に添付されたファイル the_file.txt へのリンクを生成します。 |
| | 236 | * !attachment:the_file.txt:wiki:MyPage は、 Wiki ページ !MyPage に添付されたファイル the_file.txt へのリンクを生成します。 |
| | 237 | * !attachment:the_file.txt:ticket:753 は、チケット 753 に添付されたファイル the_file.txt へのリンクを生成します。 |
| | 238 | |
| | 239 | Note: 古い記法ではファイル名を最後に書いていました。この記法はまだ使うことができます: !attachment:ticket:753:the_file.txt |
| | 240 | |
| | 241 | 添付ファイルページではなく、添付ファイルの内容に直接リンクしたい場合は `attachment:` の代わりに `raw-attachment:` を使用してください。 |
| | 242 | |
| | 243 | このリンクは HTML ドキュメントなどを直接指す目的では使いやすいですが、この方法を使うためには `[attachment] render_unsafe_content = yes` (See TracIni#attachment-section) を設定し、 Web ブラウザに内容を表示できるように設定しなければなりません。注意: この設定を行うのはファイルを添付するユーザのことを 100% 信頼できる場合だけにしてください。そうでない場合、サイトが [http://ja.wikipedia.org/wiki/クロスサイトスクリプティング クロスサイトスクリプティング] 攻撃に晒されることになります。 |
| | 244 | |
| | 245 | See also [#export:links]. |
| | 246 | |
| | 247 | === comment: リンク === #comment:links |
| | 248 | |
| | 249 | 該当するチケットの内部では、 !comment:3 と書くと 3 番目の更新のコメントにリンクします。 |
| | 250 | それ以外の場所であっても、チケットを特定することで、どこからでもコメントへのリンクが可能です: |
| | 251 | - `comment:3:ticket:123` |
| | 252 | - `ticket:123#comment:3` (Note: `#123#!comment:3` という書き方は間違っています!) |
| | 253 | チケットの説明 (英語版では description) にリンクしたい場合、以下のように記述してください: |
| | 254 | - `comment:description` (該当するチケットの内部) |
| | 255 | - `comment:description:ticket:123` |
| | 256 | - `ticket:123#comment:description` |
