Confluence 代码块(Code Block)宏

代码块(Code Block)宏允许你在 Confluence 页面中显示代码,并对显示的代码进行语法高亮。

代码块在页面中的显示情况如下面的例子:public static void main(String[] args) { System.out.println("Hello World!"); }使用代码块宏
如果希望在页面中使用代码块宏:
打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。

下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。

在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。

可以在页面编辑中的宏占位符内直接输入你的代码,或者将代码复制到这里面。

请注意,任何包含在宏占位符内的空格将不会被宏进行处理,这样能够在宏中提供更加灵活的书写特性。

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

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

[table]
[tr][td][align=left]参数[/align]
[/td][td][align=left]默认值[/align]
[/td][td][align=left]说明[/align]
[/td][/tr]
[tr][td]句法高亮(Syntax highlighting)
(language)

[/td][td]java
[/td][td]为你在宏内的代码指定进行语法高亮的的语言。默认使用的语言是 Java,但是你可以将语言指定下面的任何一种语言来进行语法高亮。
[list]
[]actionscript3
[
]bash
[]csharp (C#)
[
]coldfusion
[]cpp (C++)
[
]css
[]delphi
[
]diff
[]erlang
[
]groovy
[]html/xml
[
]java
[]javafx
[
]javascript
[]none (没有句法高亮)
[
]perl
[]php
[
]powershell
[]python
[
]ruby
[]scala
[
]sql
[]vb
[/list][/td][/tr]
[tr][td]标题(Title)
[/td][td]none
[/td][td]在代码块中添加一个标题。如果这个参数指定了,将会在代码块宏上面显示标题。
[/td][/tr]
[tr][td]折叠(Collapsible)
(collapse)

[/td][td]false
[/td][td]如果这个选项选择的话,代码块宏将会根据页面的情况对代码块进行折叠。单击 expand source 链接,将会允许你查看这个内容。
[align=left]如果选择 false,代码块宏总是显示所有的内容。[/align][/td][/tr]
[tr][td]显示行数(Show line numbers)
(linenumbers)

[/td][td]false
[/td][td]如果这个地方选择了,代码块宏将会在左侧显示行数量。
[/td][/tr]
[tr][td]第一行数量(First line number)
(firstline)

[/td][td]1
[/td][td]如果参数 显示行数(Show line numbers)被选择了,这个参数被用于第一行是从那一行开始的。
[/td][/tr]
[tr][td]主题(Theme)
[/td][td]Default
[/td][td]指定代码显示块的默认主题配色。很多主题是根据开发环境的(IDEs)的不同来选择配色的。
[align=left]默认的主题是 Confluence ,这个主题将会使用空白背景色,但是最字符进行着色。当然你也可以选择显示下面常用的主题:[/align][list]
[
]DJango
[]Emacs
[
]FadeToGrey
[]Midnight
[
]RDark
[]Eclipse
[
]Confluence
[/list][/td][/tr]
[/table]

来源:[url]http://cwiki.ossez.com/pages/viewpage.action?pageId=2393239[/url]