Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

中文标题【升级自定义的站点和空间布局】

随着 Confluence 的演变。默认的站点和空间布局也会随着 Confluence 升级而让使用的所有页面进行改变。随着一些新功能的加入和一些老功能的修改,默认的布局也需要进行修改来支持这些改变。

Note

如果你使用的是基于 Confluence 前期版本的 自定义布局,你可能会遇到 损坏的功能(breaking functionality)或者更糟糕的你将不能使用新 Confluence 中的功能

你需要针对每一个新 Confluence 版本的发布来将你的修改应用到所有的新模板中。

希望应用你的自定义布局,你需要:

  1. 从你前期 Confluence 的版本中获得你自定义的源代码。
  2. 将这些你自定义的源代码应用到新的默认布局中。

第一步:获得你的自定义布局

我们建议你在对站点进行布局修改的时候,你需要为你修改的 Confluence 站点或空间布局保留所有的修改记录。

如果没有的话,你应该可以通过下面的办法找到你的自定义修改。这个方法将会把你对全部网站和空间级别的修改以一个单一的输出而表现出来。从这个输出文件,你应该能找到你修改过的自定义文件。

Tip

这个方法对下面的一些情况是非常有用的:

  • 很多空间都有自己的自定义修改,或者
  • 针对你的站点布局你已经没有独立的记录了。

所有的自定义布局存储在  DECORATOR 表中,这个表是 Confluence 使用的数据库。你可以使用  SELECT SQL 语句从数据库中找到这些:

No Format
mysql> select SPACEKEY,DECORATORNAME,BODY from DECORATOR;
+----------+---------------------+------+
| SPACEKEY | DECORATORNAME       | BODY |
+----------+---------------------+------+
| NULL     | decorators/main.vmd | ...  |
+----------+---------------------+------+
1 row in set (0.03 sec)

上面的例子是针对 MySQL 的,如果使用的是其他的数据库,上面的 SQL 应该也是可用的。

第二步,应用你的自定义布局

当你升级你的 Confluence 到其他一个主要的 Confluence 发行版本的时候,你需要手动应用你修改过的任何全局或者空间级别的布局。除非有特殊的声明,针对一些非主要的 Confluence 升级,你的自定义修改应该是不需要重新应用上去的。

什么是主要版本,什么是非主要版本?主要版本的的升级主要是指 Confluence 的版本号升级为小数点前后一位的数字变化,例如 Confluence 的版本升级 3.0 到 3.1,或者 2.8 到 3.0 都被认为是主要版本升级。非主要版本升级主要为第一位小数点之后小数点标记的升级,例如 Confluence 3.0 到 3.0.1 不认为是主要版本升级。

如果你对 Confluence 的全局站点进行了修改:

  1. Excerpt Include
    Navigating to the Administration Console
    Navigating to the Administration Console
    nopaneltrue
  2. 在左侧的导航面板中选择 布局(Layouts),decorator 文件按照在 Site, Content Export 布局进行分组。
  3. 请确定你有所有你的自定义文件可用(可用使用复制张贴方式进行处理)。
  4. 对你希望进行自定义方式进行页面调整的布局,单击 重置默认(Reset Default)
  5. 在希望处理的布局中,单击 创建自定义(Create Custom)然后将你的自定义文件应用上去(通过复制粘贴方式)到正确的位置上,来应用为默认的布局。
  6. 单击 保存(Save)按钮。
  7. 对你希望进行自定义的页面,重复上面的步骤 4 的操作。

如果你已经对布局进行了自定义的操作:

  1. Excerpt Include
    _SpaceTools_LookAndFeel
    _SpaceTools_LookAndFeel
    nopaneltrue
     
  2. 在左侧的导航面板中选择 布局(Layouts),decorator 文件按照在 Site, Content Export 布局进行分组。
  3. 请确定你有所有你的自定义文件可用(可用使用复制张贴方式进行处理)。
  4. 对你希望进行自定义方式进行页面调整的布局,单击 重置默认(Reset Default)
  5. 在希望处理的布局中,单击 创建自定义(Create Custom)然后将你的自定义文件应用上去(通过复制粘贴方式)到正确的位置上,来应用为默认的布局。
  6. 单击 保存(Save)按钮。
  7. 对你希望进行自定义的页面,重复上面步骤 5 的操作。

第三步,仔细测试你的修改

修改可能对 Confluence 的后续版本不兼容,当你对 Confluence 进行升级的时候,你应该总是对你自定义修改的模板文件进行仔细的测试来确定所有的修改对新版本的 Confluence 兼容。在上线之前,请进行仔细的测试。

有关自定义修改的所有操作都不会得到 Atlassian 的技术支持。

关闭缓存

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:

  1. 停止 Confluence
  2. 备份你需要修改的 JAR 文件。
  3. Un-jar 文件。
  4. 对希望修改的文件找到文件所在的位置和进行正确的修改配置。
  5. Re-jar the confluence-x.x.x.jar 文件。
  6. 找到 JAR 文件应该保存的正确位置,然后将修改的文件替换掉服务器上的文件。
  7. 重启 Confluence。