导航地图(Navigation Map)宏用于在页面中显示给定标签的的页面导航地图。
使用实例
一个导航地图(Navigation Map)宏的使用实例:
使用导航地图(Navigation Map)宏
希望在页面中使用导航地图(Navigation Map)宏:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(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}
|