你可以为你的 Confluence 整个站点修改表现以及外观和感觉，也可以为单独的空间进行修改。 对整个站点进行的修改将会对使用全局外观和感觉（look and feel）的空间一并进行修改。如果某个用户具有空间的管理员权限的话，这个用户可以继续对空间的外观和布局进行进一步的修改和自定义。这个修改只对这个空间有效而不会影响全局。请参考页面： Customize your Space 获得有关的信息。 定义你站点外观和布局的方法： 为站点添加一个自定义的图标。请参考：Changing the Site Logo 修改用户界面的 配色方案（color scheme）。请参考 Customizing Color Schemes 为自定义布局使用主题（themes ），请参考 Working with Themes 修改站点或者空间布局（site or space layouts），这个将会控制站点是如何进行布局的。这个将不会直接修改页面的布局，但是将会确定页面的控制组件（例如，页面头，页面脚，和面板）是如何在页面中显示，请查看 Customizing Site and Space Layouts https://www.cwiki.us/display/CONFLUENCEWIKI/Changing+the+Look+and+Feel+of+Confluence

本部分对 Confluence 全站进行自定义的相关内容进行了说明。这部分只能是具有 Confluence 的管理员权限的用户才能进行操作 —— 系统管理员或者 Confluence 管理员。 有关对个人和空间级别的自定义内容，请参考：Your User Profile 和 personal space 空间的内容。 我们将会对下面 2 部分的自定义内容进行描述： 你可以通过对面板（dashboard）的自定义来修改 Confluence 的显示（appearance ），比如说你可以调整颜色，添加站点标志（logo）和其他更多的操作，请参考 Changing the Look and Feel of Confluence 页面中的内容。 你可以通过设置一系列的默认选项来确定系统的默认表现（default behaviour），或者设置新空间的默认内容（default content）。这些内容可以在新空间的面板和其他的一些地方。请参考 Changing the Default Behavior and Content in Confluence 页面中的内容。   https://www.cwiki.us/display/CONFLUENCEWIKI/Customizing+your+Confluence+Site

你可以决定宏参数在 Confluence 编辑器中如何进行显示的。 在默认的情况下，在宏占位符下尽可能显示能显示的所有参数： 你可以控制这里显示的参数数量，通过这种控制你可能尽量的为编辑者提供有效的信息。 例如，在 Confluence 的经过宏中有 2 个参数，title 和 icon。我们考虑到 title 是最有意义的参数，因此我们配置了经过宏显示了 title 参数的具体值。 让我们假设一个编辑用户添加了一个警告宏到编辑页面中。然后给了标题名称为 'The title of the warning'。在编辑器中的宏占位符将会显示下面的内容： 为一个用户宏配置宏占位符，你需要添加参数属性 @param 到整个模板中。 例如，如果我们的经过宏是一个用户宏，那么配置的 title 参数如下所示： ## @param title:type=string|option-showNameInPlaceholder=false|option-showValueInPlaceholder=true 属性 showNameInPlaceholder 指定了 title 下面显示的参数的名字。 属性 showValueInPlaceholder 指定了 title 参数的 value 值应该在下面显示。 如果在宏中没有上面的的 2 个参数没有包含有任何值，那么默认的配置将会在占位符中显示：完整的名字和值。 如果一个或多个参数属性被设置了，那么是所有不包含有属性的参数将会默认显示为 false（例如这里将不会显示）。   https://www.cwiki.us/display/CONFLUENCEWIKI/User+Macro+Template+Syntax

包含宏正文和参数，下面的 Confluence 对象在宏中可用： $body 宏的正文（如果宏有正文的话） String $paramfoo, $parambar, ...$param<name> 传递到你宏中被命名的参数（"foo", "bar"） String $config BootstrapManager 对象被用来获取 Confluence 属性。 BootstrapManager $renderContext PageContext 对象，针对其他事情会比较有用，请查看 $renderContext.outputType PageContext $space Space 对象，包含有相对的页面，博客页面等对象内容。 Space $content 当前的 ContentEntity 对象是当前宏包含的（如果有的话）。 ContentEntityObject 宏也可以访问 Velocity 默认可以访问的对象，例如下面开发文档中描述的：as described in the developer documentation。   https://www.cwiki.us/display/CONFLUENCEWIKI/User+Macro+Template+Syntax

你可以为你的用户宏指定参数。这样的话，用户可以使用参数来决定 Confluence 页面的显示情况。 如何在 Confluence 页面中使用你的宏参数 当添加一个宏到 Confluence 页面中的时候，宏浏览器将会为每一个选择的宏显示输入字段，这个输入字段就是你需要指定的参数。 定义参数 在模板中的参数定义为： @param 参数的名称 一系列属性（可行）。 格式： ## @param MYNAME:title=MY TITLE|type=MY TYPE|desc=MY DESCRIPTION|required=true|multiple=true|default=MY DEFAULT VALUE 其他说明： 在模板中参数的排序决定了参数在宏浏览器中显示的顺序。 我们推荐你在模板的顶部定义你的所有参数。 有可能有一些附加的属性，这个基于你的参数类型。 下面的表格说明了描述了每一个属性的详细信息。 (an unnamed, first attribute) 参数的独一无二的名称。这个参数名称在所有参数属性列表中的第一位。这个名字属性本身是没有名字的。请单击 name 查看详细信息。 必须（Required） title 在宏浏览器中显示的参数标题。如果你没有指定一个标题的话，Confluence 将会使用参数名称 推荐（Recommended） type 参数的类型字段。请单击  type 获得允许的类型 推荐（Recommended） desc 在宏浏览器中显示的参数描述 可选（Optional） required 指定用户是否必须为这个参数输入值（默认：否） 可选（Optional） multiple 指定参数是否接受多变量值（默认：否） 可选（Optional） default 参数的默认变量值 可选（Optional） 参数名称（Parameter name） 参数的独一无二的名称。这个参数名称在所有参数属性列表中的第一位。这个名字属性本身是没有名字的。 示例：下面的代码定义了 2 个参数，名字为 'foo' 和 'bar'： ## @param foo ## @param bar 参数类型（Parameter type） 这个字段定义了参数的类型。如果你没有指定一个类型，那么默认的类型为  string。 boolean 显示选择框（checkbox ）允许用户进行选择和取消选择。这个将会向宏传递 'true' 或 'false'。请注意宏接受到的是字符串。 enum 通常列出可以供选择的列表。你可以指定显示的一系列值，然后将会在宏浏览器中通过下拉选择进行选择。例如，你指定了下面的枚举类型变量： ## @param colour:title=Colour|type=enum|enumValues=Grey,Red,Yellow,Green 注意 i18n：Confluence 并不支持国际化的枚举变量类型。用户可以看到的变量就是实际传递过去的变量，同时变量将首字母大写。在这里，用户将会看到 'Grey', 'Red', 等。 string 文本字符类型。这是默认的类型。例如一个需要的字段： ## @param status:title=Status|type=string|required=true|desc=Status to display confluence-content 为用户提供一个控制器允许用户在页面和博客页面中进行查找。例如： ## @param page:title=Page|type=confluence-content|required=true|desc=Select a page do use username 查找用户 ## @param user:title=Username|type=username|desc=Select username to display spacekey 提供空间选择的列表。请输入空间的 Key 到用户宏。例如： ## @param space:title=Space|type=spacekey date Confluence 能够接受这个参数类型，但是这个参数将会按照字符串进行处理。例如： ## @param fromDate:title=From Date|type=date|desc=Date to start from. Format: dd/mm/YYYY 日期类型说明：用户可以输入任何格式的日期类型，你应该在你用户宏中校验日期格式。 int Confluence 能够接受这个参数类型，但是这个参数将会按照字符串进行处理。例如下面一个默认的变量： ## @param numPosts:title=Number of Posts|type=int|default=15|desc=Number of posts to display percentage Confluence 能够接受这个参数类型，但是这个参数将会按照字符串进行处理。例如： ## @param pcent:title=Percentage|type=percentage|desc=Number of posts to display 在你的宏代码中使用参数 参数在你的模板中可以使用 $paramfoo, $parambar 进行调用  "foo" 和 "bar" 参数名。 通常情况下，一个参数像 $paramfoo 如果丢失，或者没有定义的话，那么页面将会输出显示为 '$paramfoo' 。如果你不希望输出成这样，而是希望完全不输出，你可以使用感叹号标记，如下所示 $!paramfoo 使用无参数 如果你的宏不接受参数，那么你应该在你的模板中使用 @noparams 。 如果用户宏包含无参数，同时也没有指定 @noparams，那么宏浏览器将会显示一个无格式的文本输入框，允许用户输入没有定义的参数。这个可能会与宏不接受参数相混淆。 例如：添加下面的行到你的模板中： ## @noparams   https://www.cwiki.us/display/CONFLUENCEWIKI/User+Macro+Template+Syntax

请查看 Writing User Macros 页面获得有关如何写用户宏的介绍。 这个页面介绍你可以在用户宏中可以使用的的代码信息。 访问你的宏正文（body） 在你用户宏模板中的 $body 对象可以访问访问到传递到你宏正文中的内容。 当你的宏有指定的正文的时候，$body 对象是可用的（换句话说，如果你没有选择 No macro body 的话）。 示例：让我们假定你的宏的名称为  helloworld。 在下面的模板中输入下面的内容： Hello World: $body 当编辑 Confluence 页面的一个用户，在宏浏览器中选择你的这个用户宏，然后在宏的正文中输入了下面的内容，下面显示的是编辑页面的样子： From Matthew WIKI 页面最终将会显示成下面的样子： Hello World: From Matthew https://www.cwiki.us/display/CONFLUENCEWIKI/User+Macro+Template+Syntax

下面的用演示了如果还写一个用户宏，并在这个宏中创建一个格式化的面板，并且指定颜色。将会创建下面的面板： (Title) 注意：这个面板的标题为空，如果你没有给这个面板标题参数的话。 Macro name formpanel Visibility Visible to all users in the Macro Browser Macro Title Formatted Panel Description Creates a panel preformatted with specific colors Categories Formatting Icon URL 可以设置为空 Documentation URL 可以设置为空 Macro body processing Escaped Template 在下面的模板字段中输入代码。请查看下面获得更多有关细节的解释。 ## @param Title:title=Title|type=string|desc=Title <ac:structured-macro ac:name="panel">         <ac:parameter ac:name="titleBGColor">#ccc</ac:parameter>         <ac:parameter ac:name="borderStyle">solid</ac:parameter>         <ac:parameter ac:name="borderColor">#6699CC</ac:parameter>         <ac:parameter ac:name="borderWidth">2</ac:parameter>         <ac:parameter ac:name="titleColor">#000000</ac:parameter>     <ac:parameter ac:name="title">$!paramTitle</ac:parameter>     <ac:rich-text-body>$body</ac:rich-text-body> </ac:structured-macro> 有关宏模板代码中的细节解释 下面为使用宏模板代码的的一些细节说明。 ## @param Title:title=Title|type=string|desc=Title @param 为你的宏参数定义了元数据。 @param Title 这个参数被称为 "Title"。 title=Title 定义了参数标题，这个标题将会在宏浏览器中显示为 "Title"。 type=string 为参数文本字段定义了字段类型。 desc=Title 为宏浏览器定义了描述的参数。 <ac:structured-macro ac:name="panel"> 这个被称为 Confluence Panel Macro 宏。 最容易找到 Confluence 宏名称的的方法是通过查看在页面中包含有宏的存储格式。你将会需要 Confluence 管理员权限来查看存储的格式。 <ac:parameter ac:name="titleBGColor">#ccc</ac:parameter> <ac:parameter ac:name="borderStyle">solid</ac:parameter> <ac:parameter ac:name="borderColor">#6699CC</ac:parameter> <ac:parameter ac:name="borderWidth">2</ac:parameter> <ac:parameter ac:name="titleColor">#000000</ac:parameter> 为这个宏设置参数：背景颜色，边界样式，边界颜色，边界宽度和标题颜色。 希望在 Confluence 宏发现擦书的名称，请查看上面描述的中存储的格式。 <ac:parameter ac:name="title">$!paramTitle</ac:parameter> 输入存储在 'Title' 参数中变量，这个部分将会显示为宏的标题。 ! 标记告诉宏这部分显示为空，当 "Title" 参数中没有数据的话。 <ac:rich-text-body>$body</ac:rich-text-body> 用户可以输入保存在宏内容中的数据。这行将会启用宏方法存储在内容中的数据。 </ac:structured-macro> 这个标记标记宏的结束。   https://www.cwiki.us/display/CONFLUENCEWIKI/Writing+User+Macros

这个示例定义了如何向你宏中传递参数。我们将会创建一个字体样式宏，在这个宏中有 2 个参数，允许用户在这 2 个参数中指定宏中包含的字体的颜色大小。 Macro name stylish Visibility Visible to all users in the Macro Browser Macro Title Stylish Description Applies colour and size to text. Categories Confluence Content Icon URL 可以设置为空 Documentation URL 可以设置为空 Macro body processing Rendered Template 在模板字段中输入下面的代码。如果你的宏要求一个或者多个参数的话，你可以使用变量 $param0 到 $param9 来调用它们。 ## @param 0:title=colour|type=string ## @param 1:title=size|type=string <span style="color: $param0; font-size: $param1">$body</span> 可选的，你也可以在你的宏中明确定义参数名。这些参数将会在$param<x> 中调用，其中 <x> 是你参数的名字。 ## @param Colour:title=colour|type=string ## @param Size:title=size|type=string <span style="color: $paramColour; font-size: $paramSize">$body</span>   https://www.cwiki.us/display/CONFLUENCEWIKI/Writing+User+Macros

这个示例演示了如何创建一个用户宏，这个宏包括了在查看页面中显示的内容，但是不被打印。 Macro name noprint Visibility Visible to all users in the Macro Browser Macro Title No Print Description Hides text from printed output. Categories Confluence Content Icon URL You can leave this field blank Documentation URL You can leave this field blank Macro body processing Rendered Template Enter the code below in the template field. ## @noparams <div class="noprint">$body</div> Using the 'NoPrint' Macro on a page Now you can add the macro to your Confluence page using the Macro Browser. Text entered into the body of the macro placeholder will not be printed, but will appear when the page is viewed online. Making the PDF export recognize the NoPrint macro See Writing User Macros.   https://www.cwiki.us/display/CONFLUENCEWIKI/Writing+User+Macros

下面示例显示了如何创建一个用户宏，在这个用户宏中显示文本 'Hello World!' 和任何用户在宏内容中输入的内容。 Macro name helloworld Visibility Visible to all users in the Macro Browser Macro Title Hello World Description Displays "Hello World" and the macro body. Categories Confluence Content Icon URL 可以设置为空。 Documentation URL 可以设置为空。 Macro body processing Rendered Template 在模板字段中输入下面的内容 - 这个示例将会直接在页面中进行输出： ## @noparams Hello World! $body 如果你希望文本显示在相对的 AUI message class 的话，如下所示： ## @noparams <div class="aui-message closeable"> Hello World! $body </div> 在页面中使用 'Hello World' 宏 Now you can add the macro to your Confluence page using the Macro Browser, or by typing {hello in the editor and selecting the macro from the list of suggestions. 页面显示的结果是   https://www.cwiki.us/display/CONFLUENCEWIKI/Writing+User+Macros