超腾开源

XWiki导航面板显示文档名称的完整配置指南

2024-12-01 李腾 96 次阅读 0 次点赞
本教程针对XWiki网站SEO优化后导航面板显示过长标题的问题，提供了完整的解决方案。通过修改Navigation组件配置，将默认的页面标题显示改为更简洁的文档名称显示，详细说明了从登录管理后台到修改代码、保存生效的全流程操作步骤，并附有效果对比图，帮助用户提升XWiki导航的可用性和美观度。

在XWiki中，左侧导航面板默认展示的是页面的标题而不是页面名称。当把XWiki当作一个网站时，需要对网站进行SEO，页面标题会起得很长。导航面板树上的文档名称看起来会非常长，非常不容易找到对应的节点。我们可以通过修改Navigation组件，把导航面板树上的页面标题改为页面名称。

修改方法

1、使用管理员用户登录XWiki，点击右上角展开侧边栏按钮，点击管理Wiki菜单，进入XWiki后台管理页面。

ScreenShot_2025-10-16_220805_395.png

2、选择外观、面板编辑、面板列表、NAVIGATION。找到Navigation组件，点击编辑。

ScreenShot_2025-10-16_221045_700.png

3、选择强行编辑。

ScreenShot_2025-10-16_221202_217.png

4、在内容文本框，找到以下代码，修改showDocumentTitle="false"即可。

ScreenShot_2025-10-16_221346_796.png

## Other page exclusions.
#foreach ($exclusion in $config.getValue('exclusions'))
  #set ($exclusionReference = $services.model.resolveDocument($exclusion))
  #if ($exclusionReference.name == $defaultDocumentName)
    #set ($exclusionReference = $exclusionReference.lastSpaceReference)
  #end
  #set ($discard = $exclusions.add($exclusionReference.type.lowerCase + ':'
    + $services.model.serialize($exclusionReference, 'local')))
#end
#set ($exclusions = $stringtool.join($exclusions, ','))
{{documentTree showTranslations="false" showDocumentTitle="false" showAttachments="false" compact="true" openTo="document:$openToDoc"
  exclusions="$exclusions" /}}
#panelfooter()
{{/velocity}}

5、点击保存并查看，清空浏览器缓存。

效果图

这是修改后的效果图，比修改前更清晰一些。

ScreenShot_2025-10-16_221738_586.png

本文由人工编写，AI优化，转载请注明原文地址： XWiki导航优化：将页面标题改为文档名称的详细教程

评论 (1)

请登录后发表评论
林小欣2025-11-08 15:16:25
这个教程太及时了！我们团队最近正好在优化XWiki的导航体验，按照步骤操作后左侧树结构清爽多了。之前被冗长的页面标题困扰了好久，现在终于能快速定位文档了。