使用宏,你可以对 Confluence 的功能进行扩展,或者在页面中生成一些动态内容。
例如 附件宏 将会把页面中所有已有的附件列出来,这样用户就不用通过单击附件标签来访问页面中包含的附件了。
向你的页面中添加一个宏
通过宏浏览器向页面中加入一宏
为了将一个宏加入到页面:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
宏参数
许多宏允许你输入一些可选的参数来控制宏的输出。
像上面提到的附件宏,你有下面 2 个可选的参数:
- 只显示特定文件格式的附件。
- 选择是否显示附件的老版本。
宏占位符
宏占位符是在 Confluence 编辑器中显示的,这个占位符告诉你加入到页面中的宏保存在页面那个位置。
当你编辑一个页面的时候,你可以:
- 双击一个宏占位符(或者选择一个宏占位符,然后单击 编辑(Edit)按钮)就可以打开一个宏对话窗口了。在宏对话窗口中,你可以编辑宏需要使用的参数。
- 选择一个宏占位符后,你可以对这个占位符进行剪贴,拷贝和粘贴。
本页的内容:
随 Confluence 默认安装的宏
当你下载 Confluence 并且成功安装后,有很多宏是 Confluence 自带的,这些宏随着 Confluence 的安装而一同进行了安装。
下面的列表中显示了最新随着 Confluence 安装而安装的宏。单击宏的名字可以查看这个宏的具体使用方法,包含的参数和一些使用例子。
有关其他宏的信息
其他的宏主要在 插件和用户自定义宏中,可以被 Confluence 的管理员进行安装。
自定义宏
希望俩件如何自定宏,你需要参考下面两个文档:
- 用户自定义宏和宏的模板一样,你可以使用 Confluence 提供的 Web 界面来创建一些简单的宏。
- Confluence 插件指南将会指导你如何在 Confluence 中开发插件。