我非常喜欢我可以使用Sphinx extlinks extension缩短文本中URL的事实。我也希望能够在此四处显示渲染的文档中的完整URL,而不必在文本中进行硬编码,并且冒着显示内容与链接指向之间不匹配的风险。在仍然使用extlinks扩展名列出我的外部链接时,我该怎么做?即:我知道我可以在外部链接之外执行此操作,但是在conf.py文件中包含该块有助于管理外部内容。
内部conf.py:
extlinks = {
'mySite': ('https://example.com/%s', ''),
}
Inside page.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/
使用
extlinks = {
'mySite': ('https://example.com/%s', None),
}
in conf.py
和
You can click :mySite:`\ `
in page.rst
应该完成技巧,您将显示
You can click https://example.com/
带有https://example.com/
的链接