TracIncludeMacro 3.2.0

注释

此宏允许您包含各种内容。

当前支持的源

• HTTP - http: 和 https:

• FTP - ftp:

• Wiki页面 - wiki:

• 仓库文件 - source:

• 票证评论 - ticket:N:comment:M (3.0dev，语法可能在发布前更改)

如果只给出了源路径，默认源是 wiki。

可选的第二个参数设置输出MIME类型，但在大多数情况下默认设置将是正确的。

权限

三个远程源（http、https和ftp）需要 INCLUDE_URL 可渲染。

任何人都可以添加调用，但它们将不会显示。这不是 替换 render_unsafe_content，见下文。

配置

如果 [wiki] render_unsafe_content 关闭（默认值），则产生的任何HTML都将被清理。

要启用插件

[components]
includemacro.* = enabled

示例

包含另一个维基页面

[[Include(PageName)]]

包含页面的一部分（部分标题必须具有显式的id）

[[Include(PageName#section)]]

包含存储库中 reStructuredText 文件的 HEAD 版本

[[Include(source:trunk/docs/README, text/x-rst)]]

包含存储库中文件的特定版本

[[Include(source:trunk/docs/README@5, text/x-rst)]]

只包含存储库中文件的一部分（使用命名参数 : start, end, lineno）

[[Include(source:trunk/docs/README@5, text/x-rst, start=5, end=15)]]
[[Include(source:trunk/docs/README@5, text/x-rst, start=5, end=15, lineno=yes)]]

可以在 start 和/或 end 参数中使用正则表达式

[[Include(source:trunk/docs/README, start=”[a-z]+”, end=15, lineno=yes)]] [[Include(source:trunk/docs/README, start=”[a-z]+”, end=”[.+]”, lineno=yes)]]