Changes between Version 2 and Version 3 of TracLinks

Timestamp:

2012/06/16 22:07:38 (14 years ago)

Author:

trac

Comment:

--

TracLinks

@@ -17 +17 @@
 その他、 WikiFormatting を利用可能なことが明示されているすべてのテキストフィールド。
 
-例:
- * チケット: '''!#1''', '''!ticket:1'''
- * チケットのコメント: '''!comment:1:ticket:2'''
- * レポート: '''!{1}''', '''!report:1'''
- * チェンジセット: '''!r1''', '''![1]''', '''!changeset:1''', (ディレクトリを限定) '''![1/trunk]''', '''!changeset:1/trunk'''
- * リビジョンログ: '''!r1:3''', '''![1:3]''', '''!log:@1:3''', '''!log:trunk@1:3''', '''![2:5/trunk]'''
- * 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'''
- * Wiki ページ: '''!CamelCase''', '''!wiki:CamelCase'''
- * 親ページ: '''![..]'''
- * マイルストーン: '''!milestone:1.0'''
- * 添付ファイル: '''!attachment:example.tgz''' (現在のページへの添付ファイル), '''!attachment:attachment.1073.diff:ticket:944''' (絶対パス)
- * ファイル: '''!source:trunk/COPYING'''
- * あるリビジョンのファイル: '''!source:/trunk/COPYING#200'''
- * あるリビジョンのファイルのある行数: '''!source:/trunk/COPYING@200#L25'''
-表示:
- * チケット: #1, ticket:1
- * チケットのコメント: comment:1:ticket:2 
- * レポート: {1} or report:1
- * チェンジセット: r1, [1], changeset:1, (ディレクトリを限定) [1/trunk], changeset:1/trunk
- * リビジョンログ: r1:3, [1:3], log:@1:3, log:trunk@1:3, [2:5/trunk]
- * 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
- * Wiki ページ: CamelCase, wiki:CamelCase
- * 親ページ: [..]
- * マイルストーン: milestone:1.0
- * 添付ファイル: attachment:example.tgz(現在のページへの添付ファイル), attachment:attachment.1073.diff:ticket:944 (絶対パス)
- * ファイル: source:trunk/COPYING
- * あるリビジョンのファイル: source:/trunk/COPYING#200
- * あるリビジョンのファイルのある行数: source:/trunk/COPYING@200#L25
+== 概要 == #Overview
+
+||= Wiki マークアップ =||= 表示 =||
+{{{#!td
+ Wiki ページ :: `CamelCase`, `wiki:CamelCase`
+ 親ページ :: `[..]`
+ チケット :: `#1`, `ticket:1`
+ チケットのコメント :: `comment:1:ticket:2`
+ レポート :: `{1}`, `report:1`
+ マイルストーン :: `milestone:1.0`
+ 添付ファイル :: `attachment:example.tgz` (現在のページの添付ファイル), `attachment:attachment.1073.diff:ticket:944` (絶対パス)
+ チェンジセット :: `r1`, `[1]`, `changeset:1`, (特定パス配下) `[1/trunk]`, `changeset:1/trunk`
+ リビジョンログ :: `r1:3`, `[1:3]`, `log:@1:3`, `log:trunk@1:3`, `[2:5/trunk]`
+ diff :: `diff:@1:3`, `diff:plugins/0.12/mercurial-plugin@9128:9953`,
+         `diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default` 
+          または `diff:trunk/trac@3538//sandbox/vc-refactoring@3539`
+ ファイル :: `source:trunk/COPYING`, `source:/trunk/COPYING@200` (バージョン 200 における), `source:/trunk/COPYING@200#L25` (バージョン 200 における, 25 行目)
+}}}
+{{{#!td
+ Wiki ページ :: CamelCase, wiki:CamelCase
+ 親ページ :: [..]
+ チケット :: #1, ticket:1
+ チケットのコメント :: comment:1:ticket:2
+ レポート :: {1}, report:1
+ マイルストーン :: `milestone:1.0`
+ 添付ファイル :: `attachment:example.tgz` (現在のページの添付ファイル), `attachment:attachment.1073.diff:ticket:944` (絶対パス)
+ チェンジセット :: `r1`, `[1]`, `changeset:1`, (特定パス配下) `[1/trunk]`, `changeset:1/trunk`
+ リビジョンログ :: r1:3, [1:3], log:@1:3, log:trunk@1:3, [2:5/trunk]
+ diff :: diff:@1:3, diff:plugins/0.12/mercurial-plugin@9128:9953,
+         diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default 
+          または diff:trunk/trac@3538//sandbox/vc-refactoring@3539
+ ファイル :: `source:trunk/COPYING`, `source:/trunk/COPYING@200` (バージョン 200 における), `source:/trunk/COPYING@200#L25` (バージョン 200 における, 25 行目)
+}}}
 
 '''Note:''' wiki:CamelCase の書式が使われることはほとんどありませんが、
 ページ名が WikiPageNames のルールに従っていないページ (一文字、
-アルファベット以外の文字、etc.) をリンクしたい場合には便利です。 
+アルファベット以外の文字、etc.) をリンクしたい場合には便利です。
 WikiPageNames に Wiki ページ名へのリンクに関する特記事項が書いてあるので見て下さい。
 
-フル表記の (簡略形でない) Trac リンクでは、次のようにしてリンクタイトルを
-カスタマイズすることもできます:
-
-{{{
-[ticket:1 これは1番目のチケットへのリンクです]。
-}}}
-
-表示: [ticket:1 これは1番目のチケットへのリンクです]。
-
-タイトルが省略された場合、 ID のみ (コロンの後ろ側) が表示されます。
-
-{{{
-[ticket:1]
-}}}
-
-表示: [ticket:1]
-
-もし名前空間の一部が省略されていたら、 `wiki` がデフォルトの値です。(''バージョン 0.10 以降''):
-
-{{{
-[SandBox the sandbox]
-}}}
-
-表示: [SandBox the sandbox]
+
+{{{#!table class=""
+|||| 完全表記の (簡略形でない) Trac リンクでは、次のようにしてリンクタイトルをカスタマイズすることもできます: ||
+{{{#!td
+{{{
+[ticket:1 これは1番目のチケットへのリンクです] または
+[[ticket:1|これは1番目のチケットへのリンクです]]。
+}}}
+}}}
+{{{#!td
+[ticket:1 これは1番目のチケットへのリンクです] または
+[[ticket:1|これは1番目のチケットへのリンクです]]。
+}}}
+|--------------------------------------------------------------------------------------
+|||| タイトルが省略された場合、 ID のみ (コロンの後ろ側) が表示されます: ||
+{{{#!td
+{{{
+[ticket:1] または [[ticket:2]]
+}}}
+}}}
+{{{#!td
+[ticket:1] または [[ticket:2]]
+}}}
+|--------------------------------------------------------------------------------------
+|||| 完全表記から名前空間が省略されている場合、デフォルト値として `wiki` が使用されます: || 
+{{{#!td
+{{{
+[SandBox サンドボックス] または
+[[SandBox|サンドボックス]]
+}}}
+}}}
+{{{#!td
+[SandBox サンドボックス] または
+[[SandBox|サンドボックス]]
+}}}
+|--------------------------------------------------------------------------------------
+|||| ''realm:target'' 形式のリンクで特殊な文字を使用したい場合は、 <...> で囲んでください。 [[br]] (ただし > は使用できません) [[br]] 訳注: target 該当箇所を "" で囲む形式との違いは、バージョンに展開される `@` などのような特殊文字も解釈されずに、そのまま target として使用されることにあります。 ||
+{{{#!td
+{{{
+<wiki:Strange(page@!)>
+}}}
+}}}
+{{{#!td
+<wiki:Strange(page@!)>
+}}}
+}}}
 
 TracLinks はとてもシンプルなアイディアですが、実際にはとても複雑な情報網になっています。実際、使う分にはとても直感的で簡単ですし、 "リンクを追跡する" ことによってプロジェクトでおこったことやなぜある事象が起こったのかを理解するのにとても役に立ちます。
@@ -85 +112 @@
 ページ内の特定アンカーにリンクするには '#' を使用します:
 {{{
- [#Relativelinks 相対リンク]
+ [#Relativelinks 相対リンク] または [[#Relativelinks|相対リンク]]
 }}}
 表示:
-  [#Relativelinks 相対リンク]
+  [#Relativelinks 相対リンク] または [[#Relativelinks|相対リンク]]
 
 Hint: セクションのタイトルにマウスオーバしたときに、文字 '¶' が表示されます。これはそのセクションへのリンクですので、 `#...` の部分をコピーすれば、相対リンクのアンカーとして使用できます。
@@ -94 +121 @@
 [http://trac.edgewall.org/wiki/SubWiki SubWiki] ページにリンクするには '/' を使用します:
 {{{
- WikiPage/SubWikiPage or ./SubWikiPage
-}}}
-
-[http://trac.edgewall.org/wiki/SubWiki SubWiki] ページから親ページにリンクするには、単に '..' を使用します:
-{{{
-  [..]
-}}}
-
-[http://trac.edgewall.org/wiki/SubWiki SubWiki] ページから兄弟の位置にあるページにリンクするには '../' を使用します:
-{{{
-  [../Sibling see next sibling]
-}}}
-
-''(0.11 で変更された箇所です)'' Trac 0.10 では `[../newticket]` のように書くと、トップレベル URL の /newticket にリンクする動作でした。しかし 0.11 では Wiki の名前空間にとどまり、兄弟の位置にあるページにリンクします。新しいシンタックスについては [#Server-relativelinks サーバ相対リンク] を参照してください。
+ WikiPage/SubWikiPage または ./SubWikiPage
+}}}
+
+[http://trac.edgewall.org/wiki/SubWiki SubWiki] ページから親ページにリンクするには、 '..' を使用します:
+{{{
+  [..] または [[..]]
+}}}
+  [..] または [[..]]
+
+[http://trac.edgewall.org/wiki/SubWiki SubWiki] ページから [=#sibling 兄弟の位置にある] ページにリンクするには、 '../' を使用します:
+{{{
+  [../Sibling 次の兄弟ページ] または [[../Sibling|次の兄弟ページ]]
+}}}
+  [../Sibling 次の兄弟ページ] または [[../Sibling|次の兄弟ページ]]
+
+しかし、兄弟の位置にあるページにリンクするために `../` プレフィックスを使用しない方がいい場合もあります。
+Wiki リンクのロケーションを解決するとき、相対リンクではリンクを記述するページから階層内での近い位置にあるページが選択されます。
+つまり、階層化されているページの場合、トップレベルにあるページよりも、兄弟の位置にあるページが優先されます。
+プレフィックスを使用しない場合は [[WikiNewPage#renaming|ページ名変更]] による下位の階層へのページのコピーや移動の際に、
+リンクを書き換える必要がなくなるので、簡単にできるようになります。
+
+明示的に [=#toplevel トップレベル] の Wiki ページへのリンクを記述する場合は、
+`wiki:/` プレフィックスを使用してください。
+ただし、 `/` プレフィックスを単独で使う場合 **Wiki ページへのリンクになりません**。
+`/` で始まるリンクは [#Server-relativelinks サーバ相対リンク] のシンタックスとして解釈されるため、
+`/wiki/` が付与されない、不完全な URL になってしまいます。
+
+''(0.11 で変更された箇所です)'' Trac 0.10 では `[../newticket]` のように書くと、トップレベル URL の `/newticket` にリンクする動作でした。しかし 0.11 では Wiki の名前空間にとどまり、兄弟の位置にあるページにリンクします。
+新しいシンタックスについては [#Server-relativelinks サーバ相対リンク] を参照してください。
 
 === InterWiki リンク === #InterWikilinks
 
-他に、プレフィックスを自由に定義して、他の Web アプリケーションのリソースをポイントさせることができます。プレフィックスと対応する Web アプリケーションの URL の定義は特殊な Wiki ページ、 InterMapTxt ページで定義されます。 他の TracEnvironment へのリンクを作ることもできますが、より柔軟に他の TracEnvironment を指す特別な方法があることを覚えておいてください。
+他に、プレフィックスを自由に定義して、他の Web アプリケーションのリソースをポイントさせることができます。プレフィックスと対応する Web アプリケーションの URL の定義は特殊な Wiki ページである InterMapTxt ページで定義されます。他の TracEnvironment へのリンクを作ることもできますが、より柔軟に他の TracEnvironment を指す特別な方法があることを覚えておいてください。
 
 === InterTrac リンク === #InterTraclinks
@@ -117 +159 @@
 InterWiki リンクと同じ要領で使用できますが、リンクする対象を他の Trac プロジェクトに特化した機能です。
 
-プレフィックスとして定義した他の Trac Environment の名前とコロンに続けて、あらゆる種類の Trac リンクを記述することで、一つの Trac Enviroment から他の Trac Environment のリソースを参照することができます。このリモートの Trac Environment は、名前そのものかエイリアスとして、あらかじめ登録しておく必要があります。詳しくは InterTrac を参照してください。
-
-InterWiki リンクに対する InterTrac リンクの利点は、 InterTrac リンクが Trac リンクの短縮書式を解釈できることにあります。例えば、チケットへのリンクは `#T234` (T は Trac Project へのエイリアスに設定されているとします) と書くことができ、チェンジセットへのリンクは `[trac 1508]` と書くことができます。
+ある Trac Environment に記述される、どんな形式の Trac リンクであっても、他の Trac Environment のリソースを参照することができます。他の Trac Environment のリソースを指すためには、 Trac リンクのプレフィックスとして、リンク先の Trac Environment の名前とコロンを付与してください。このリンク先の Trac Environment は、名前そのものかエイリアスを、あらかじめ InterTrac に登録しておく必要があります。
+
+InterWiki リンクに対する InterTrac リンクの利点は、 Trac リンクの短縮書式 (`{}`, `r`, `#` など) を使えることにあります。例えば、 Trac プロジェクトへのエイリアスとして T が設定されている場合、 Trac プロジェクトへのチケットへのリンクは `#T234` と書くことができ、 Trac プロジェクトへのチェンジセットへのリンクは `[trac 1508]` と書くことができます。
+完全な詳細は InterTrac を参照してください。
 
 === サーバ相対リンク === #Server-relativelinks
@@ -131 +174 @@
 
 {{{
-[/newticket Create a new ticket]
-[/ home]
-}}}
-
-表示: [/newticket newticket] [/ home]
-
-サーバ上の他のロケーション (Project の外部) にリンクするためには、 '//location' リンクシンタックスを使用します (''0.11 で変更された箇所です''):
-
-{{{
-[//register Register Here]
-}}}
-
-表示: [//register Register Here]
+[/newticket 新規チケット作成] または [[//newticket|新規チケット作成]]
+[/ home] または [[/|home]]
+}}}
+
+表示: [/newticket 新規チケット作成] または [[//newticket|新規チケット作成]]
+[/ home] または [[/|home]]
+
+サーバ上の他のロケーション (Project の外部だが同じ FQDN にホストされているリソース) にリンクするためには、 '//' リンクシンタックスを使用します (''0.11 で変更された箇所です''):
+
+{{{
+[//register ここで登録します] または [[//register|ここで登録します]]
+}}}
+
+表示: [//register ここで登録します] または [[//register|ここで登録します]]
 
 === Trac リンクで空白文字をエスケープする === #QuotingspaceinTracLinks
@@ -155 +199 @@
  * !attachment:"the file.txt:ticket:123" 
 
+[http://trac.edgewall.org/wiki/WikiCreole WikiCreole] 形式のリンクを使用する場合、空白文字はそのまま解釈されます (訳注: WikiMacros の書式と重複しているので、マクロ名と同じページ名では使用できません):
+ * ![[The whitespace convention]]
+ * ![[attachment:the file.txt]]
+
 === リンクの無効化 === #EscapingLinks
 
@@ -170 +218 @@
 === パラメータつきの Trac リンク === #ParameterizedTraclinks
 
-Trac リンクの対象となる Trac リソースは通常、パラメータで制御される複数の表示形式を持っています。例えば、 Wiki ページでは `version` や `format` パラメータを使用でき、レポートでは動的変数の使用ができます。
-
-あらゆる種類の Trac リンクは、 URL のクエリパラメータに相当する方法で記述できる。任意の組み合わせのパラメータを持っています。例えば:
+Trac リンクの対象となる Trac リソースの多くは複数の表示形式を持ち、パラメータで制御することができます。例えば、 Wiki ページでは `version` や `format` パラメータを使用でき、レポートでは動的変数の使用ができます。
+
+Trac リンクは、 URL のクエリパラメータに相当する方法で記述できる。任意の組み合わせのパラメータを持っています。例えば:
  - `wiki:WikiStart?format=txt`
  - `ticket:1?version=1`
- - `[/newticket?component=module1 create a ticket for module1]`
+ - `[/newticket?component=module1 module1 についてのチケットを新規登録]`
+ - `[/newticket?summary=Add+short+description+here 空白文字を含む場合]`
 
 
@@ -200 +249 @@
 該当するチケットの内部では、 !comment:3 と書くと 3 番目の更新のコメントにリンクします。
 それ以外の場所であっても、チケットを特定することで、どこからでもコメントへのリンクが可能です:
- - !comment:3:ticket:123 
- - !ticket:123#comment:3 (Note: !#123#!comment:3! という書き方は間違っています)
+ - `comment:3:ticket:123` 
+ - `ticket:123#comment:3` (Note: `#123#!comment:3` という書き方は間違っています!)
+チケットの説明 (英語版では description) にリンクしたい場合、以下のように記述してください:
+ - `comment:description` (該当するチケットの内部)
+ - `comment:description:ticket:123`
+ - `ticket:123#comment:description`
 
 === query: リンク === #query:links
@@ -212 +265 @@
 
 === ticket: リンク === #ticket:links
+ ''エイリアス:'' `bug:`
 
 通常使用される `ticket:id` 形式のほか、 `id` の代わりにチケットのリストやチケットの範囲を指定できます。これはカスタムクエリの検索結果ビューへのリンクを生成します。検索結果は指定したチケット固定です。
@@ -228 +282 @@
  - `timeline:2008-01-29`
  - `timeline:2008-01-29T15:48`
- - `timeline:2008-01-29T16:48Z+01`
+ - `timeline:2008-01-29T15:48Z`
+ - `timeline:2008-01-29T16:48+01`
 
 ''(Trac 0.11 以降)''
@@ -237 +292 @@
 
 === バージョン管理に関連するリンク === #VersionControlrelatedlinks
+
+複数リポジトリのサポートは、リポジトリ名称に対応したトップレベルのフォルダ配下のバージョン管理されたファイルへの仮想の名前空間を作ることによって動作します。それゆえ、下記に詳細を示しますが、複数リポジトリが存在する中での Trac リンクのシンタックス、 ''/path'' の指定では、リポジトリの名前から始める必要があります。省略された場合は、デフォルトリポジトリが使用されます。デフォルトリポジトリのトップレベルのフォルダにリポジトリと同じ名前のものが存在する場合は、フォルダ名称が使用されます。これらのフォルダには、完全修飾名でいつでもアクセスすることができます。( デフォルトリポジトリは、名前付きのリポジトリのエイリアスの一つなので、逆に言えばデフォルトリポジトリのエイリアスはいつでも作成することができます。 Trac の管理者に尋ねて下さい )
+
+例として、 `source:/trunk/COPYING` はデフォルトリポジトリの `/trunk/COPYING` へのパスを指します。一方で、 `source:/projectA/trunk/COPYING` は `projectA` という名前のリポジトリの `/trunk/COPYING` へのパスを示します。もし、 `'projectA'` がデフォルトリポジトリへのエイリアスであるか、 `''` (デフォルトリポジトリ) が `'projectA'` リポジトリへのエイリアスであるならば、同じファイルを指していることになります。
+
 ==== source: リンク ==== #source:links
-
-source:/some/path 形式のリンクは、パスがディレクトリを示しているならば
-ディレクトリブラウザを開き、それ以外の場合はリビジョンログを表示します。
+ ''aliases:'' `browser:`, `repos:`
+
+source:/some/path 形式のリンクは、パスがディレクトリを指している場合は、そのディレクトリを開き、
+それ以外の場合は最新のリビジョンのファイルの内容を表示します。
 
 特定のリビジョンを指定してリンクすることもできます :
  - `source:/some/file@123` - file のリビジョン 123 にリンクします。
- - `source:/some/file@head` - file の最新リビジョンにリンクします。
-ディレクトリブラウザを開き、それ以外の場合はリビジョンログを表示します。
+ - `source:/some/file@head` - 明示的に file の最新リビジョンにリンクします。
 
 リビジョンを指定した場合はさらに特定の行番号にリンクすることさえできます :
@@ -253 +313 @@
 さらに、特定の行をハイライト表示することもできます :
  - `source:/some/file@123:10-20,100,103#L99` - 10 行目から 20 行目、 100 行目、 103 行目をハイライトします。
-''(0.11 以降)''
+   ''(0.11 以降)''
+
+マルチリポジトリ使用時は、リポジトリの名前が `source:` 以降のパスに統合されるので、 `source:reponame/trunk/README` のように記述するとリンクします。 ''(0.12 以降)''
 
 ==== export: リンク ==== #export:links
@@ -282 +344 @@
 最後に、上記のすべてについて、リビジョン範囲の書式は `x:y` と `x-y` のどちらでも使用することができます。
 
+マルチリポジトリ使用時は、リポジトリの名前が `source:` 以降のパスに統合されるので、 `log:repos/branches` や `[20-40/repos]` のように記述するとリンクします。
+
 ----
 See also: WikiFormatting, TracWiki, WikiPageNames, InterTrac, InterWiki