XWiki导航优化:将页面标题改为文档名称的详细教程
本教程针对XWiki网站SEO优化后导航面板显示过长标题的问题,提供了完整的解决方案。通过修改Navigation组件配置,将默认的页面标题显示改为更简洁的文档名称显示,详细说明了从登录管理后台到修改代码、保存生效的全流程操作步骤,并附有效果对比图,帮助用户提升XWiki导航的可用性和美观度。
在XWiki中,左侧导航面板默认展示的是页面的标题而不是页面名称。当把XWiki当作一个网站时,需要对网站进行SEO,页面标题会起得很长。导航面板树上的文档名称看起来会非常长,非常不容易找到对应的节点。我们可以通过修改Navigation组件,把导航面板树上的页面标题改为页面名称。
修改方法
1、使用管理员用户登录XWiki,点击右上角展开侧边栏按钮,点击管理Wiki菜单,进入XWiki后台管理页面。

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

3、选择强行编辑。

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

## 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、点击保存并查看,清空浏览器缓存。
效果图
这是修改后的效果图,比修改前更清晰一些。

最后更新于6月前
本文由人工编写,AI优化,转载请注明原文地址: XWiki导航优化:将页面标题改为文档名称的详细教程
推荐阅读
CodeBuddyIDE与Trae终极对决:谁是最强国产AI编程IDE?最新版本深度横评
42442025-09-25
HuggingFace 新手避坑指南:模型怎么分类、名字怎么读、文件格式怎么选
442026-10-26
从入门到分布式 · 一文读懂 PyTorch 官方 Examples
432026-10-29
20个静态网站生成器按GitHub星标排完,我发现星标和能不能用完全是两回事
562026-10-20
OpenVPN安装配置完整指南:从零搭建安全VPN服务器与客户端
50142026-05-16
CodeBuddy 终端无法自动激活 Python 虚拟环境?一个配置解决(附完整排查过程)
652026-10-17
评论 (1)
请 登录 后发表评论
这个教程太及时了!我们团队最近正好在优化XWiki的导航体验,按照步骤操作后左侧树结构清爽多了。之前被冗长的页面标题困扰了好久,现在终于能快速定位文档了。