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

代码块在页面中的显示情况如下面的例子：

public static void main(String[] args)
{
System.out.println("Hello World!");
}

复制代码

使用代码块宏
如果希望在页面中使用代码块宏：
打开你希望编辑 Confluence 页面，然后单击编辑（Edit）按钮。页面的编辑模式将会被打开。

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

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

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

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

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

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

参数	默认值	说明
句法高亮（Syntax highlighting） (language)	java	为你在宏内的代码指定进行语法高亮的的语言。默认使用的语言是 Java，但是你可以将语言指定下面的任何一种语言来进行语法高亮。 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
标题（Title）	none	在代码块中添加一个标题。如果这个参数指定了，将会在代码块宏上面显示标题。
折叠（Collapsible） (collapse)	false	如果这个选项选择的话，代码块宏将会根据页面的情况对代码块进行折叠。单击 expand source 链接，将会允许你查看这个内容。如果选择 false，代码块宏总是显示所有的内容。
显示行数（Show line numbers） (linenumbers)	false	如果这个地方选择了，代码块宏将会在左侧显示行数量。
第一行数量（First line number） (firstline)	1	如果参数显示行数（Show line numbers）被选择了，这个参数被用于第一行是从那一行开始的。
主题（Theme）	Default	指定代码显示块的默认主题配色。很多主题是根据开发环境的（IDEs）的不同来选择配色的。默认的主题是 Confluence ，这个主题将会使用空白背景色，但是最字符进行着色。当然你也可以选择显示下面常用的主题： DJango Emacs FadeToGrey Midnight RDark Eclipse Confluence

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

ITPub博客

Confluence 代码块（Code Block）宏

最新文章