然后,您可以发布您的页面以查看宏的效果。截图:带有搜索宏的页面,显示搜索词“printer”的搜索结果
在页面中添加宏
将Livesearch宏添加到页面:
从编辑器工具栏中,选择
插入(Insert) >
其它宏(Other Macros)。
- 从Navigation类别中选择Livesearch。
- 使用参数缩小要搜索的范围。
- 点击Insert。
然后,您可以发布您的页面以查看宏的效果。
截图:配置搜索宏以在指定空间中搜索具有指定标签的页面。
修改宏参数
宏参数用于设置宏的行为。
要更改宏参数:
- 在编辑器中,点击宏占位符并选择“编辑(Edit)”。
- 根据需要设置参数,然后选择“插入(Insert)”。
这是此宏中可用的参数列表。
参数 | 默认值 | 描述 |
---|
Restrict to this Space Key
(spaceKey ) | all spaces | 指定空间关键字以将搜索限制为单个空间。区分大小写。您不能指定多个空间。 或者,使用@self将搜索限制在当前空间。 |
Restrict to label(s)
(labels ) |
| 指定标签以将搜索限制为具有该标签的内容。如果未指定,将搜索所有内容而不管标签。 |
Size
(size ) | medium | 选择中等或较大的搜索框大小。 |
Placeholder text
(placeholder ) |
| 指定要出现在搜索框中的占位符文本,例如“搜索此空间” |
Type
(type ) | all | 指定要搜索的内容类型 - 从页面、博客、评论、空间描述或所有内容类型中进行选择。 |
Additional
(additional ) | space name | 在搜索结果中显示空间名称、页面摘要或不显示任何内容。 |
如果Confluence存储格式或wiki标记中使用的参数名称与浏览器中使用的参数名称不同,则会在参数名下方用括号列出,例如(example)。
其它添加方式
用键盘输入添加宏
输入左大括号{,然后输入宏名称的几个起始字符
,就可以看到一个相关的宏列表。
通过wiki标记添加宏
当您想在编辑器之外添加宏时,这非常有用。例如作为侧边栏、空间页眉或页脚中的自定义内容。
Macro name: livesearch
Macro body: None.
{livesearch:spaceKey=DOC|size=large|placeholder=Search this space}
CODE