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

Question

相关：How do I prevent sphinx from making a url a hyperlink?

在上面的问题中，我们学习了如何在重组文本中转义单个 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 编写器不在输出端发出 标记，但我的猜测是，即使有可能，它也很可能会涉及很多。