本文翻译自官方文档：https://confluence.atlassian.com/pages/viewpage.action?pageId=163938353

将页面树搜索宏添加到页面，为用户提供一种在指定页面层次结构中搜索页面的方法。

此宏适用于提供以下搜索方式：

  • 搜索当前空间的一部分，例如在知识库中
  • 搜索页面层次结构的指定部分，例如包含多个项目的空间中的一个项目

当有人输入关键字并单击此宏上的“搜索”按钮后，结果将显示在Confluence的高级搜索页面上。

On this page:

截图：Confluence页面上的页面树搜索宏。

如需更好的搜索体验，请查看Confluence 搜索宏，或启用Confluence 页面树宏的搜索字段。

在页面中添加宏

在页面中添加Page Tree Search宏：

  1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
  2. 从Confluence content类别中选择Page Tree Search。
  3. 设置一些参数（详见下文）。
  4. 点击Insert。 

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

修改宏参数

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

要更改宏参数：

  1. 在编辑器中，点击宏占位符并选择“编辑（Edit）”。
  2. 根据需要设置参数，然后选择“插入（Insert）”。

这是此宏中可用的参数列表。

参数

默认值

描述

Name of Root Page
(root) 

none

指定根页面的名称，此宏将在这个页面层级结构下进行搜索。如果未指定，则根页面是当前页面。

注意：与页面树宏不同，页面树搜索宏不接受以@ 符号开头的特殊值，例如@home或@self。

如果Confluence存储格式或wiki标记中使用的参数名称与浏览器中使用的参数名称不同，则会在参数名下方用括号列出，例如（example）。

其它添加方式

用键盘输入添加宏

输入左大括号{，然后输入宏名称的几个起始字符，就可以看到一个相关的宏列表。

通过wiki标记添加宏

当您想在编辑器之外添加宏时，这非常有用。例如作为侧边栏、空间页眉或页脚中的自定义内容。

Macro name: pagetreesearch

Macro body: None.

{pagetreesearch:root=My page name}
CODE