在wiki页面中包含外部url和其他trac对象的内容。
TracIncludeMacro的Python项目详细描述
注释
这个宏允许您包含各种内容。
当前支持的源:
- http-http:和https:
- ftp-ftp:
- 维基页面-wiki:
- 存储库文件-source:
- 票证注释-ticket:N:comment:M(3.0dev,发布前可能会更改语法)
如果只给定源路径,则默认源为wiki。
可选的第二个参数设置输出mime类型,尽管在大多数情况下 情况默认值将是正确的。
权限
三个远程源(http、https和ftp)需要 INCLUDE_URL要呈现。
任何人都可以为这些添加一个调用,但是它们不会显示出来。这是 不是render_unsafe_content的替代品,请参见下文。
配置
如果[wiki] render_unsafe_content关闭(默认值),则 HTML将被清除。
小心!
这是一个潜在的安全风险!请回顾影响 render_unsafe_content使用此功能之前。
要启用插件:
[components] includemacro.* = enabled
示例
包括另一个wiki页面:
[[Include(PageName)]]
包括页面的一个部分(部分标题必须具有显式ID):
[[Include(PageName#section)]]
包括存储库中reStructuredText文件的头版本:
[[Include(source:trunk/docs/README, text/x-rst)]]
包括存储库中文件的特定修订版:
[[Include(source:trunk/docs/README@5, text/x-rst)]]
小费
如果在文件上设置svn:mime-type属性,则可以 关闭显式mime类型。