You need to enable JavaScript to run this app. 如何在MediaWiki 1.35.1自建Wiki中启用Cite扩展原型引文分组功能
优惠活动
大模型
产品
解决方案
定价
更多

如何在MediaWiki 1.35.1自建Wiki中启用Cite扩展原型引文分组功能

MediaWiki 1.35.1 启用Cite扩展引文分组功能的配置步骤
  • 首先明确问题核心诱因
    你当前遇到的“extends属性不被识别、抛出ref标签非法报错”的问题,本质是两处配置错位:
    • 拉取的扩展代码和1.35.1核心的兼容性不足
    • 原型功能的专属开关未手动打开
  • 第一步:替换兼容版本的Cite扩展文件
    • 直接从代码库拉取主分支对应提交哈希的扩展包存在适配问题:主分支代码是跟随最新版MediaWiki开发的,对应提交的代码依赖了1.35版本核心不存在的接口,就算把文件放到extensions目录,扩展加载时也会自动屏蔽原型功能的解析逻辑
    • 正确操作是切换到Cite扩展的REL1_35长期支持分支,拉取和beta集群同时间节点的匹配版本代码,替换原有目录下的扩展文件,确保扩展的接口调用和当前MediaWiki 1.35.1核心完全适配
  • 第二步:修正扩展加载配置
    • 废弃老版本MediaWiki通用的require_once加载方式,1.35版本要求通过标准的wfLoadExtension方法加载Cite扩展,在LocalSettings.php的核心初始化代码之后添加加载行:
      wfLoadExtension( 'Cite' );
      
    • 注意加载顺序必须在所有和内容解析相关的扩展之前,避免被其他扩展拦截ref标签的解析流程
  • 第三步:手动开启原型功能开关
    • 引文分组的extends属性属于未正式发布的实验性特性,默认状态是关闭的。beta集群的测试环境已经预置了这个开关的开启配置,自建站点不会自动带上这个设置,必须手动在LocalSettings.php末尾添加配置项:
      // 开启Cite扩展的引文分组(extends属性支持)
      $wgCiteEnableExtends = true;
      
    • 这个开关就是报错的直接触发源:功能关闭状态下,解析器遇到带extends属性的标签,会直接判定为非法属性结构,抛出通用的“Invalid tag; invalid names, e.g. too many”报错,不会单独提示该功能未开启
  • 第四步:清缓存验证生效
    • 配置修改完成后,进入站点maintenance目录,依次执行两个脚本清除旧缓存:
      php update.php
      php purgeCache.php
      
    • 清除完成后新建测试页面,写入带extends属性的ref标签样例,确认无报错即代表配置成功

本内容对应的提问来源于stack exchange,提问作者Presto

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 15:36:10