Changes between Version 2 and Version 3 of TracLinks

Timestamp:

12/07/15 15:40:17 (9 years ago)

Author:

trac

Comment:

--

TracLinks

@@ -31 +31 @@
  リビジョンログ :: `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: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 行目)
@@ -41 +41 @@
  チケットのコメント :: 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]
+ マイルストーン :: milestone:1.0
+ 添付ファイル :: attachment:example.tgz (現在のページの添付ファイル), attachment:attachment.1073.diff:ticket:944 (絶対パス)
+ チェンジセット :: r1, [1], changeset:1 or (特定パス配下) [1/trunk], changeset:1/trunk
+ リビジョンログ :: r1:3, [1:3] or 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: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 行目)
+ ファイル :: source:trunk/COPYING, source:/trunk/COPYING@200 (バージョン 200 における), source:/trunk/COPYING@200#L25 (バージョン 200 における, 25 行目)
 }}}
 
@@ -80 +80 @@
 }}}
 |--------------------------------------------------------------------------------------
-|||| 完全表記から名前空間が省略されている場合、デフォルト値として `wiki` が使用されます: || 
+|||| 完全表記から名前空間が省略されている場合、デフォルト値として `wiki` が使用されます: ||
 {{{#!td
 {{{
@@ -110 +110 @@
 === 相対リンク === #Relativelinks
 
-ページ内の特定アンカーにリンクするには '#' を使用します:
-{{{
- [#Relativelinks 相対リンク] または [[#Relativelinks|相対リンク]]
-}}}
-表示:
-  [#Relativelinks 相対リンク] または [[#Relativelinks|相対リンク]]
-
-Hint: セクションのタイトルにマウスオーバしたときに、文字 '¶' が表示されます。これはそのセクションへのリンクですので、 `#...` の部分をコピーすれば、相対リンクのアンカーとして使用できます。
-
-[http://trac.edgewall.org/wiki/SubWiki SubWiki] ページにリンクするには '/' を使用します:
+[trac:/SubWiki SubWiki] ページにリンクするには '/' を使用します:
 {{{
  WikiPage/SubWikiPage または ./SubWikiPage
 }}}
 
-[http://trac.edgewall.org/wiki/SubWiki SubWiki] ページから親ページにリンクするには、 '..' を使用します:
+[trac:SubWiki SubWiki] ページから親ページにリンクするには、 '..' を使用します:
 {{{
   [..] または [[..]]
@@ -130 +121 @@
   [..] または [[..]]
 
-[http://trac.edgewall.org/wiki/SubWiki SubWiki] ページから [=#sibling 兄弟の位置にある] ページにリンクするには、 '../' を使用します:
+[trac:SubWiki SubWiki] ページから [=#sibling 兄弟の位置にある] ページにリンクするには、 '../' を使用します:
 {{{
   [../Sibling 次の兄弟ページ] または [[../Sibling|次の兄弟ページ]]
@@ -151 +142 @@
 新しいシンタックスについては [#Server-relativelinks サーバ相対リンク] を参照してください。
 
+=== リンクアンカー === #Linkanchors
+
+ページ内の特定アンカーにリンクするには、'#'を使用してください:
+{{{
+ [#Linkanchors リンクアンカー] または [[#Linkanchors|リンクアンカー]]
+}}}
+  [#Linkanchors リンクアンカー] または [[#Linkanchors|リンクアンカー]]
+
+Hint: セクションのタイトルにマウスオーバしたときに、文字 '¶' が表示されます。これはそのセクションへのリンクですので、 `#...` の部分をコピーすれば、相対リンクのアンカーとして使用できます。
+
+ページ上に最初と最後に記載されている用語にリンクを作成するためには、'#/' または '#?'で始まる ''pseudo anchor'' を使用してください:
+{{{
+ [#/Milestone first occurrence of Milestone] または
+ [#?Milestone last occurrence of Milestone]
+}}}
+ [#/Milestone first occurrence of Milestone] または
+ [#?Milestone last occurrence of Milestone]
+リンクしたページで一致したらすべてがハイライト表示されます。 デフォルト値のみ、大文字と小文字が区別されます。 大文字と小文字を区別しない場合には、 '/i' 追加してください:
+{{{
+ [#/Milestone/i first occurrence of Milestone or milestone] または
+ [#?Milestone/i last occurrence of Milestone or milestone]
+}}}
+ [#/Milestone/i first occurrence of Milestone or milestone] または
+ [#?Milestone/i last occurrence of Milestone or milestone]
+
+''(Trac 1.0 以降)''
+
+このようなアンカーは、ソースブラウザでファイルの特定の行にリンクするのに非常に役立ちます:
+{{{
+ [trac:source:tags/trac-0.12/trac/wiki/api.py#L127 Line 127] または
+ [trac:source:tags/trac-0.12/trac/ticket/roadmap.py#L47 Line 47]
+}}}
+ [trac:source:tags/trac-0.12/trac/wiki/api.py#L127 Line 127] または
+ [trac:source:tags/trac-0.12/trac/ticket/roadmap.py#L47 Line 47]
+(Hint: ソースブラウザに表示される行番号は、それぞれのライン上でアンカーへリンクします。)
+
+ファイルが変更されるとリンクが古くなるので, 代わりに疑似アンカー '#/' を使用するとリンクする時に便利です:
+{{{
+ [trac:source:trunk/trac/wiki/api.py#/IWikiSyntaxProvider IWikiSyntaxProvider] または
+ [trac:source:trunk/trac/env.py#/ISystemInfoProvider ISystemInfoProvider]
+}}}
+ [trac:source:trunk/trac/wiki/api.py#/IWikiSyntaxProvider IWikiSyntaxProvider] または
+ [trac:source:trunk/trac/env.py#/ISystemInfoProvider ISystemInfoProvider]
+
 === InterWiki リンク === #InterWikilinks
 
@@ -196 +231 @@
  * !wiki:"The whitespace convention"
  * !attachment:'the file.txt' もしくは
- * !attachment:"the file.txt" 
- * !attachment:"the file.txt:ticket:123" 
-
-[http://trac.edgewall.org/wiki/WikiCreole WikiCreole] 形式のリンクを使用する場合、空白文字はそのまま解釈されます (訳注: WikiMacros の書式と重複しているので、マクロ名と同じページ名では使用できません):
+ * !attachment:"the file.txt"
+ * !attachment:"the file.txt:ticket:123"
+
+[trac:WikiCreole WikiCreole] 形式のリンクを使用する場合、空白文字はそのまま解釈されます (訳注: WikiMacros の書式と重複しているので、マクロ名と同じページ名では使用できません):
  * ![[The whitespace convention]]
  * ![[attachment:the file.txt]]
@@ -233 +268 @@
 
 添付ファイルへのリンクのシンタックスは次に示すとおりです:
- * !attachment:the_file.txt は、現在のオブジェクトに添付されたファイル the_file.txt へのリンクを生成します。
- * !attachment:the_file.txt:wiki:MyPage は、 Wiki ページ !MyPage に添付されたファイル the_file.txt へのリンクを生成します。
- * !attachment:the_file.txt:ticket:753 は、チケット 753 に添付されたファイル the_file.txt へのリンクを生成します。
+ * !attachment:the_file.txt は、現在のオブジェクトに添付されたファイル the_file.txt へのリンクを生成します
+ * !attachment:the_file.txt:wiki:MyPage は、 Wiki ページ !MyPage に添付されたファイル the_file.txt へのリンクを生成します
+ * !attachment:the_file.txt:ticket:753 は、チケット 753 に添付されたファイル the_file.txt へのリンクを生成します
 
 Note: 古い記法ではファイル名を最後に書いていました。この記法はまだ使うことができます: !attachment:ticket:753:the_file.txt
@@ -243 +278 @@
 このリンクは HTML ドキュメントなどを直接指す目的では使いやすいですが、この方法を使うためには `[attachment] render_unsafe_content = yes` (See TracIni#attachment-section) を設定し、 Web ブラウザに内容を表示できるように設定しなければなりません。注意: この設定を行うのはファイルを添付するユーザのことを 100% 信頼できる場合だけにしてください。そうでない場合、サイトが [http://ja.wikipedia.org/wiki/クロスサイトスクリプティング クロスサイトスクリプティング] 攻撃に晒されることになります。
 
-See also [#export:links].
+[#export:links] を参照してください。
 
 === comment: リンク === #comment:links
@@ -249 +284 @@
 該当するチケットの内部では、 !comment:3 と書くと 3 番目の更新のコメントにリンクします。
 それ以外の場所であっても、チケットを特定することで、どこからでもコメントへのリンクが可能です:
- - `comment:3:ticket:123` 
+ - `comment:3:ticket:123`
  - `ticket:123#comment:3` (Note: `#123#!comment:3` という書き方は間違っています!)
 チケットの説明 (英語版では description) にリンクしたい場合、以下のように記述してください:
@@ -273 +308 @@
 通常使用される `ticket:id` 形式のほか、 `id` の代わりにチケットのリストやチケットの範囲を指定できます。これはカスタムクエリの検索結果ビューへのリンクを生成します。検索結果は指定したチケット固定です。
 
-例: 
+例:
  - `ticket:5000-6000`
  - `ticket:1,150`
@@ -293 +328 @@
 === wiki: リンク === #wiki:links
 
-WikiPageNames と、このページの [#QuotingspaceinTracLinks Trac リンクで空白文字をエスケープする] を参照してください。!WikiStart@1 といった構文を使用することで、リビジョンを指定してページへのリンクを生成することが可能です。
+WikiPageNames と、このページの [#QuotingspaceinTracLinks Trac リンクで空白文字をエスケープする] を参照してください。WikiStart@1 といった構文を使用することで、リビジョンを指定してページへのリンクを生成することが可能です。
 
 === バージョン管理に関連するリンク === #VersionControlrelatedlinks
@@ -308 +343 @@
 
 特定のリビジョンを指定してリンクすることもできます :
- - `source:/some/file@123` - file のリビジョン 123 にリンクします。
- - `source:/some/file@head` - 明示的に file の最新リビジョンにリンクします。
+ - `source:/some/file@123` - file のリビジョン 123 にリンクします
+ - `source:/some/file@head` - 明示的に file の最新リビジョンにリンクします
 
 リビジョンを指定した場合はさらに特定の行番号にリンクすることさえできます :
@@ -316 +351 @@
 
 さらに、特定の行をハイライト表示することもできます :
- - `source:/some/file@123:10-20,100,103#L99` - 10 行目から 20 行目、 100 行目、 103 行目をハイライトします。
+ - `source:/some/file@123:10-20,100,103#L99` - 10 行目から 20 行目、 100 行目、 103 行目をハイライトします
    ''(0.11 以降)''
 
@@ -324 +359 @@
 
 ブラウザでリンクをクリックしたときに、リポジトリ内をブラウザに表示するのではなく、ダウンロードを強制するためには `export` リンクを使用します。いくつかの形式が使用できます :
- * `export:/some/file` - file の最新リビジョンをダウンロードします。
- * `export:123:/some/file` - file の リビジョン 123 をダウンロードします。
- * `export:/some/file@123` - file の リビジョン 123 をダウンロードします。
+ * `export:/some/file` - file の最新リビジョンをダウンロードします
+ * `export:123:/some/file` - file の リビジョン 123 をダウンロードします
+ * `export:/some/file@123` - file の リビジョン 123 をダウンロードします
 
 リポジトリにチェックインされている XML や HTML 文書を、正しいスタイルシートと画像で表示する場合などには非常に使いやすいですが、この方法を使うためには `[browser] render_unsafe_content = yes` (See TracIni#browser-section) を設定し、 Web ブラウザに内容を表示できるように設定しなければなりません。設定されていない場合、セキュリティを確保するため、そのファイルを Web ブラウザ上で表示せず、添付ファイルと同じようにダウンロードさせます。
@@ -352 +387 @@
 ----
 See also: WikiFormatting, TracWiki, WikiPageNames, InterTrac, InterWiki
- 
+