Confluence 导航地图宏

将导航地图宏添加到页面以在网格布局中显示含有特定标签的页面。

此宏非常适合用于直观地表示具有特定标签的一小组页面。 你可以：

• 显示所有带有“needs-review”标签的页面，以突出显示需要工作的页面
• 在您的知识库中显示所有带有“how-to”标签的页面

如果您想变得更个性化，可以通过创建自己的Velocity主题来设置宏的样式。不过，这确实需要编写一些代码。 

截图：带有导航地图宏的页面，显示带有“printer-how-to”标签的页面。

在页面中添加宏

在页面中添加Navigation Map宏：

1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
2. 从Navigation类别中选择Navigation Map。
3. 输入一个标签。
4. 点击Insert。 

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

截图：在导航地图宏中指定标签和标题

修改宏参数

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

要更改宏参数：

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

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

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

创建自定义的导航地图主题

如果您想创建自己的导航地图“外观”（例如，带有圆角的导航地图），则需要将自定义导航地图宏主题文件添加到 WEB-INF/classes/com/atlassian/confluence/plugins/macros/advanced目录。要使用的文件名约定是navmap-mytheme.vm。使用您选择的名称作为文件名的mytheme部分，这也是您用于此参数的值。因此，如果您的主题名为navmap-roundededges.vm,，请将此参数使用roundededges的值。

主题必须用Velocity编写。有关详细信息，请参阅Velocity User Guide。

其它添加方式

用键盘输入添加宏

通过wiki标记添加宏

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

Macro name: navmap

Macro body: None.

{navmap:mylabel|wrapAfter=4|title=My map name|cellHeight=50px|theme=navmap-mytheme.vm|cellWidth=80px}