Sphinx的extlinks扩展是否可以配置为显示url

Question

我真的很喜欢这样一个事实，即我可以使用Sphinx-extlinks扩展来缩短文本中的URL。我也希望能够在呈现的文档中显示完整的URL，而不必在文本中硬编码，也不必冒显示内容和链接指向内容不匹配的风险。如何在使用extlinks扩展列出外部链接的同时做到这一点？ie：我知道我可以在extlinks之外完成，但在conf.py文件中有这个块有助于管理外部内容。

内部conf.py：

extlinks = {
'mySite': ('https://example.com/%s', ''),
}

内页.rst:

You can click :mySite:`here <>` to go to my site, <<< This bit is fine, shows a clickable "here"
which has this address: ???                       <<< How do I do this bit?
<<< I'd like to see: https://example.com/ 

Answer 1

使用

extlinks = {
'mySite': ('https://example.com/%s', None),
}

符合

和

You can click :mySite:` `

第.rst页

应该做的技巧，你会显示

You can click https://example.com/

带有到https://example.com/的链接

而

You can click :mySite:`here <>`

将显示

You can click here

"此处"链接到https://example.com/