python-sphinx - 是否有 Spinx 选项可以防止全局解析 URL？

Question

相关：如何防止 sphinx 将 url 设为超链接？

在上面的问题中，我们学习了如何在 reStructured Text 中转义单个 URL，以防止 Sphinx 在转换为 HTML 时将它们变成超链接。但是，我有很多 URL，我想保持我的 .rst 文件尽可能干净。它是一个 API 文档，因此添加反斜杠或引号会降低其可读性。是否有一个配置选项可以阻止 Sphinx 完全解析 URL？

Answer 1

不幸的是，我认为没有简单的方法。隐式检测 URI 发生在 reST 解析层：

https://github.com/qsnake/docutils/blob/68af50cccd2c8bb88264bffad44faa8e47e5d7dc/docutils/parsers/rst/states.py#L627

Sphinx 是 docutils 的 reST 实现之上的一组预定义域和相关工具，因此这比它提供的配置选项要低级。

可能有一些方法可以让 HTML 编写器不发出 <a> 标记输出端的东西，但我的猜测是，即使它是可能的，它很可能是相当复杂的。