链接 Sphinx 替换

Question

我有一个 Sphinx 项目，有一些替代品。我有一个变量

|total_downloads|

（工作正常），我想在其上链接某些部分

statistics

。我尝试了以下两段代码：

:ref:`|total_downloads| <statistics>`

和

:ref:`\ |total_downloads|\  <statistics>`

两者都正确创建了链接，但显示

|total_downloads|

而不是变量的内容。

有什么办法可以解决这个问题吗？ 谢谢您的帮助！

Answer 1

正确的答案在评论中，正如@StevePiercy所说，重组文本不支持其链接内除纯文本之外的任何内容。

我的建议是将其更改为“1234 次下载 (

see full statistics <statistics>

_)”之类的内容，以便信息和支持部分的链接都清晰可见。

Answer 2

虽然 reStructuredText 目前不支持嵌套内联标记，但它允许在简单的超链接引用中使用替换：

.. |today| date::

Both, |today|__ and |today|_ produce a link with the current date as text.

__ example.com
.. _today: example.org  

我不知道这是否也适用于

|total_downloads|

变量。

提示：替换也可以用作一种解决方法来强调或以其他方式设置链接文本（请参阅reStructuredText指令）。