wiki:ZhInterTrac

外部Trac链接

从0.10版之后, Trac就支持在Wiki标记中, 方便地引用其它Trac服务器资源的方法.

定义

一个外部Trac链接可被看做一个指定范围的Trac链接. 它用来引用位于另一个Trac环境中的Trac资源, 例如Wiki页面, 变更集, 传票等等.

活动外部Trac前缀表

PrefixTrac Site
tAlias for trac
tracthinkbase.net trac demo site

链接语法

将另外一个Trac环境的名字作为前缀, 紧跟一个冒号, 以另一个Trac环境中的资源结尾.

<target_environment>:<TracLinks>

使用一个通常的Trac链接去指定另外的那个资源.

该目标环境的名字可以是该环境的实名, 也可以是一个别名.

关于别名, 要在trac.ini中对其进行定义(见下面的部分). 前缀是区分大小写的.

为了方便, 还有一些快捷的方式. 用户可使用某个别名来作为一个传票, 更改集或者报告等标识符的前缀. (例如 #T234, [T1508], [trac 1508], ...)

要使用外部Trac, 需要先创建一个配置表. 该配置表位于TracIni文件中[intertrac]节中.

配置例子:

...
[intertrac]
# -- 创建一个别名的例子
t = trac

# -- 到一个外部Trac的链接:
trac.title = Edgewall's Trac for Trac
trac.url = http://trac.edgewall.org

.url是强制的, 用于定位其他Trac. 如果Trac的环境位于同一个服务器, 它可以是一个相对URL.

.title用于当你将鼠标移动到一个外部Trac链接时, 提供一个有用的提示信息.

最后, .compat项会被用来启用或禁用某"兼容模式":

  • 如果目标Trac在运行于小于里程碑0.10(准确说是r3526)的某个版本, 它将不知如何处理一个外部Trac, 因此, 将由本地Trac来准备好正确的链接. 并不是所有的链接都可以这样运行, 但绝大多数时候是这样的. 这个叫做"兼容模式", 并且默认为true.

现在, 有了上述的配置, 你可以创造以下链接:

普通形式intertrac_prefix:module:id被转换为对应的URL<remote>/module/id. 对于一些特定的模块而言, 可以使用快捷的链接(例如: #T234将被传票模块处理), 而剩余的部分(intertrac_prefix:something), 我们将依赖于远端Trac的TracSearch#quickjump机制.


原文版本: InterTrac
相关信息: Trac链接, 外部Wiki
See also: TracLinks, InterWiki

Last modified 8 years ago Last modified on 2011-01-02T23:06:43+08:00