Confluence 6 考虑使用自定义 CSS

原创

HoneyMoose 2021-08-11 09:43:11 博主文章分类：Confluence ©著作权

©著作权归作者所有：来自51CTO博客作者HoneyMoose的原创作品，请联系作者获取转载授权，否则将追究法律责任

CSS 的知识储备

如果你没有有关 CSS 的相关知识，请参考页面 CSS Resources section 中的内容。当你打算开始对 Confluence 的样式表进行修改之前，你应该对 CSS 有一些相关的了解和知识储备。

安全

自定义 CSS 有可能被在页面中注入脚本，有跨站点攻击的风险 cross-site scripting (XSS) 。当自定义脚本上传功能被启用后，空间管理员可以用自己的用户名和密码上传 CSS 样式表，然后触发浏览器在页面载入的时候运行脚本，这些脚本可能连空间管理员自己都不知道，甚至更加恶劣的能够获得管理员权限。正是基于这个考虑，这个功能在默认情况下是禁用的。Confluence 的管理员应该只启用他们熟悉的 CSS 文件，尽量避免使用来历不明的 CSS 文件来避免安全上的风险。

缩放

每个页面都需要进行缩放。基于每个用户使用的浏览器的不同，页面的内容应该能够基于不同的浏览器进行正确的缩放。你设计的 CSS 应该能够考虑到这种情况。尝试对 Confluence 的页面进行一些缩放的测试，这个测试需要对空间的很多页面进行测试，例如草稿箱，标签，页面继承等。你设计的样式表应该在任何情况下都能正常的工作，而不仅仅是第一页能正常工作就可以了。

不能禁用的特性

关闭一些链接，头，甚至是整个菜单是非常容易的，你只需要设置样式表为 'hidden' 就可以了。这个可能对对 Wiki 并不是很属性的用户能起到一些帮助。简单的 UI 设计能够更好的帮助用户进行使用。请注意，你隐藏的这些链接并不代表系统中的这些功能就不存在了。用户还可以通过修改自己浏览器的样式表来将这些功能重新使用或者获得访问使用的 URL。不要期待使用 CSS 能够帮你禁用 Confluence 的一些功能。

不应该被禁用的特性

对 Confluence 的用户希望相关的操作也能够同时在同样的地方显示出来。删除 Confluence 页面中的按钮或者隐藏这些按钮将会阻碍用户对 Confluence 的访问和使用，这些用户可能通过一些特定的 URL 来绕过你对按钮的禁用。

自定义 CSS 不能应用的管理员界面

你站点任何自定义 CSS 的使用将不会影响到系统管理员控制台。这样设置的意图是不能通过自定义 CSS 来阻止用户方法 Confluence 控制台的功能。

Confluence 版本兼容性

当你打算对你 Confluence 进行升级的时候，你需要小心。后续 Confluence 的版本可能对你当前使用的自定义 CSS 并不兼容——这个可能会导致你的 CSS 损坏，这个将会要求你在升级 Confluence 后可能对你的自定义 CSS 文件进行维护。请询问你的 Confluence 管理员获得更多信息。