Confluence 代码块宏

将代码块宏添加到您的页面，可以按语法高亮形式展示代码。

这适用于分享代码片段，例如：

• 示例代码
• 终端命令
• 应用程序日志的摘要

截图：代码块宏中的代码示例，具有语法高亮显示和深色主题。

在页面中添加Code Block宏

在页面中添加代码块宏：

1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
2. 从Formatting类别中选择Code Block。
3. 选择语法高亮的语言。
4. 使用以下参数自定义代码块在页面上的显示方式。
5. 点击Insert。 
6. 在宏占位区中输入或粘贴您的代码。

然后，您可以发布您的页面以查看宏的效果。

截图：在代码块宏中选择语法高亮语言和主题

注意：您可以直接在编辑器的宏占位区中输入代码块。请注意，代码块宏不会以任何方式处理占位符中包含的任何空白字符。这是为了提供代码缩进的灵活性。

修改宏参数

宏参数用于设置宏的行为。

要更改宏参数：

1. 在编辑器中，点击宏占位符并选择“编辑（Edit）”。
   
2. 根据需要设置参数，然后选择“插入（Insert）”。

这是此宏中可用的参数列表。

如果Confluence存储格式或wiki标记中使用的参数名称与浏览器中使用的参数名称不同，则会在参数名下方用括号列出，例如（example）。

管理Code Block宏

您可以为代码块宏配置默认使用的语言和主题，还可以上传新的语言。您需要Confluence管理员权限才能更改默认主题和语言，以及系统管理员权限才能上传新语言。

要设置站点中代码块的默认外观：

1. 前往

   Error rendering macro 'excerpt-include'

   User 'null' does not have permission to view the page.

   > 一般配置（General Configuration） > Configure Code Macro.
2. 选择Default Theme和Default Language。
3. 点击Save。

除非您另行指定，否则所有新代码块都将使用默认主题和语言。已有的代码块将保持不变。

要添加其它语言：

1. 前往

   Error rendering macro 'excerpt-include'

   User 'null' does not have permission to view the page.

   > 一般配置（General Configuration） > Configure Code Macro。
2. 选择Add a new language。
3. 找到您的语言文件并输入新语言的Name（这将在选择语言时出现）。
4. 点击Add。

语言文件必须是格式正确的JavaScript文件并遵守Custom Brush语法。您可以在Confluence服务器的<install-directory>/confluence/includes/js/third-party目录中查看示例。

要禁用或删除用户安装的语言：

1. 前往

   Error rendering macro 'excerpt-include'

   User 'null' does not have permission to view the page.

    > 插件（Add-ons）。
2. 在User-installed Apps中找到您上传的语言的插件 - 它将显示为“Custom Code Macro Highlighting for...”
3. 点击Uninstall或Disable。

该语言将不再出现在代码块宏中。

其它添加方式

用键盘输入添加宏

通过wiki标记添加宏

当您想在编辑器之外添加宏时，这非常有用。例如作为侧边栏、空间页眉或页脚中的自定义内容。

Macro name: code

Macro body: Accepts plain text.

{code:title=This is my title|theme=FadeToGrey|linenumbers=true|language=java|firstline=0001|collapse=true}This is my code{code}