包含摘要宏用于在页面中显示摘要(excerpted)信息,这个内容可以在其他页面中显示。
在你使用这个宏之前,摘要信息需要在 摘要(Excerpt)宏 中进行定义。注意,你可以在页面中使用一个或者多个包含摘要宏,或者你也可以在页面中仅使用一个摘要宏。
实例
下面的段落中显示了一个摘要包含宏的实例。这个实例中包含的内容是在 包含摘要(Excerpt Include)宏 页面中定义的。
在下面的包含摘要宏中,我们可以为其定义一系列的选项,例如页面的标题,内容是否有框进行包裹。
摘要(Excerpt)宏
Define a part of a page as the page's 'excerpt' which can then be displayed in another page.
使用包含摘要宏
如果希望将包含代码摘要宏加入到页面:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 默认值 | 说明 |
---|
参数 | 默认值 | 说明 |
---|
页面包含摘要(Page Containing the Excerpt)
(default-parameter ) | none | 包含需要显示摘要的页面名字。你可以使用同一个空间中的页面中的摘要,或者其他空间中的页面。 当你输入包含摘要宏的对话框中的页面名称后,Confluence 会显示符合的页面列表,包括其他空间中的页面。 可选的,你可以输入空间的关键字,然后再输入 冒号(:)然后再页面的名字,如下面格式所示: SPACEKEY:Page name 这个参数在 Wiki 标签中不能被命名。 |
删除边框(Remove Surrounding Panel)
(nopanel ) | false | 确定是否让 Confluence 对输入的内容是否显示边框。这个边框有包括页面的标题和边框线。在默认情况下,边框和标题都会被显示。 |
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名称:excerpt-include
宏内容: None.
存储格式示例
< ac:macro ac:name = "excerpt-include" >
< ac:parameter ac:name = "nopanel" >true</ ac:parameter >
< ac:default-parameter >My page name</ ac:default-parameter >
</ ac:macro >
|
Wiki 标记示例
{excerpt-include:My page name|nopanel= true }
|