超腾开源

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

2025-07-06 20:17:32 2025-10-10 20:58:08 李腾 31 次阅读 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优化，请仔细甄别，转载请注明转自www.hylab.cn，原文地址：XWiki文档树显示页面名称设置方法-导航面板优化教程

评论 (0)

请登录后发表评论

暂无评论，快来发表第一条评论吧！