Confluence 6 文档主题合并问答

时间 2019-11-11

标签 confluence 文档主题合并问答繁體版

原文原文链接

在 Confluence 官方前期发布的消息中，文档主题在 Confluence 6.0 及其后续版本中已经不可用。咱们知道你可能对这个有不少好好奇的问题，所以咱们在这里设置了一个问答用于帮助你将这个主题升级到 Confluence 6.0。数据库

若是你还有其余问题，你能够在本页面的底部向 Confluence 的官方提出，咱们将会尽咱们最大的努力帮助你解决你遇到的问题。ide

默认的主题看起来是什么样子的？

下面是文档主题的一个示例，文档主题和默认的主题的对好比下：工具

文档主题（Documentation theme）： 能够自定义边栏内容。
默认主题（Default theme）：在边栏中有自定义的内容。

若是还肯定在个人空间中，我使用的是文档主题？

在你的空间中，检查你这个空间十分使用的是文档主题的最简单的方法是，在头部查找 浏览（Browse）菜单，一般这个在建立（Create）按钮的附近。（若是你已经正在使用默认主题，你将会在边栏中看见空间工具菜单）。布局

若是检查在个人站点中有哪些地方使用了文档主题？

一般没有很好的方法来在一个站点中列出正在使用的文档主题列表。若是你的 Confluence 站点比较庞大，你的 Confluence 管理员可使用下面的查询语句来从数据库中载入全部使用文档主题的列表。spa

SELECT *.net

FROM BANDANA B, SPACES Scode

WHERE B.BANDANAKEY='atlassian.confluence.theme.settings'orm

AND S.SPACEKEY=B.BANDANACONTEXT继承

AND B.BANDANAVALUE LIKE ('%documentation%')索引

ORDER BY S.SPACENAME;

这个查询只会找到使用文档主题的空间。这个查询不会包含空间使用的外观和布局（这些空间将会在你修改成站点主题的时候自动修改，你不须要每个空间都去修改一次）。

有关文档空间的自定义部分在我升级的时候有什么影响？

在升级的过程当中，咱们将会对当前使用文档主题的空间应用默认的主题。若是你对这些文档主题进行了自定义（例如，添加 Wiki 标记到边栏，页头，页脚），咱们将会把这些 Wiki 标记放置到默认主题的变量，页头，页脚。

默认的主题将会添加一些新的部分到边栏中。例如连接到页面，博客和空间的快捷连接。你也选择是否对这些连接进行隐藏，进入空间工具（Space Tools）> 配置边栏（Configure Sidebar），而后使用按钮来隐藏你不但愿显示的快捷连接。

个人空间将会在我升级后损坏吗？

这个与你对空间的自定义化程度有关。在大部分状况下，你的空间在升级后会看起来有些不一样，可是不至于出现彻底不一样，或者损坏的状况。

若是你使用了 CSS 来对你的空间进行了修改（无论你是否使用 Adaptavist Content Formatting 宏来修改了空间的样式表，例如 {style} 和 {div}，而且这些修改应用到了文档主题的边栏，页头，页脚）。你可能须要对你 CSS 文件中的一些名字进行修改才能让你的主题看起来是正确的。

例如，你在文档主题中指定了 #splitter-sidebar ，你将会须要在默认主题中使用 .acs-side-bar。

若是你经过 Confluence UI 自定义了默认的空间布局，而且你将这个默认布局应用到了你前期使用的文档空间中后，

若是你发现你遇到了这个问题，你须要重置损坏的布局。

经过 UI 重置损坏的自定义布局...

从数据库中删除自定义布局...

我能够全局的为边栏，页头，页尾添加自定义内容吗？

答案是能够的。进入 > 基本配置（General Configuration） > 边栏，页头和页脚（Sidebar, Header and Footer）。全部的空间使用的全局外观和布局将会继承你自定义的内容。任何自定义添加到边栏，页头和页脚中的内容将会被全局配置覆盖。

我还能够在边栏，页头或页尾使用宏吗？

是的，若是宏可以在文档主题中正确的工做的话，那么这些宏应该也是能够在默认主题中工做的。

我在哪里添加边栏，页头或页尾自定义内容？

你能够针对每个空间独立的在边栏，页头和页尾添加内容。使用下面的路径进行访问：空间工具（Space Tools） > 外观和布局（Look and Feel） > 边栏，页头和页脚（Sidebar, Header and Footer）或者全局的 > 基本配置（General Configuration） > 边栏，页头和页脚（Sidebar, Header and Footer）。

Confluence 为全部空间显示全局的自定义内容，直到空间具备本身自定义的内容（空间自定义的内容将会覆盖关键的自定义内容）。这个内容是经过一个字段，一个字段覆盖的，所以你有可能看到自定义的综合版本。例如，你可能全局的修改了页脚，可是一些独立的空间，你有一些页头的修改，那么你就会看到全局的页脚和独立的页头的修改。

如何在边栏的顶部关闭页面和博客的快捷连接？

进入 空间工具（Space Tools）> 配置边栏（Configure Sidebar），而后使用按钮来隐藏你不但愿显示的快捷连接。

我能够全局编辑默认主题的边栏吗？

不能够。你能够对全局边栏的内容进行自定义，可是对边栏中内容的隐藏，这是空间图标和添加快捷连接，你只能针对每个空间独立的操做。

我但愿查看页面树而不是子页面，我应该如何作？

进入 空间工具（Space Tools）> 配置边栏（Configure Sidebar） 而后在导航选项中选择 页面树（Page Tree）。

空间管理员和空间操做员在哪里？

为了体会在空间操做员和空间管理员中进行选择，文档主题有一个空间工具（Space Tools）菜单连接可以然你进行权限选项，内容工具，外观布局和整合。

这里是你新老主题的索引列表...

我必须在边栏，页头和页脚上使用 wiki 标记吗？

是的。咱们添加这个特性的主要目的是帮助任何可以从文档主题迁移到默认主题而不会有太多的影响。保持这些字段任然使用 Wiki 标记可以让你老的自定义内容不须要太多修改就能够应用到新的主题上。你仅仅须要复制张贴就能够了。

我能够隐藏或者修改空间标识的显示吗？

你可使用任何图片做为你的空间图标，可是你不能修改这个图片在边栏中的显示（这个图片老是圆形的而且会一直在页面的顶部）。

我能够隐藏默认的页面树而插入我本身的吗？

是的。在边栏中你对页面树的显示有彻底的控制权。你能够隐藏默认的页面数，同时你也能够在边栏中添加 Page Tree macro 宏 {pagetree}，来显示自定义内容。

我如何让个人页面标题在边栏中包裹起来？

页面标题不能在边栏的默认主题中包裹起来（无论你是使用默认的页面树仍是使用 {pagetree} 来显示自定义的内容）。不能对这个进行修改。

我能够在边栏中修改显示顺序吗？

你能够对边栏中的一些内容的显示顺序继续修改，例如快捷连接的顺序，可是边栏中的分类显示（sections）是不能对顺序进行调整的。任何具备图标的项目都是能够移动的。

自定义的内容显示在页面树的上面。你能够对默认的页面树进行隐藏，而后在自定义区域使用 WIki 标记将隐藏的页面树再添加回来。这个对你打算对页面树和自定义内容的显示顺序进行修改的时候比较有效。

我还可使用空间跳转宏（space jump macro）吗？

不能够。空间跳转宏是提供给文档主题使用的，当文档主题被删除后，这个宏就再也不可使用了。若是你在空间的页面，页头，页脚使用了这个宏，那么在升级的时候将会显示错误信息以下： unknown macro: {spacejump}。

要早点在你的站点中的那些页面上使用了空间跳转宏，你能够在站点的搜索对话框中输入 macroName:spacejump 。全部含有这个宏的页面将会返回显示出来（这个搜索只能搜索页面，不能搜索边栏，页头或页脚）。

为何子页面不能显示在页面下面？

默认空间主题不会在边栏下面列出子页面，你能够在页脚中使用 Children Display macro 宏来达到相似的效果。

我能够限制值搜索这个空间吗？

不能够。这个就是咱们要删除文档主题所具备的一个特性。

一个可选的方案是经过添加一个 Livesearch macro 宏到边栏或者空间主页中。在空间参数中使用 @self 来限制搜索只搜索当前的空间。

如何在空间中按字母查看页面？

若是你使用的是默认的主题，那么在这个主题中你不能按照字母顺序查看全部页面。

导入一个使用文档主题的空间将会发生什么？

你应该不会遇到什么问题，在导入这个空间的时候。可是默认的主题将会被应用到导入的空间中。若是你使用了自定的 Wiki 标记，也会自动合并到默认的主题中。在导出空间前，你应该拷贝边栏，页头，页脚中字段中的标记内容。这样你能够在导入成功后再将这些内容从新添加回来。

https://www.cwiki.us/display/CONF6ZH/Documentation+theme+migration+FAQ