如何实现从Microsoft Word向MediaWiki的无摩擦发布？

以下是实际落地过的几种方案，完美适配跨Windows/MacOS的Word创作流程，无需改变创作者原有习惯：

方案1：VBA宏 + MediaWiki API 一键发布 #

这是最贴合需求的方案，直接在Word内集成发布功能：

• 核心逻辑：
  1. 格式转换：通过VBA遍历Word文档内容，将Word样式映射为MediaWiki WikiText格式（比如Word标题→= 标题 =，加粗→''加粗文本''，有序列表→# 列表项）。
  2. 媒体处理：提取Word中的内嵌图片，保存为临时文件后，调用MediaWiki的upload API上传到Wiki服务器，获取文件的Wiki链接（如[[File:文档名_图片1.png]]）替换原文档中的图片占位。
  3. 页面发布：调用MediaWiki的edit API，提交转换后的WikiText，设置页面标题、编辑摘要，同时处理版本冲突（通过API参数basetimestamp避免覆盖他人编辑）。
• 落地细节：
  • 在Word中创建宏按钮，创作者编辑完文档后点击即可触发发布，完全保留原有创作流程。
  • 配置MediaWiki的Bot专用账号（开启BotPassword权限），宏中嵌入账号信息（可放在单独配置文件避免硬编码）。
  • 适配MacOS：Mac版Word支持VBA，只需微调文件路径处理逻辑即可跨平台使用。

方案2：Pandoc转换 + Python脚本批量/单页发布 #

适合需要批量处理文档，或不想编写VBA的场景：

• 核心逻辑：
  1. 格式转换：用Pandoc将.docx文件直接转为MediaWiki格式：

     pandoc -s input.docx -t mediawiki --extract-media=./images -o output.wiki
     

  2. 图片上传：用Python脚本遍历提取的图片文件夹，调用MediaWiki API上传所有图片，替换output.wiki中的本地图片路径为Wiki文件链接。
  3. 页面提交：脚本调用edit API将处理后的WikiText发布到指定页面。
• 落地细节：
  • 可以把Pandoc调用+脚本打包成Word宏按钮，让用户一键触发。
  • Pandoc对复杂格式（表格、嵌套列表、超链接）的转换成熟，无需额外调整格式映射逻辑。

方案3：HTML导出 + VisualEditor API 精准还原格式 #

追求所见即所得效果的最优解：

• 核心逻辑：
  1. HTML导出：将Word文档保存为过滤后的HTML（去掉Word自带的冗余标签），或用脚本清理HTML内容。
  2. 图片预处理：上传Word中的图片到MediaWiki，替换HTML中的图片src为Wiki文件的访问URL。
  3. 提交到VisualEditor：调用MediaWiki的visualeditor API，提交清理后的HTML，Wiki会自动将HTML转换为WikiText存储。
• 落地细节：
  • 这种方式还原的格式最接近Word原文，适合对排版要求高的文档。
  • 需要确保MediaWiki开启VisualEditor扩展，并配置对应API权限。

关键注意事项 #

• 必须开启MediaWiki的API访问权限，并创建具备编辑页面和上传文件权限的专用Bot账号。
• 处理版本冲突时，API调用需携带starttimestamp参数，避免覆盖他人的并行编辑。
• 提前测试各类复杂格式（跨页表格、嵌入视频、特殊字符）的转换效果，微调转换逻辑。

内容的提问来源于stack exchange，提问作者Amw 5G