跳转到主要内容

一个可以在其他wiki页面中显示wiki页面内容的Trac宏

项目描述

概述

TracSubPages是一个Trac插件,它提供了一个宏,允许在其它wiki页面中显示完整的wiki页面。如果您需要在一个或多个地方显示某块内容(如联系人表或日志),这非常有用,因为它消除了每个内容实例都需要维护的需要。

用法

子页面宏的语法很简单

[[subpage(wiki_page, [show_link])]]

其中 wiki_page 是wiki页面(这里不需要url,也不需要‘wiki/’,只需页面名)。该宏也支持非顶级页面(如‘BigCategory/SpecificSubject’)。第二个参数 showlink 是一个可选参数(truefalse),它决定了是否在子页面部分的底部显示编辑渲染页面的链接(链接显示为‘编辑部分’并提供直接链接到引用wiki页面的编辑页面)。

例如,如果用户创建了一个名为‘Minutes’的wiki页面,并希望在不提供编辑链接的情况下将其内联显示在另一个wiki页面中,他们应在打算显示额外内容的wiki页面中添加以下条目

[[subpage(Minutes, False)]]

如果用户后来决定需要在内联部分的底部放置一个链接以便快速编辑,条目应更改为以下内容

[[subpage(Minutes)]]

请注意,第二个布尔参数“True”不是必需的,因为它默认被假设。

限制

  • 在使用子页面宏链接到维基页面之前,需要存在一个维基页面。这看起来很明显,但断链错误并不是很描述性(目前还不是)。

  • 请仅使用维基格式进行子页面。宏的使用可能会导致(很可能会导致)错误。

变更历史

0.5(2011-03-03)

  • 在没有Subversion仓库的情况下开始使用MANIFEST.in

0.4(2010-07-13)

  • 修复了由非ASCII字符引起的Unicode错误 [jetheis]

0.3(2010-01-10)

  • 所有代码都遵循PEP 8标准 [jetheis]

  • ez_setup.py添加到软件包中 [jetheis]

  • 将许可证更改为GPLv3 [jetheis]

0.2(2009-08-11)

  • 更改宏语法,使其不需要true/false参数 [jetheis]

  • 清理代码,以更好地遵循PEP 8 [jetheis]

0.1(2009-08-11)

  • 插件初始发布 [jetheis]

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装软件包的信息。

源分布

TracSubPages-0.5.tar.gz (18.4 kB 查看哈希值)

上传时间

由支持