confluence是一款非常出色的知识管理工具,是我最喜欢的软件之一,配合jira是一套非常完美的项目管理软件。

在confluence的’Documentation Theme’主题下,默认情况下文档页面树形控件的节点是全部收缩的,每次刷新页面时树形控件都会重置,要找到一个节点时需要逐个父节点层层点击展开,体验很差。

但是Atlassian公司又何尝没有想到这一点,其实在’Documentation Theme’主题下带有自定义功能,通过编辑Navigation可以设置页面树的默认展开深度。

操作如下:
进入’空间管理’->’主题’,在’Documentation Theme’主题下点击’配置’,把’页面树’复选框取消,然后在Navigation文本框中输入标记代码:

[code]
{pagetree:startDepth=3|searchBox=true}
[/code]

其中startDepth属性表示展开深度,后面的数字可以根据你的喜好设置,个人认为默认展开3层是比较好的,否则如果在子页面太多的情况下展开多层,将影响载入速度。searchBox属性表示是否开启搜索功能。如果你希望默认展开树的功能可以在全站所有空间中生效,那么可以使用管理员帐号进入’站点管理’->’主题’中进行设置,操作步骤同上。

参考文档:
https://confluence.atlassian.com/display/DOC/Configuring+the+Documentation+Theme