备注(Note)宏用于在 Confluence 页面中显示黄色边框的对话框。这个对在页面中包含重要的信息是非常有用的。
使用实例
在页面中使用备注(Note)宏的实例
我的备注
这里包含的是我的备注信息
使用备注(Note)宏
在页面中使用备注(Note)宏:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
在备注(Note)宏的页面占位符中输入你希望显示的内容。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 默认值 | 说明 |
---|
可选标题(Optional Title)
(title ) | none | 如果指定值的话,这个标题将会在图标后面以加粗字符显示。 |
显示图标(Show Exclamation Mark Icon)
(icon ) | true | - true – 显示警告图标
- false – 不显示警告图标
|
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名称: note
宏内容: 接受富文本。
存储格式示例
< ac:structured-macro ac:name = "note" >
< ac:parameter ac:name = "icon" >false</ ac:parameter >
< ac:parameter ac:name = "title" >My title</ ac:parameter >
< ac:rich-text-body >
< p >This is the content of my note.</ p >
</ ac:rich-text-body >
</ ac:structured-macro >
|
Wiki 标记格式示例
{note:icon= false |title=My title}
This is the content of my note.
{note}
|