超腾开源

XWiki文档树显示页面名称配置完整指南

2025-07-06 李腾 71 次阅读 0 次点赞
本文针对XWiki导航面板中文档树默认显示文档标题可能过长的问题，提供了完整的解决方案。通过修改Document Tree宏的配置，将显示内容从文档标题切换为页面名称。内容包括显示隐藏页面、定位Document Tree Macros、编辑源代码、注释特定代码段以及清除缓存等详细步骤，确保用户能够顺利完成配置优化。

XWiki导航面板的文档树和选择链接页面的文档树上默认展示的文档标题，但是文档标题太长，有时候希望展示文档名称。我们可以修改Document Tree宏的方法，让树上的文档显示文档名称而不是标题。

操作方法

1、在XWiki首页依次按 x x x h 快捷键，显示隐藏页面。

wechat_2025-10-10_201614_259.png

2、在搜索栏搜索Document Tree Macros。

wechat_2025-10-10_201746_766.png

3、点击进入Document Tree Macros页面，然后点击右上角编辑，强行编辑，显示源码。

wechat_2025-10-10_201937_567.png

4、在页面搜索以下两段代码，把这两段代码用 ## 注释掉，然后保存。

  ## #if ($docTreeConfig.showDocumentTitle)
  ##   #set ($docTreeConfig.orderBy = 'title')
  ## #end

  ## #if ($canViewDoc && $docTreeConfig.showDocumentTitle)
  ##   ## Display the translated title.
  ##   #set ($translatedDocument = $xwiki.getDocument($documentReference).translatedDocument)
  ##   #set ($plainTitle = $translatedDocument.plainTitle)
  ##   #if (!$stringtool.isBlank($plainTitle))
  ##     #set ($label = $plainTitle)
  ##   #end
  ## #end

5、清空浏览器缓存，刷新XWiki页面，就发现 导航树和选择页面的文档树上的页面已经变成文档名称了。按 x x x h 快捷键可以隐藏隐藏页面。

wechat_2025-10-10_202422_061.png

wechat_2025-10-10_202514_598.png

本文由人工编写，AI优化，转载请注明原文地址： XWiki文档树显示页面名称设置方法-导航面板优化教程

评论 (6)

请登录后发表评论
赵同学2025-11-22 13:11:02
感谢分享！这个方法解决了文档树标题过长的问题，操作步骤很清晰。请问修改后是否会影响其他页面的显示？
超腾开源2025-11-22 14:49:47
不影响，只会影响文档树的显示。
阳光女孩2025-11-21 15:22:06
感谢分享！这个方法解决了文档树标题过长的问题，操作步骤很清晰。不过修改源码会不会影响后续版本升级？
超腾开源2025-11-22 14:54:31
没有修改源码，不影响后续版本升级。
雨后的彩虹2025-11-21 11:11:03
感谢分享！这个设置方法很实用，解决了文档树标题过长的问题。不过修改源码会不会影响其他功能？
超腾开源2025-11-22 14:56:51
不影响