xwiki使用教程

第一次打开XWiki的用教人多半会愣一下——页面左上角那个"创建页面"按钮点下去，跳出来的用教不是富文本编辑器，而是用教一个要求你选模板的弹窗。别急着关掉，用教这个设计其实藏着XWiki的用教核心逻辑：它把每个页面都当成一个可复用的结构化文档，而不是用教随手写的便签。

我去年帮一个五人小团队部署XWiki时，用教他们最常问的用教问题是"怎么把Word里的表格粘进去不乱"。答案有点反直觉：别直接粘。用教XWiki的用教编辑器对HTML表格支持很好，但Word会带一堆内联样式。用教正确做法是用教先在Word里把表格转成纯文本（用制表符分隔），粘贴到XWiki后选中文本，用教点工具栏那个"表格"图标里的用教"从CSV创建表格"。三秒搞定，用教格式干净得像手打的。

页面不是孤岛，链接才是骨架

XWiki最容易被低估的功能是链接语法。你不需要记住复杂路径，在编辑模式下输入两个左方括号[[，它会自动弹出当前空间的所有页面列表。更实用的是"链接到不存在的页面"——输入[[新页面名]]保存后，那个链接会显示为红色，点击就直接创建新页面。我习惯用这招做知识库的占位符：先把所有想写的主题列成红色链接，再一个个填内容。比先建空页面再改标题快得多。

有个细节值得说：XWiki的链接是双向的。在A页面链接到B页面后，B页面底部会自动出现"反向链接"区域。有次我查一个API文档，发现它被三个不同项目页面引用，顺着反向链接摸过去，直接找到了三个实际调用案例。这种意外发现比搜索框好用。

权限设置里的坑

默认情况下，XWiki给所有登录用户开放编辑权限。小团队无所谓，但超过十个人就会乱。在"管理"→"页面权限"里，别只盯着"编辑"权限。真正要改的是"管理员"权限——把它从XWikiAdminGroup移到你自己的用户组，否则任何登录用户都能进管理后台改配置。

还有个隐藏设置：页面级权限会覆盖空间级权限。有次同事抱怨"我明明把整个空间设成只读了，怎么还能改某个页面"，查了半天发现那个页面单独给了编辑权限。XWiki的权限模型是"就近原则"，页面设置优先于空间，空间优先于全局。改权限前先看页面右上角的锁图标是不是亮的。

搜索比你想的聪明

别用顶部那个搜索框搜中文。XWiki默认的Lucene索引对中文分词支持一般，搜"用户管理"可能只匹配到包含完整词组的页面。更好的办法是进"搜索"页面（快捷键Ctrl+G），在高级选项里把"分词器"改成"中文分词器"。如果没这个选项，说明你的XWiki版本低于14.10，升级或者用通配符：用户*管理。

宏功能里最实用的是{ { velocity}}。有次需要列出所有标记为"待审核"的页面，用{ { velocity}}#foreach($page in $xwiki.searchDocuments("where doc.status='待审核'"))$page #end{ { /velocity}}直接生成了动态列表。比手动维护索引页省事。Velocity语法不用学太深，会改几个变量就能解决八成动态需求。

最后说个反常识的：XWiki的"删除"其实是"移到回收站"，但回收站默认只保留30天。如果你删的是重要页面，立刻去"管理"→"回收站"里点"恢复"。更稳妥的做法是给关键页面加个{ { protected}}宏，这样删除按钮会变灰。我吃过亏——删了一个配置文档，第31天想恢复时发现回收站已经清空了。

本文地址：http://www.79wt.cn/news/121d9599783.html