Skip to end of metadata
Go to start of metadata

你可以在 Confluence 中使用包含页面(Include Page)宏来在一个页面中包含另外一个页面。

使用包含页面(Include Page)宏

希望在页面中使用包含页面(Include Page)宏:

  1. 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
  2. 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
  3. 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert来将需要的宏插入到页面中。

参数

宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example)。

参数

默认值

说明

希望包含的页面(Page to Include)

None

希望在页面中包含的其他 Confluence 页面和博客页面的名称。开始输入页面的标题,Confluence 将会在当前空间中和其他空间中进行查找。

可选的,你可以按照下面的方式指定页面:

  • 如果页面或者博客页面在其他的空间中,那么你可以通过在页面名称前加入空间关键字。例如:DOC:My page name。空间关键字是可选的。
  • 针对博客页面,你可以在博客页面名字前面指定特定的日期。例如: /2010/12/01/My blog post
  • 你也可以包含个人空间中的页面。个人空间的名字使用 ~username 来进行确定。例如: ~jsmith:My page name。

代码示例

下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。

宏名称: include

宏内容: None

存储格式示例

<ac:structured-macro ac:name="include">
  <ac:parameter ac:name="">
    <ac:link>
      <ri:page ri:content-title="My chocolate page" ri:space-key="DOC"/>
    </ac:link>
  </ac:parameter>
</ac:structured-macro>

Wiki 标记格式示例

{include:DOC:My chocolate page}

注意

  • 如果你希望包含的是页面中的一部分而不是完整的页面的话,可以使用 摘要(Excerpt)宏 和 包含摘要(Excerpt Include)宏
  • 如果希望显示页面中的内容,对你包含进来的页面你至少有查看权限才可以显示。简单来说,用户不但要有本页面的权限,对包含进本页面的页面也得具有权限才可以正常显示。查看 Assign Space Permissions 或者联系的你系统管理来获得更多有关信息。
  • 如果你希望包含 Confluence 站点外的页面话,你需要使用 包含 HTML(HTML Include) 宏 将内容包含进来。

 

  • No labels