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
相关产品推荐
相关产品推荐

