外部Trac链接
从0.10版之后, Trac就支持在Wiki标记中, 方便地引用其它Trac服务器资源的方法.
定义
一个外部Trac链接可被看做一个指定范围的Trac链接. 它用来引用位于另一个Trac环境中的Trac资源, 例如Wiki页面, 变更集, 传票等等.
活动外部Trac前缀表
| Prefix | Trac Site |
|---|---|
| t | Alias for trac |
| trac | thinkbase.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 页面:
- trac:wiki:InterTrac trac:wiki:InterTrac
- t:wiki:InterTrac t:wiki:InterTrac
- Keys are case insensitive: 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]: (注意: 下面这条需要trac.compat=false)
- trac:log:@3300:3330 trac:log:@3300:3330
- [trac 3300:3330] [trac 3300:3330]
- 最后, 到远程trac的起始页面, 只需在一个明确的链接中, 简单地使用其前缀和':'. 例如: [th: Trac Hacks] (从0.11起; 注意, 要使其起作用, 远程 Trac 必须运行0.11)
普通形式intertrac_prefix:module:id被转换为对应的URL<remote>/module/id. 对于一些特定的模块而言, 可以使用快捷的链接(例如: #T234将被传票模块处理), 而剩余的部分(intertrac_prefix:something), 我们将依赖于远端Trac的TracSearch#quickjump机制.
原文版本: InterTrac
相关信息: Trac链接, 外部Wiki
See also: TracLinks, InterWiki
