将搜索宏添加到页面,可以提供完全自定义的搜索框。当有人开始在搜索框中输入内容时,Confluence会推荐匹配的页面、博客或评论。

此宏非常适用于:

  • 在当前空间提供一种搜索方法,例如在知识库空间中搜索
  • 让人们搜索特定类型的内容,例如仅搜索带有某个标签的页面。

因为您可以按空间、标签、内容类型来限制搜索,所以您可以为查看您空间的人提供非常有针对性的搜索体验。

然后,您可以发布您的页面以查看宏的效果。

截图:带有搜索宏的页面,显示搜索词“printer”的搜索结果

在页面中添加宏

将Livesearch宏添加到页面:

  1. 从编辑器工具栏中,选择插入(Insert) > 其它宏(Other Macros)
  2. Navigation类别中选择Livesearch
  3. 使用参数缩小要搜索的范围。
  4. 点击Insert。 

然后,您可以发布您的页面以查看宏的效果。

截图:配置搜索宏以在指定空间中搜索具有指定标签的页面。


修改宏参数

宏参数用于设置宏的行为。

要更改宏参数:

  1. 在编辑器中,点击宏占位符并选择“编辑(Edit)”。
  2. 根据需要设置参数,然后选择“插入(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