信息(Info)宏允许在你的 Confluence 页面中高亮显示帮助信息。这个宏将会显示蓝色边框,具体情况如下显示。
Info 宏示例
这里显示了信息宏的内部内容。
使用信息(Info)宏
希望在页面中使用信息(Info)宏
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 默认值 | 说明 |
---|
可选标签(Optional Title)
(title ) | none | 在信息宏对话框中显示标题。如果指定的话,将会在信息宏框中粗体显示。 |
显示信息图标(Show Information Icon)
(icon ) | true | 如果显示 "false",信息按钮将会被显示出来。 |
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名字: info
宏内容: 接受富文本格式。
存储格式示例
下面的示例代码显示了所有参数和内容:
< ac:structured-macro ac:name = "info" >
< ac:parameter ac:name = "icon" >false</ ac:parameter >
< ac:parameter ac:name = "title" >This is my title</ ac:parameter >
< ac:rich-text-body >
< p >
< span >This is </ span > < em >important</ em > < span > information.</ span >
</ p >
</ ac:rich-text-body >
</ ac:structured-macro >
|
下面是一些示例,显示了可选参数进行配置的情况。
描述 | 标记 | 显示结果 |
---|
描述 | 标记 | 显示结果 |
---|
信息(Info)宏定义了正文和没有定义可选参数 | < ac:structured-macro ac:name = "info" >
< ac:rich-text-body >
< p >This is < em >important</ em > information.</ p >
</ ac:rich-text-body >
</ ac:structured-macro >
|
| 这个是重要的信息。 |
信息(Info)宏定义了正文和定义了可选的标题参数 | < ac:structured-macro ac:name = "info" >
< ac:parameter ac:name = "title" >This is my title</ ac:parameter >
< ac:rich-text-body >
< p >This is < em >important</ em > information.</ p >
</ ac:rich-text-body >
</ ac:structured-macro >
|
| 这个是标题 这个是重要的信息。 |
信息(Info)宏定义了正文和定义了可选的标题和图标参数 | < ac:structured-macro ac:name = "info" >
< ac:parameter ac:name = "icon" >false</ ac:parameter >
< ac:parameter ac:name = "title" >This is my title</ ac:parameter >
< ac:rich-text-body >
< p >
< span >This is </ span > < em >important</ em > < span > information.</ span >
</ p >
</ ac:rich-text-body >
</ ac:structured-macro >
|
| 这个是标题 这个是重要的信息。 |
Wiki 标记格式示例
{info:title=This is my title|icon= false }
This is _important_ information.
{info}
|