首页 > 技术文章 > Confluence 6 自定义 Decorator 模板的宏和针对高级用户

huyuchengus 2018-05-10 02:15 原文

页面的某些部分使用的是 Velocity  宏进行创建的,包括导航栏。有关宏的创建,你可以参考页面 Working With Decorator Macros 页面中的内容。

针对高级用户

velocity 目录是 Confluence 首先进行模板搜索的查找路径。你可以对 Confluence 的 velocity 的模板文件进行重载。前提是你需要将文件放置到正确的位置。

当然,我们并不建议你这样做,因为这样能够让你对 Confluence 的界面和外观有完全的操作,这个操作将会可能导致整个页面布局的损坏。你可以使用文本编辑器对这些模板文件进行编辑,你不能使用浏览器进行编辑。

对上面的模板文件进行编辑的时候,有下面 2 个注意事项:

  1. Velocity 被配置使用内存进行缓存。当你在 Confluence 中直接进行修改的时候,Confluence 将会指导从磁盘中重新载入修改的模板文件。如果你直接在磁盘上进行修改的话,Confluence 不知道如何载入并刷新缓存 WEB-INF/classes/velocity.properties 中定义的缓存或者重新启动 Confluence。
  2. 修改可能对后续的 Confluence 并不兼容。当你对 Confluence 的模板文件进行了修改后,你应该在后续 Confluence 的升级过程中对修改过的模板进行校验。否则有可能会导致页面损坏。

https://www.cwiki.us/display/CONFLUENCEWIKI/Custom+Decorator+Templates

推荐阅读