Confluence 6 自定义 Decorator 模板的宏和针对高级用户

Posted 2020-11-03

宏

页面的某些部分使用的是 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