页面树结构
Skip to end of metadata
Go to start of metadata

导航地图(Navigation Map)宏用于在页面中显示给定标签的的页面导航地图。

使用实例

一个导航地图(Navigation Map)宏的使用实例:




使用导航地图(Navigation Map)宏

希望在页面中使用导航地图(Navigation Map)宏:


  1. 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
  2. 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
  3. 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert来将需要的宏插入到页面中。


参数

宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example)。


参数

默认值

描述

标签(Label)

none

指定页面中的标签,当你指定了这些标签后,如果页面中含有这些标签的话,这些页面将会在导航地图中显示出来。

这个参数在存储格式和 Wiki 标记格式中不能被使用。

地图标题(Map Title)
(title

none

指定导航地图的标题。

每一行的单元格数(Number of Cells Per Row)

(wrapAfter)

5

指定每一行中单元格的数量。

单元格宽度(Cell Width (Pixels))
(cellWidth

90 px

指定单元格宽度

单元格高(Cell Height (Pixels))
(cellHeight

60 px

指定单元格高度

导航地图主题(Navigation Map Theme)
(theme )

Confluence

定义导航地图的主题。

如果你希望为你的导航地图新建一个自己的主题表现形式(例如,使用圆形边框),你需要添加一个自定义的导航地图宏主题文件到 WEB-INF/classes/templates/macros 目录中。

文件名使用下面的格式: navmap-mytheme.vm。这个名字中的一部分 mytheme 将会在你在宏中对主题进行选择的时候显示出来,并且这个名字是作为主题参数使用的。

例如下面的情况,如果主题被命名为: navmap-roundededges.vm,将会使用值 roundededges 做为这个参数。

代码示例

下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。

宏名称: navmap

宏代码: None.

存储格式示例

<ac:structured-macro ac:name="navmap">
  <ac:parameter ac:name="wrapAfter">4</ac:parameter>
  <ac:parameter ac:name="title">My map name</ac:parameter>
  <ac:parameter ac:name="cellHeight">50px</ac:parameter>
  <ac:parameter ac:name="theme">navmap-mytheme.vm</ac:parameter>
  <ac:parameter ac:name="cellWidth">80px</ac:parameter>
  <ac:parameter ac:name="">mylabel</ac:parameter>
</ac:structured-macro>

Wiki 标记格式示例

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




  • 无标签