文档章节

Confluence 6 文档主题合并问答

honeymose
 honeymose
发布于 2018/12/10 10:32
字数 3103
阅读 11
收藏 0

在 Confluence 官方 前期发布的消息 中,文档主题在 Confluence 6.0 及其后续版本中已经不可用。我们知道你可能对这个有很多好好奇的问题,因此我们在这里设置了一个问答用于帮助你将这个主题升级到 Confluence 6.0。

如果你还有其他问题,你可以在本页面的底部向 Confluence 的官方提出,我们将会尽我们最大的努力帮助你解决你遇到的问题。

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

下面是文档主题的一个示例,文档主题和默认的主题的对比如下:

  1. 文档主题(Documentation theme): 可以自定义边栏内容。
  2. 默认主题(Default theme):在边栏中有自定义的内容。

如果还确定在我的空间中,我使用的是文档主题?

在你的空间中,检查你这个空间十分使用的是文档主题的最简单的方法是,在头部查找 浏览(Browse)菜单,通常这个在 创建(Create)按钮的附近。(如果你已经正在使用默认主题,你将会在边栏中看见空间工具菜单)。

如果检查在我的站点中有哪些地方使用了文档主题?

通常没有很好的方法来在一个站点中列出正在使用的文档主题列表。如果你的 Confluence 站点比较庞大,你的 Confluence 管理员可以使用下面的查询语句来从数据库中载入所有使用文档主题的列表。

SELECT *

FROM BANDANA B, SPACES S

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

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

© 著作权归作者所有

共有 人打赏支持
honeymose
粉丝 4
博文 439
码字总数 201537
作品 0
东城
私信 提问
Confluence 6 创建一个主题

如果你希望创建你自己的主题,你需要写一个 Confluence 插件。请参考我们开发文档中的下面页面 开始使用 插件开发。 请参考开发者指南的页面来 写一个 Confluence 主题。 使用 主题插件模块 ...

honeymoose
2018/05/07
0
0
Confluence 6 有关空间的一些提示

如果你已经为你的整个 Confluence 站点设置了特定主题(例如文档或者其他第三方的主题),你创建的空间将会集成你需要主题。如果你没有使用默认主题的话,你可能不能在边栏中看见蓝图。 Conf...

honeymose
2018/12/01
0
0
Confluence 6 SQL 异常的问题解决

如果你得到了与下面显示内容类似的信息话,那么你最好考虑修改 Confluence 的日志级别输出更多的信息。如果你考虑通过 Atlassian support 获得帮助,那么这些详细的错误信息能够更好的帮助我...

honeymose
2018/07/31
0
0
Confluence 6 为一个空间应用一个主题

主题允许你对 Confluence 的外表和显示进行自定义。你的 Confluence 空间管理员可以到 The Atlassian Marketplace 上下载主题。 一旦一个主题被安装到 Confluence 后,这个主题可以应用到全站...

honeymose
2018/12/10
0
0
Confluence 6 整合到支持的附件存储选项

如果你现在正在存储附件到 WebDav 或者你的数据库中。你可以整合附件的存储到文件系统中。当你的附件从数据库中被合并到文件系统后,你存储在数据库中的附件数据就可以从数据库中删除了。 当...

honeymose
2018/06/28
0
0

没有更多内容

加载失败,请刷新页面

加载更多

OSChina 周一乱弹 —— 白掌柜说了卖货不卖身

Osc乱弹歌单(2019)请戳(这里) 【今日歌曲】 @爱漫爱 :这是一场修行分享羽肿的单曲《Moony》 手机党少年们想听歌,请使劲儿戳(这里) @clouddyy :开不开心? 开心呀, 我又不爱睡懒觉…...

小小编辑
20分钟前
0
0
大数据教程(11.7)hadoop2.9.1平台上仓库工具hive1.2.2搭建

上一篇文章介绍了hive2.3.4的搭建,然而这个版本已经不能稳定的支持mapreduce程序。本篇博主将分享hive1.2.2工具搭建全过程。先说明:本节就直接在上一节的hadoop环境中搭建了! 一、下载apa...

em_aaron
25分钟前
0
0
开始看《JSP&Servlet学习笔记》

1:WEB应用简介。其中1.2.1对Web容器的工作流程写得不错 2:编写Servlet。搞清楚了Java的Web目录结构,以及Web.xml的一些配置作用。特别是讲了@WebServlet标签 3:请求与响应。更细致的讲了从...

max佩恩
56分钟前
2
0
mysql分区功能详细介绍,以及实例

一,什么是数据库分区 前段时间写过一篇关于mysql分表的的文章,下面来说一下什么是数据库分区,以mysql为例。mysql数据库中的数据是以文件的形势存在磁盘上的,默认放在/mysql/data下面(可...

吴伟祥
56分钟前
2
0
SQL语句查询

1.1 排序 通过order by语句,可以将查询出的结果进行排序。放置在select语句的最后。 格式: SELECT * FROM 表名 ORDER BY 排序字段ASC|DESC; ASC 升序 (默认) DESC 降序 1.查询所有商品信息,...

stars永恒
今天
2
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部