Sphinx-reST-RTD 中的预格式化(逐字)超链接

Question

我正在使用Sphinx-RTD构建文档。

我想在某处有一个链接，并被设置为逐字或预先格式化的文本。

例如，假设我逐字逐句

：ALTER TABLE

有没有办法在某个地方链接它，比如 ：ref：...，甚至只是一个标准的超链接？

Answer 1

如果我没记错的话，"替换文本"指令可以提供帮助。

由于 reStructuredText 不支持嵌套的内联标记，因此使用样式文本创建引用的唯一方法是使用带有"replace"指令的替换：

I recommend you try |Python|_.
.. |Python| replace:: Python, *the* best language around
.. _Python: http://www.python.org/

所以也许是这样的：

Click |altertable|_ to read details about |altertable|.
----
Blah blah blah
----
.. _altertable:
Here are the details about |altertable|: blah blah blah.
.. |altertable| replace:: ``ALTER TABLE``