InterTrac 链接
Trac 支持一种便捷的方式,使用 Wiki 标记引用其他 Trac 服务器的资源。InterTrac 链接可以被视为范围化的 TracLink。它用于引用位于其他 Trac 环境中的 Trac 资源。
链接语法
只需使用其他 Trac 环境的名称作为前缀,后跟冒号,最后是位于其他环境中的资源。
<target_environment>:<TracLinks>
其他资源使用常规的 TracLink 指定,可以是任何形式。
目标环境名称可以是环境的真实名称,也可以是别名。这些别名在 trac.ini
文件中定义,详见下文。前缀不区分大小写。
如果 InterTrac 链接用方括号括起来,例如 [th:WikiExtrasPlugin]
,则显示链接时会像正常的链接解析器一样移除 InterTrac 前缀。例如,上面会显示为 WikiExtrasPlugin
。
为方便起见,还有一种替代的简写形式,其中别名可以用作工单、变更集或报告标识符的直接前缀,例如 #T234
、[T1508]
、[trac 1508]
。
示例
默认只定义了 trac
前缀,它指向 trac.edgewall.org。可以在 TracIni 的 intertrac 部分指定其他前缀。例如
[intertrac] # -- Example of setting up an alias: t = trac # -- Link to an external Trac: genshi.title = Edgewall's Trac for Genshi genshi.url = http://genshi.edgewall.org
.url
是强制性的,用于定位其他 Trac。当 Trac 环境位于同一服务器上时,它可以是相对 URL。
.title
信息用于工具提示,即当鼠标悬停在 InterTrac 链接上时显示。
现在,给定上述配置,可以创建以下链接
- 到此 InterTrac 页面
trac:wiki:InterTrac
trac:wiki:InterTract:wiki:InterTrac
t:wiki:InterTracgenshi:InterTrac
genshi:InterTrac- 键不区分大小写:
T:wiki:InterTrac
T:wiki:InterTrac
- 到工单 #234
trac:ticket:234
trac:ticket:234trac:#234
trac:#234genshi:#234
genshi:#234#T234
#T234
- 到变更集 [1912]
trac:changeset:1912
trac:changeset:1912[T1912]
[T1912]
- 到日志范围 [3300:3330]
trac:log:@3300:3330
trac:log:@3300:3330[trac 3300:3330]
[trac 3300:3330]- 最后,要链接到远程 Trac 的起始页面,只需在其前缀后加上 ':',并放在显式链接中。示例:
[th: Trac Hacks]
(请注意,远程 Trac 必须运行 Trac >= 0.11 才能正常工作)
通用形式 intertrac_prefix:module:id
会被翻译成对应的 URL <remote>/module/id
。简写链接是针对某些模块特有的(例如 #T234
由 ticket 模块处理)。对于其余部分 (intertrac_prefix:something
),我们依赖远程 Trac 的快速跳转功能。
活动 InterTrac 前缀列表
本站点提供以下 InterTrac 前缀
前缀 | Trac 站点 |
---|---|
trac | Trac 项目 |