You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Sphinx中带超链接的parsed-literal指令内容翻译问题咨询

Sphinx parsed-literal中超链接翻译后失效并触发「引用不一致」警告

我在使用gettext生成器生成.po文件构建CMake文档时遇到如下问题:当Sphinx的parsed-literal指令内容包含超链接时,按常规流程完成翻译后执行sphinx-build构建HTML文档,会出现超链接失效的情况,同时收到「引用不一致」的警告。

重现步骤

  • 准备包含parsed-literal指令且内部带有超链接的Sphinx源文件,示例代码:
    .. parsed-literal::
       请参考官方文档::ref:`cmake-buildsystem(7)`
    
  • 执行sphinx-build -b gettext命令生成.po翻译文件
  • 在.po文件中对对应条目进行翻译
  • 运行sphinx-build -b html命令构建HTML文档
  • 检查构建日志与生成的HTML页面,确认超链接状态及警告信息

环境信息

  • Sphinx版本:[填写具体版本号]
  • gettext版本:[填写具体版本号]
  • CMake文档版本:[填写具体版本]
  • 操作系统:[填写具体系统,如Windows 10/Ubuntu 22.04]

完整构建日志

[粘贴完整的sphinx-build输出日志,包含「引用不一致」警告内容]

超链接失效截图

超链接失效后的页面截图

希望能找到解决该问题的方案。

内容的提问来源于stack exchange,提问作者Haowei Hsu

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.27 00:32:42