模板是一个预先定义的页面，这个预先定义的页面可以在创建新页面的时候预先载入。模板能够给一个页面统一的样式或格式。 你可以在 Confluence 中创建你自己的模板，请查看页面 Create a Template 页面的相关内容。 更多的，你可以从 Atlassian 市场 中下载已经预先定义的模板。每一个模板组件包含有一个或者多个模板，这些模板组件由 Atlassian 或者其他第三方开发商创建。下面是所需要步骤的总结： 从 Atlassian Marketplace 中下载模板组件。 将你下载的模板组件安装到 Confluence 站点中。 通过导入操作将你安装的模板组件应用到站点或者独立的空间中。 你需要具有系统管理员权限来在你的 Confluence 站点中安装模板组件。你需要具有 Confluence 管理员权限来管理已经导入和存在的的模板组件。请参考 Global Permissions Overview 页面中的内容。 https://www.cwiki.us/display/CONFLUENCEWIKI/Importing+Templates

模板是一个预先定义的页面，这个预先定义的页面可以在创建新页面的时候预先载入。模板可以由用户创建也可以通过蓝图提供。请查看 Page Templates 和 Blueprints 页面中的内容。 管理员也可以导入模板，能够让使用 Confluence 的用户使用导入的模板。请参考 Importing Templates 页面中的内容。 Confluence 也可以提供 系统模板（system templates）。这个模板针对欢迎消息提供了默认的内容（请参考 Administering Site Templates) 和 default space content （请参考 Administering Site Templates）。 管理员也可以禁用模板和蓝图。通过禁用这2 个内容，可以阻止在 Confluence 创建空间对话框中显示相关的内容。 希望在 Confluence 站点中禁用（disable）模板或者蓝图： 在屏幕的右上角单击 控制台按钮 ，然后选择 General Configuration 链接。 选择 全局模板和蓝图（Global Templates and Blueprints）. 在你希望禁用的模板，页面蓝图或者空间蓝图边上选择 禁用（Disable ）。 管理员也可以随时启用这些模板和蓝图。   https://www.cwiki.us/display/CONFLUENCEWIKI/Administering+Site+Templates

Confluence 构建了一些有用的默认设置，这些设置能够让第一次访问使用 Confluence 系统的用户更好的了解系统。同时默认的内容将新空间和其他区域放置在 Confluence 中。 Confluence 的管理员可以修改这些设置来自定义他们 Confluence 站点的默认表现和内容。 Administering Site Templates Importing Templates Changing the Site Title Choosing a Default Language Configuring the Administrator Contact Page Configuring the Site Home Page Customizing Default Space Content Editing the Site Welcome Message   https://www.cwiki.us/display/CONFLUENCEWIKI/Changing+the+Default+Behavior+and+Content+in+Confluence

宏 页面的某些部分使用的是 Velocity  宏进行创建的，包括导航栏。有关宏的创建，你可以参考页面 Working With Decorator Macros 页面中的内容。 针对高级用户 velocity 目录是 Confluence 首先进行模板搜索的查找路径。你可以对 Confluence 的 velocity 的模板文件进行重载。前提是你需要将文件放置到正确的位置。 当然，我们并不建议你这样做，因为这样能够让你对 Confluence 的界面和外观有完全的操作，这个操作将会可能导致整个页面布局的损坏。你可以使用文本编辑器对这些模板文件进行编辑，你不能使用浏览器进行编辑。 对上面的模板文件进行编辑的时候，有下面 2 个注意事项： Velocity 被配置使用内存进行缓存。当你在 Confluence 中直接进行修改的时候，Confluence 将会指导从磁盘中重新载入修改的模板文件。如果你直接在磁盘上进行修改的话，Confluence 不知道如何载入并刷新缓存 WEB-INF/classes/velocity.properties 中定义的缓存或者重新启动 Confluence。 修改可能对后续的 Confluence 并不兼容。当你对 Confluence 的模板文件进行了修改后，你应该在后续 Confluence 的升级过程中对修改过的模板进行校验。否则有可能会导致页面损坏。 https://www.cwiki.us/display/CONFLUENCEWIKI/Custom+Decorator+Templates

希望对 Confluence 的 decorator 进行编辑的话，你需要具有良好的 HTML 知识和能够理解  Velocity 模板语言。 希望编辑 decorator 文件： 进入  Confluence 管理（Confluence Admin） > 布局（Layouts）. 在你希望进行编辑的 decorator  文件边上选择 创建自定义（Create Custom）。 保存你的修改。 如果你创建了错误的修改，你可以选择 decorator 编辑过的选项，选择 重置默认（Reset Default）来恢复默认配置。 可选的，自定义的模板文件应该存储在数据库中的 DECORATOR  表中。如果你有时候你的修改导致你的 Confluence 完全不可用了，你可以删除 DECORATOR  表中的相关记录。   https://www.cwiki.us/display/CONFLUENCEWIKI/Custom+Decorator+Templates

在任何时候，你都可以使用 "Site Layouts" 页面中的 "View Default" 来浏览默认的 decorator 文件。模板浏览器允许你查看使用 "#parsed" 包含在模板文件中的其他模板。当你不能对嵌入的模板进行编辑的时候，你可能需要拷贝部分或者全部的嵌入模板到你的自定义模板中。   https://www.cwiki.us/display/CONFLUENCEWIKI/Custom+Decorator+Templates

Confluence 是使用开源的 SiteMesh 库构建的。一个 Web 页面的布局系统，这个布局系统能够在全站点中提供完整统一的界面和外观。SiteMesh 是通过 "decorators" 工作的，这个文件定义了页面的布局和结构，同时指定了页面特定的内容将会如何进行布局。如果你有兴趣的话，你可以阅读有关SiteMesh 的文档。 在你对 Confluence 的界面和外观进行编辑的时候将会意味着什么呢： "Main" decorator 定义了页面的头部和页面的脚部 "Page" decorator 定义了页面是如何显示的 "Printable" decorator 定义了页面打印版本中的界面和外观。 你可以在 Confluence 中查看和编辑这些 decorator 文件。修改这些 decorator  文件将会对 Confluence 的所有空间产生影响，这个修改是全局的。 使用 decorator 来创建 Confluence 的管理员界面的是不能进行修改的。这样设置的原因是为了避免你对 decorator 文件可能的错误修改会导致整个 Confluence 站点不可用，管理员应该还需要有特定的界面可用将修改错误的 decorator 文件复原。   https://www.cwiki.us/display/CONFLUENCEWIKI/Custom+Decorator+Templates

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