如何防止sphinx将url作为超链接？

Question

在我的文档中,我偶尔会使用"垃圾"网址作为示例,并且不希望它们成为无处的超链接.是否有任何语法使这些网址不是超链接？

Answer 1

有三种方法可以格式化这些URL,使它们不是超链接.第一种是像其他代码样本一样处理样本URL,并将它们放在反引号中,如下所示:

open ``http://www.example.com`` in a web browser

第二个是使用Sphinx :samp:角色,如下所示:

open :samp:`http://www.example.com` in a web browser

该:samp:角色允许您强调可变部分.因此,例如,您可以指示用户选择的端口号,如下所示:

open :samp:`http://www.example.com:{port}` in a web browser

并且单词port将显示为强调并且括号被省略.

最后一个选项是使用反斜杠前缀示例URL,如下所示:

open \http://www.example.com in a web browser

该URL将显示为普通文本,而不是链接或具有任何特殊格式.