Changes between Initial Version and Version 1 of InterTrac

Timestamp:

Oct 21, 2006, 4:00:07 AM (18 years ago)

Author:

trac

Comment:

--

InterTrac

@@ +1 @@
+= InterTrac リンク =
+
+バージョン 0.10 以降で、 Trac は Wiki マークアップの中から、他の Trac サーバのリソースを簡単に参照できるようになりました。
+
+== 定義 ==
+
+InterTrac リンクはスコープ付きの TracLinks とみなすことができます。
+他の Trac Environment で管理されている Trac のリソース
+(Wiki ページ, チェンジセット, チケット, ...) を指定し、
+参照するために使用します。
+
+== 現在使用できる InterTrac プレフィックスのリスト ==
+
+[[InterTrac]]
+
+== リンクのシンタックス ==
+
+他の Trac Environment の名前をプレフィックスとして使用し、
+コロンに続けて他の Environment にあるリソースを記述します。
+
+{{{
+<対象の Environment>:<TracLinks>
+}}}
+
+リソースは通常の TracLinks で使用できるどのようなものでも指定できます。
+
+対象の Environment には、 Environment の本当の名前か、
+エイリアスを指定します。
+エイリアスは `trac.ini` に定義します (下記参照)。
+プレフィックスでは大文字 / 小文字は区別されません。
+
+簡易な方法として、他にも省略形があります。
+チケット、チェンジセット、レポートの識別子に直接プレフィックスとして、
+エイリアスを使うことができます。
+(例 `#T234`, `[T1508]`, `[trac 1508]`, ...)
+
+== 例 ==
+
+{{{
+#!comment
+ 同じサーバプロセス上で起動している、他の Environment
+ (''兄弟'' Environment と呼びます) は自動検出されます。
+現在、兄弟 Environment のサポートは無効化されています。
+See http://thread.gmane.org/gmane.comp.version-control.subversion.trac.devel/157
+}}}
+
+InterTrac を使用するためには、設定をする必要があります。
+この設定は、 TracIni ファイルの `[intertrac]` セクションに行います。
+
+設定の例:
+{{{
+...
+[intertrac]
+# -- エイリアスの設定例:
+t = trac
+
+# -- 外部の Trac へのリンク:
+trac.title = Edgewall's Trac for Trac
+trac.url = http://projects.edgewall.com/trac
+trac.compat = false
+}}}
+
+`.url` は必須オプションで、他の Trac の場所を指定するのに使用されます。
+同じサーバ上の Trac Environment であれば、相対 URL でも
+かまいません。
+
+`.title` に設定した内容は InterTrac リンクをマウスオーバしたときに、
+ツールティップとして表示されます。
+
+最後に、 `.compat` オプションは ''互換性'' モードを
+有効にするか、無効にするかに使用されます。:
+ * リンク対象の Trac が [http://trac.edgewall.org/milestone/0.10 milestone:0.10]
+   (正確には [http://trac.edgewall.org/changeset/3526 r3526]) 以前のバージョンで動作している場合、 InterTrac リンクを
+   ディスパッチできないので、ローカルの Trac が適切なリンクを準備する必要があります。
+   すべてのリンクが動作するわけではないですが、たいていの場合は動きます。
+   これは、互換性モードと呼ばれていて、 `true` がデフォルトです。
+ * リモートサイトにある Trac が InterTrac リンクをディスパッチできると分かっているならば、
+   明示的にこの互換性モードを無効にすることで、''全ての''
+   TracLinks が InterTrac リンクとして動作するようになります。
+
+上記の例を設定すると、以下のようなリンクを使用することができます:
+ * この (訳注: 本家サイトの) InterTrac ページ:
+   * `trac:wiki:InterTrac` trac:wiki:InterTrac
+   * `t:wiki:InterTrac` t:wiki:InterTrac
+   * キーでは大文字/小文字は区別されません: `T:wiki:InterTrac` T:wiki:InterTrac
+ * チケット #234 へのリンク:
+   * `trac:ticket:234` trac:ticket:234
+   * `trac:#234` trac:#234 
+   * `#T234` #T234
+ * チェンジセット [1912] へのリンク:
+   * `trac:changeset:1912` trac:changeset:1912
+   * `[T1912]` [T1912]
+ * リビジョンログの範囲指定 [3300:3330]: '''(Note: `trac.compat=false` を設定する必要があります。)'''
+   * `trac:log:@3300:3330` trac:log:@3300:3330  
+   * `[trac 3300:3330]` [trac 3300:3330] 
+
+通常の形式 `<InterTrac のプレフィックス>:モジュール:識別子` は
+正しい URL `<リンク先の Environment>/モジュール/識別子` と解釈されます。省略形のリンクは
+モジュールごとに固有となっています (例 !#T234 は
+チケットモジュールによって解釈されます)。残りの形 (`<InterTrac のプレフィックス>:任意の文字列`)
+については、 リモートの Trac の TracSearch#クイックジャンプ に沿った動作をします。
+
+----
+=== Discussion ===
+
+I think that the `trac` prefix could even be set as a default in the `[intertrac]` TracIni section. --CB
+
+----
+See also: TracLinks, InterWiki