Decorator 宏（Macros）是 Velocity  宏。这个宏可以被用来在页面编辑 Custom decorators 中创建复杂或者可变的部分，例如菜单，页面其他部分等。Decorator 宏可以在你的模板中的任何位置插入。 这个宏可以用下面的方法插入到模板页面中： #macroName（"argument1" "argument2" "argument3"）。在参数直接不需要逗号进行分割。除非有特殊的说明，这个宏不需要参数。 注意：这个宏只能在自定义模板文件中使用 main.vmd。在其他的 decorators 中，这个宏可能没有效果。Decorator 宏在 Confluence 页面中不可用。 #breadcrumbs() 创建 "You are here" 的列表，像在默认模板中的上面页面的名字。 #includePage(pageTitle) 在 Confluence 页面中包含指定 title。如果你有 2 个或者多个页面有相同的页面标题在多个空间的话，这个宏将会只包含当前你查看的空间中的页面。 #searchbox() 在页面插入查找对话框，例如默认模板上右侧的查找连接。 #globalnavbar(type) 插入全局导航栏，例如默认模板右侧的导航。这个导航栏可以用2中方式显示。 #globalnavbar("table") 在默认模块中显示导航栏，例如将鼠标移动到上面显示的彩色背景。 #globalnavbar("text") 显示导航栏以一些链接进行分割。 #usernavbar() 显示创建用户指定的导航栏，这个导航栏有用户的属性和历史或者登录注册页面（如果用户没有登录的话）。 #helpicon() 在 Confluence 帮助页面显示帮助图标提供连接。。 #printableicon() 在页面的可打印版本中可见，将会画一个页面可打印的图标连接到页面打印的版本，否则将不会创建任何内容。 #pagetitle(class) 当你在 Confluence 空间中查看一个页面，创建页面所在的空间名。否则将会创建字符 "CONFLUENCE"。"class"参数是 CSS 的类名称，这个类被用来创建标题的样式。除非你有自定义的 CSS 文件被创建了，你应该使用 "spacenametitle" 进行调用，同时使用宏名称：#pagetitle（"spacenametitle"） #poweredby() 输出 "Powered by Confluence" 和在 Confluence 默认页面的底部显示版本号。 #bottomshadow() 在默认模板中的底部显示阴影。 #dashboardlink() 插入一个连接到主面板页面中。   https://www.cwiki.us/display/CONFLUENCEWIKI/Working+With+Decorator+Macros

Velocity 被配置在内存中使用缓存模板。当你在 Confluence 中编辑了页面的模板文件，Confluence 知道文件进行了编辑，将会重新从磁盘中载入模板文件。如果你直接在 Confluence 的磁盘文件中对 velocity 进行编辑的话，你要么需要关闭在  WEB-INF/classes/velocity.properties 中的缓存配置或者重启服务器使修改生效。 velocity.properties 文件保存在 confluence-x.x.x.jar 文件，其中 x.x.x 是 Confluence 的版本号。JAR 文件保存在  WEB-INF/lib 目录中。如果你希望对 JAR 文件进行修改，请按照下面的步骤：steps: 停止 Confluence 备份你需要修改的 JAR 文件。 Un-jar 文件。 对希望修改的文件找到文件所在的位置和进行正确的修改配置。 Re-jar the confluence-x.x.x.jar 文件。 找到 JAR 文件应该保存的正确位置，然后将修改的文件替换掉服务器上的文件。 重启 Confluence。 https://www.cwiki.us/display/CONFLUENCEWIKI/Upgrading+Customized+Site+and+Space+Layouts

修改可能对 Confluence 的后续版本不兼容，当你对 Confluence 进行升级的时候，你应该总是对你自定义修改的模板文件进行仔细的测试来确定所有的修改对新版本的 Confluence 兼容。在上线之前，请进行仔细的测试。 有关自定义修改的所有操作都不会得到 Atlassian 的技术支持。   https://www.cwiki.us/display/CONFLUENCEWIKI/Upgrading+Customized+Site+and+Space+Layouts

当你升级你的 Confluence 到其他一个主要的 Confluence 发行版本的时候，你需要手动应用你修改过的任何全局或者空间级别的布局。除非有特殊的声明，针对一些非主要的 Confluence 升级，你的自定义修改应该是不需要重新应用上去的。 什么是主要版本，什么是非主要版本？主要版本的的升级主要是指 Confluence 的版本号升级为小数点前后一位的数字变化，例如 Confluence 的版本升级 3.0 到 3.1，或者 2.8 到 3.0 都被认为是主要版本升级。非主要版本升级主要为第一位小数点之后小数点标记的升级，例如 Confluence 3.0 到 3.0.1 不认为是主要版本升级。 如果你对 Confluence 的全局站点进行了修改： 在屏幕的右上角单击 控制台按钮 ，然后选择 General Configuration 链接。 在左侧的导航面板中选择 布局（Layouts），decorator 文件按照在 Site, Content 和 Export 布局进行分组。 请确定你有所有你的自定义文件可用（可用使用复制张贴方式进行处理）。 对你希望进行自定义方式进行页面调整的布局，单击 重置默认（Reset Default）。 在希望处理的布局中，单击 创建自定义（Create Custom）然后将你的自定义文件应用上去（通过复制粘贴方式）到正确的位置上，来应用为默认的布局。 单击 保存（Save）按钮。 对你希望进行自定义的页面，重复上面的步骤 4 的操作。 如果你已经对布局进行了自定义的操作： 进入空间后，然后从边栏的底部选择 空间工具（Space tools） > 外观和感觉（Look and Feel） 。 在左侧的导航面板中选择 布局（Layouts），decorator 文件按照在 Site, Content 和 Export 布局进行分组。 请确定你有所有你的自定义文件可用（可用使用复制张贴方式进行处理）。 对你希望进行自定义方式进行页面调整的布局，单击 重置默认（Reset Default）。 在希望处理的布局中，单击 创建自定义（Create Custom）然后将你的自定义文件应用上去（通过复制粘贴方式）到正确的位置上，来应用为默认的布局。 单击 保存（Save）按钮。 对你希望进行自定义的页面，重复上面步骤 5 的操作。 https://www.cwiki.us/display/CONFLUENCEWIKI/Upgrading+Customized+Site+and+Space+Layouts

我们建议你在对站点进行布局修改的时候，你需要为你修改的 Confluence 站点或空间布局保留所有的修改记录。 如果没有的话，你应该可以通过下面的办法找到你的自定义修改。这个方法将会把你对全部网站和空间级别的修改以一个单一的输出而表现出来。从这个输出文件，你应该能找到你修改过的自定义文件。 这个方法对下面的一些情况是非常有用的： 很多空间都有自己的自定义修改，或者 针对你的站点布局你已经没有独立的记录了。 所有的自定义布局存储在  DECORATOR 表中，这个表是 Confluence 使用的数据库。你可以使用  SELECT SQL 语句从数据库中找到这些： mysql> select SPACEKEY,DECORATORNAME,BODY from DECORATOR; +----------+---------------------+------+ | SPACEKEY | DECORATORNAME | BODY | +----------+---------------------+------+ | NULL | decorators/main.vmd | ... | +----------+---------------------+------+ 1 row in set (0.03 sec) 上面的例子是针对 MySQL 的，如果使用的是其他的数据库，上面的 SQL 应该也是可用的。   https://www.cwiki.us/display/CONFLUENCEWIKI/Upgrading+Customized+Site+and+Space+Layouts

随着 Confluence 的演变。默认的站点和空间布局也会随着 Confluence 升级而让使用的所有页面进行改变。随着一些新功能的加入和一些老功能的修改，默认的布局也需要进行修改来支持这些改变。 如果你使用的是基于 Confluence 前期版本的 自定义布局，你可能会遇到 损坏的功能（breaking functionality）或者更糟糕的你将不能使用新 Confluence 中的功能。 你需要针对每一个新 Confluence 版本的发布来将你的修改应用到所有的新模板中。 希望应用你的自定义布局，你需要： 从你前期 Confluence 的版本中获得你自定义的源代码。 将这些你自定义的源代码应用到新的默认布局中。 https://www.cwiki.us/display/CONFLUENCEWIKI/Upgrading+Customized+Site+and+Space+Layouts

重载 Velocity 模板 velocity 目录是 Confluence Velocity 模板文件进行搜索时候需要的文件夹。例如，你可以通过将你的 Velocity 文件使用正确的文件名放置到正确的路径。我们不建议对你的 Confluence 站点进行这样的操作，除非你明确知道你在进行什么操作。这个部分的文件能够给你对你 Confluence 的站点进行完全的操作。同时也意味着你可以对你 Confluence 站点的模板文件使用文本文件进行编辑后应用到整个站点上。 缓存 Velocity 被配置在内存中缓存模板文件。当你在 Confluence 中编辑了页面的模板文件，Confluence 知道文件进行了编辑，将会重新从磁盘中载入模板文件。如果你直接在 Confluence 的磁盘文件中对 velocity 进行编辑的话，你要么需要关闭在  WEB-INF/classes/velocity.properties 中的缓存配置或者重启服务器使修改生效。 Velocity  文件位置 你可以在你 Confluence 安装目录中找到 Velocity 文件。主要的 Velocity 文件位于  <CONFLUENCE-INSTALLATION>\confluence\decorators 目录下面。例如，你可以在文件夹中找到下面的一些文件： main.vmd, space.vmd, form-aui.vmd, global.vmd 和其他的一些文件。 通过 URL 找到布局 如果你的布局已经被修改了，但是外观却没有改变，你可以通过浏览器的 URL 直接进行访问： http://<confluence base url>/admin/resetdecorator.action?decoratorName=decorators/main.vmd 将基本 URL 中的 .vmd 替代到正确的文件名在文件系统中查找。   https://www.cwiki.us/display/CONFLUENCEWIKI/Customising+Site+and+Space+Layouts

当编辑自定义 Decorator 模板文件的时候，有一些宏可被用来定义页面中复杂或者多变的内容，例如菜单，链接等。你可以插入这些宏到你的模板中。更多的信息，请参考Working With Decorator Macros 页面中的内容。   https://www.cwiki.us/display/CONFLUENCEWIKI/Customising+Site+and+Space+Layouts

希望编辑一个站点的 decorator 文件： 进入  > 基本配置（General Configuration） > 布局（Layouts ）（在Look and Feel 菜单下面） 在你希望进行编辑的 decorator .vmd 文件边上 创建自定义（Create Custom） 进行必要的修改后，单击 更新（Update） 如果你的修改导致了错误：单击 恢复默认（Reset Default）来恢复到原始的布局。     https://www.cwiki.us/display/CONFLUENCEWIKI/Customising+Site+and+Space+Layouts

你可以通过编辑布局文件来修改 Confluence 的外观和感觉（也可以被称为装饰）。编辑这些文件将会允许你对整个 Confluence 站点的外观和感觉进行修改或者仅仅是一个独立的空间。 当你对一个站点的布局进行编辑的时候，你需要修改每一个空间的默认布局调整文件，除了那些已经被被编辑过的的。请参考 Customize Space Layouts 页面来获得有关编辑单独空间的的相关信息。 同时你还需要具有  System Administrator 的权限来对站点进行修改。 如果你编辑了你的 Confluence 布局，那么每次你升级 Confluence 后你都需要对布局进行重新编辑。越多的自定义修改将会导致在升级的时候需要进行更多的工作。请查看页面 Upgrading Customized Site and Space Layouts 来确定在升级之前需要进行什么工作。 Confluence 是使用开源 SiteMesh 库进行网站页面的全局布局的。 希望对 Confluence 的布局进行调整，你需要编辑这些 decorator 文件。一个 decorator file 文件使用的是扩展文件名.vmd，这些文件是使用 Velocity 写的。你可以从 Velocity User Guide 中获得更多的使用指南。 一旦你熟悉 Velocity 的使用后，你可以对 decorator 文件进行编辑来对 Confluence 的展示进行自定制。 Confluence 中的 decorator 文件使用下面的一些分类： 站点布局（Site layouts）：这个被用于在站点页面中控制所有的布局，例如，页头，页脚和主面板。 内容布局（Content layouts）：这个被用于控制页面和博客页面中的内容。这个不能用来修改页面自己的显示，但是可以调制页面中的评论，附件的显示位置等。 导出布局（Export layouts）: 这些文件被用来控制空间和页面如何导出成 HTML。 https://www.cwiki.us/display/CONFLUENCEWIKI/Customising+Site+and+Space+Layouts