在我的文档中,我偶尔会使用“垃圾”网址作为示例,并且不希望它们成为无处可链接的超链接。是否有任何语法可以使这些网址不是超链接?
存在三种格式化此类URL的方法,以使它们不是超链接。首先是将示例URL像对待其他代码示例一样对待,并将其括在反引号中,如下所示:
open ``http://www.example.com`` in a web browser
第二个是使用Sphinx :samp:
角色,如下所示:
:samp:
open :samp:`http://www.example.com` in a web browser
角色可让您强调可变部分。因此,例如,您可以指示用户选择的端口号,如下所示:
:samp:
和单词port会被强调并省略括号。
最后一个选择是在示例URL前面加上反斜杠,如下所示:
open :samp:`http://www.example.com:{port}` in a web browser
URL将显示为普通文本,而不是链接或任何特殊格式。
除了@ddbeck答案之外,要转义电子邮件地址,请在@前面加上斜杠。
open \http://www.example.com in a web browser