希望编辑一个站点的 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

如果你希望创建你自己的主题，你需要写一个 Confluence 插件。请参考我们开发文档中的下面页面 开始使用 插件开发。 请参考开发者指南的页面来 写一个 Confluence 主题。 使用 主题插件模块 来创建一个主题。   https://www.cwiki.us/display/CONFLUENCEWIKI/Creating+a+Theme

主题被用来在你的 Confluence 站点中应用表现形式。请查看 Working with Themes 页面来查看如何应用你的整个站点和如何添加更多的主题。 希望在站点中应用主题： 进入  > 基本配置（General Configuration） > 主题（Themes）。 这个界面将会显示可用的主题，然后选择一个主题。 选择 确认（Confirm）。 所有使用 全局外观和表现（Global look and feel）的空间将会继承应用你选择的全局主题，你在全局表现中修改的外观将会应用到这些空间中。   https://www.cwiki.us/display/CONFLUENCEWIKI/Applying+a+Theme+to+a+Site  

主题是被用来修改 Confluence 站点或空间的外观的。 Confluence 安装了一个单一的默认主题，或者你也可以下载和安装其他的主题。你可以从 The Atlassian Marketplace 中搜索你要的主题。 一旦主题被安装了，这个主题可以应用到全站也可以应用到某一个空间。 希望查看你站点中已经安装的主题： 进入  > 基本配置（General Configuration） > 主题（Themes）。 你可以看到你站点中安装的所有主题列表。 当一个新的空间被创建的时候将会应用当前站点使用的全局主题。空间主题可以被任何具有具有空间管理员权限的用户进行修改和调整。 有关文档主题（Documentation theme）的说明 文档主题在 Confluence 5.9 及其早期版本可用。很多文档主题的特性现在也都能够在 Confluence 默认主题中可用。 请查看 Develop Technical Documentation in Confluence 页面中的内容来获取使用文档主题和默认主题的相关信息。 进入主题页面的菜单   当前主题列表   https://www.cwiki.us/display/CONFLUENCEWIKI/Working+with+Themes

Confluence 提供了通过层叠样式表（CSS）调整页面展示情况的能力。本页面帮助你理解如何在 Confluence 中使用一些 CSS 样式修改字体样式和字体大小。 下面的代码为自定义的字体代码。你可以通过空间管理员复制粘贴到空间样式表中。 修改字体 为了在 Confluence 中自定义字体，你首先需要为 body 设置你需要的字体。随后，你肯能需要调整字体的大小，因为每一个字体样式的相对大小是不同的。 相关的 CSS 样式表如下显示。这个样式表修改了默认字体，将默认字体从 Helvetica/Arial – sans serif  修改为 Times/Times New Roman – serif。实际上字体 Times 相对 Helvetica 来说要小一些，所以我们将字体大小增加到了 14px。 在这个样式表中有很多 'wiki-content' 这个标记，这个定义了在 Wiki 正文中需要针对字体大小进行一些必要修改的标签。 body {     font-family: Times, "Times New Roman", serif;     font-size: 14px; } .wiki-content, .wiki-content p, .wiki-content table, .wiki-content tr, .wiki-content td, .wiki-content th, .wiki-content ol, .wiki-content ul, .wiki-content li {     font-size: 14px; }   https://www.cwiki.us/display/CONFLUENCEWIKI/Styling+Fonts+in+Confluence

开始编辑空间样式表 一个空间的样式表是你开始对 CSS 进行自定义编辑的好的开始。在空间样式表中，包含了你所有可以进行修改的元素。当你对空间样式表进行编辑的时候，空间样式表的修改只会对你修改的空间有效，并且会应用到所有的空间页面中。在空间样式表中创建一些样式，然后进行测试，当没有问题后，你可以将这些样式应用到整个站点上。然后你可以对Confluence 的 CSS 进行更多的自定义包括调整搜索页，主面板和其他的一些整体页面。 使用正确的工具 Confluence 的 CSS 也具有相当的复杂性，Web 开发工具将会帮助你理解页面的样式表是如何被创建的的。针对一些具体的情况，你可能需要查看页面已经存在的源代码。下面的一些免费工具将会帮助你对源代码进行调试和查看。h as the following free applications will allow you to do this. 1. Firebug Firebug，是一个 Firefox 浏览器的插件。这个插件允许你对你页面中元素的样式表进行查看。这个工具对你对当前元素的样式表进行分析非常有效，例如仅仅应用在头部的样式表。 2. Web Developer Web Developer 是一个针对 Firefox 的插件，这个插件允许你在页面中直接对 CSS 进行编辑和创建一个新的设计。 3. CSS Edit CSS 编辑器是一个为 Macintosh 系统编辑使用 CSS 的独立编辑器。这个编辑器能够获取当前所有的 CSS 样式表，然后允许你对这些样式表重新进行编辑。 从简单的元素开始 你可以从一些简单的原始开始编辑，通过这些编辑来看这些修改是如何工作的。当对 CSS 进行修改后，对每一个修改你都应该查看下效果，这样有助于更好的分析和解决问题。请注意一些页面的元素可能比其他页面更适合进行编辑。例如，为页面添加一个 gradient 到工具栏相对于修改整个页面的宽度能够让 CSS 更好的工作，而不会导致页面损坏。编辑合适的静态元素，例如背景图片相对于设计整个节目或者使用 JavaScript 来进行下拉菜单展示就更加精确的表现页面情况（其实也不建议在使用 JavaScript 做过多修改） 。   https://www.cwiki.us/display/CONFLUENCEWIKI/Basic+Styling+Tutorial

Confluence 默认页面的顶部是有关站点的菜单连接，在这里定义了 快速连接， 浏览菜单，用户菜单和快速查找输入框。在这个示例中，我们将会尝试修改顶部的菜单部分的背景和一些自定义的图片。 创建一个自定义图片。在这个例子中，我们将会创建一个自定义头图片，使用 1046 x 61 像素。 上传自定义图片到你希望自定义的空间页面中。 注意你需要上传新图片的（在这个例子中页面 ID 是 658833839）。 为头部的修改创建你的自定义 CSS 文件。在这个例子中，我们上传的的新图片文件（被称为 header.png），针对特定的页面ID（页面 ID 为 658833839）。这个文件也在相同的空间中。 #header .aui-header { background-image:url('../download/attachments/658833839/header.png'); background-repeat: no-repeat; } 以空间管理员身份登录系统。 打开空间管理员界面。 单击 样式表（Stylesheet）。 单击 编辑（Edit）来修改文本输入框中的代码。 张贴你自定义的 CSS 文件到文本输入框中。 单击 保存（Save）然后重新载入页面（你可能需要强制刷新你的浏览器）。空间的背景将会被修改。 自定义的头文件将会在空间的所有页面中被应用。希望删除这个修改恢复到原始状态的话，你可以简单的删除样式表中的所有内容，单击 保存（Save）就可以了。   https://www.cwiki.us/display/CONFLUENCEWIKI/Basic+Styling+Tutorial

希望编辑空间的 CSS 样式表： 进入空间后，然后从边栏的底部选择 空间工具（Space tools） > 外观和感觉（Look and Feel） 。 然后选择 样式表（Stylesheet）后选择 编辑（Edit）。 将你的自定义 CSS 复制粘贴到文本输入框中。 保存你的修改。新的 CSS 效果将会应用到这个空间的所有内容页面中。   https://www.cwiki.us/display/CONFLUENCEWIKI/Basic+Styling+Tutorial

CSS 的知识储备 如果你没有有关 CSS 的相关知识，请参考页面  CSS Resources section 中的内容。当你打算开始对 Confluence 的样式表进行修改之前，你应该对 CSS 有一些相关的了解和知识储备。 安全 自定义 CSS 有可能被在页面中注入脚本，有跨站点攻击的风险 cross-site scripting (XSS) 。当自定义脚本上传功能被启用后，空间管理员可以用自己的用户名和密码上传 CSS 样式表，然后触发浏览器在页面载入的时候运行脚本，这些脚本可能连空间管理员自己都不知道，甚至更加恶劣的能够获得管理员权限。正是基于这个考虑，这个功能在默认情况下是禁用的。Confluence 的管理员应该只启用他们熟悉的 CSS 文件，尽量避免使用来历不明的 CSS 文件来避免安全上的风险。 缩放 每个页面都需要进行缩放。基于每个用户使用的浏览器的不同，页面的内容应该能够基于不同的浏览器进行正确的缩放。你设计的 CSS 应该能够考虑到这种情况。尝试对 Confluence 的页面进行一些缩放的测试，这个测试需要对空间的很多页面进行测试，例如草稿箱，标签，页面继承等。你设计的样式表应该在任何情况下都能正常的工作，而不仅仅是第一页能正常工作就可以了。 不能禁用的特性 关闭一些链接，头，甚至是整个菜单是非常容易的，你只需要设置样式表为 'hidden' 就可以了。这个可能对对 Wiki 并不是很属性的用户能起到一些帮助。简单的 UI 设计能够更好的帮助用户进行使用。请注意，你隐藏的这些链接并不代表系统中的这些功能就不存在了。用户还可以通过修改自己浏览器的样式表来将这些功能重新使用或者获得访问使用的 URL。不要期待使用 CSS 能够帮你禁用 Confluence 的一些功能。 不应该被禁用的特性 对 Confluence 的用户希望相关的操作也能够同时在同样的地方显示出来。删除 Confluence 页面中的按钮或者隐藏这些按钮将会阻碍用户对 Confluence 的访问和使用，这些用户可能通过一些特定的 URL 来绕过你对按钮的禁用。 自定义 CSS 不能应用的管理员界面 你站点任何自定义 CSS 的使用将不会影响到系统管理员控制台。这样设置的意图是不能通过自定义 CSS 来阻止用户方法 Confluence 控制台的功能。 Confluence 版本兼容性 当你打算对你 Confluence 进行升级的时候，你需要小心。后续 Confluence 的版本可能对你当前使用的自定义 CSS 并不兼容——这个可能会导致你的 CSS 损坏，这个将会要求你在升级 Confluence 后可能对你的自定义 CSS 文件进行维护。请询问你的 Confluence 管理员获得更多信息。 在不同浏览器中测试 你应该对你的修改 CSS 后的 Confluence 站点在不同的浏览器中进行测试。Internet Explorer, Chrome， Firefox，Opera 和 Safari (Mac OS X) 是绝大部分用户使用的浏览器 不支持 CSS 自定义 创建自定义的 CSS 可能会导致各种潜在的可能性，Atlassian 将不会对自定义 CSS 产生或相关的问题提供支持。   https://www.cwiki.us/display/CONFLUENCEWIKI/Styling+Confluence+with+CSS