文档主题是 Confluence 提供主题的一种。文档主题为你的 Wiki 页面提供了一个内置的内容列表，一个可以配置头和脚和文本样式。你可以为查找结果设置限制在当前空间中还是在整个 Confluence 站点。

这个页面将会告诉你当你空间使用文档主题的时候如何查看页面。有关完全的特性列表，请参考 配置文档主题页面中的链接。

使用文档主题的快速指南：

• 左侧面板中包含一个页面树。这个页面树显示的是空间的页面列表。
• 单击页面树中的箭头来显示和隐藏子页面。
• 拖动中间的分隔栏来调整面板的宽度。
• 显示/隐藏左侧面板：单击位于搜索框边上的顶部右侧的边栏图标  来完全移除左侧边栏。再次单击这个图标来重新恢复左侧边栏。
• 可选的，输入你键盘上 '[' 来 显示/隐藏左侧的边栏。
• 重载一个空间限制查找：如果你的主题被配置为限制查找当前空间，你可以输入'all:' 然后加上你搜索的主题来在整个站点中进行搜索。

下面的页面将会针对上面的主题给予更多的细节。

使用文档主题

在使用文档主题的默认空间中，左侧的边栏包含有一个查找框和内容列表（页面树），这个页面树通常用于显示你空间中的所有页面。特殊的，这个显示空间主页下的子页面。

图片：文档主题中的默认设置

一个空间管理员可以对文档主题中下面的内容进行自定制：

• 修改左侧边栏中的主题和向页面中添加页头也页脚。这个可能会导致你的页面与下面的截图显示不同。
• 限制查找范围，这样查找将会只在当前空间中显示而不是整个 Confluence 站点。

图片：空间查找限制的文档主题

这里是你可以在页面中使用文档主题的一些概要：

• 通过在左侧面板中单击加号来打开和关闭页面树的方式（内容列表）。
• 通过单击边栏的边框来调制左侧面板中内容显示的宽度。
• 单击边栏图标  来移除左侧边栏。 这个删除只是针对你的，其他用户还是可以看到这个的。
• 单击边栏图标  来恢复左侧边栏。
• 可选的，输入你键盘上 '[' 来 显示/隐藏左侧的边栏。
• 使用滚动条来滚动左侧内容和右侧的滚动条来滚动右侧内容。
• 在空间和站点中查找内容。请参考下面的说明。

查找空间或者站点

当你在 Confluence 中使用文档主题的时候，Confluence 将会提供下面的一些查找选项。

使用页面顶部右侧的查询对话框：

• 默认情况下，Confluence 的主查询被配置为查询 Confluence 站点中的所有内容。
  • 你将会在页面顶部右侧查询框中看到字符 'Search Confluence'。
  • Confluence 查询将会在整个 Confluence 站点中进行查询。针对其他主题其查询效果是一样的。
• 空间管理员可以配置文档主题或者在当前空间中限制查询。
  • 你将会在页面顶部右侧查询框中看到字符 'Search this space' 。
  • 查询功能只会在当前的空间中进行查询。

  • 你可以重新设置查询的限制。输入 'all:' 后面再跟上字符串，将会在整个站点中进行查询。例如，在查询框中输入下面的内容，那么查询功能将会在整个站点中查询  'technical writing':

    all: technical writing
    

使用左侧面板中的查询对话框：

• 默认情况在，在文档主题中将会在左侧面板中包含一个查询对话框。输入你的恶查询字符串，这个查询将会被限制在只在本空间中进行查询。换句话说这个只会查询空间主页下面子页面中的内容。
• 如果你的管理员限制了主查询为当前空间的话，左侧面板的查询对话框就不会显示了。

提示和小技巧

下面是你在使用文档主题的时候的一些提示：

Confluence 文档使用的就是文档主题。如果你现在正在阅读在线的文档，请查看连接 Atlassian 文档 Wiki，你将可以看到一个能正常使用的文档主题。

空间中所有页面的页面结构树将会在租车面板中的页面树中显示出来。每一个空间都会有一个称为 Home 的单一页面。你可以在空间管理员中指定特定的页面为 Home 页面。

使用案例 1：你的页面不在空间主页下面。页面没有在左侧面板中显示的主要原因可能是这个：主题内容列表中显示的内容是 Home 页面下面的所有页面和子页面。如果你的页面在 Home 的页面树的上一级或者同级的话，这个页面将不会在左侧的面板中显示。

有下面 2 个办法可以修复这个问题：

• 你可以在空间管理员部分修改 Home 页面所指向的页面。
• 或者你可以拖动所有页面到当前 Home 页面的下面来是这些页面为这个页面的子页面。你可以在空间浏览屏幕下面来拖放页面。请查看 移动一个页面 中的内容。

使用案例 2：在 Confluence 3.1 升级到 Confluence 3.2 或者更高版本的时候出现文档主题插件使用问题。如果已经存在的 Confluence 安装已经有了 文档主题插件的安装。那么你有可能在升级到 Confluence 3.2 后在左侧面板中找到升级这个主题。这个修复将会启用所有的文档主题插件，请参考官方的 知识库（Knowledge base article）。

当你使用文档主题的时候，如果你的左侧面板完全消失的话，这有可能是你单击了顶部右侧的边栏图标  这个图标位于搜索框的边上。再次单击这个图标将会把左侧边栏恢复。

Confluence 用户界面不提供修改左侧导航边栏宽度的方法，换句话说，如果你使用的是文档主题，那么你将不能使用 Confluence 界面修改左侧边栏宽度。用户可以通过拖动中间栏来修改导航的宽度，但是默认情况下是不能配置的。你可以通过 CSS 文件来修改这个宽度，请参考：Documentation Theme - Default Width (in px) of left panel 中的说明。

备注

• Confluence 默认文档主题支持一个边栏，这个与文档主题的左侧面板是不同的。有关边栏的更多信息，请参考 找到内容 和 配置一个边栏页面。
• 文档主题在 Confluence 头部支持浏览菜单，这个能够给与空案件管理员高级选项。

来源：http://cwiki.ossez.com/pages/viewpage.action?pageId=3310740