是否可以在 ReST 文字块中插入超链接？

Question

我知道这种情况会破坏文字块的目的，但我想知道是否有任何解决方法可以实现这一点。我的用例是在伪代码的块文字中放置一个超链接，以便在文档的其他地方引用详细信息。

示例：

Look at this JSON pseudo code
-----------------------------

::

  {
    "id": <number>,
    "name": <string>,
    "big_property": <see schema of big_object_>
  }

And the details of big object
-----------------------------

.. _big_object:

::

  {
     <another_schema>
  }

我希望在第一个文字块中，big_object_ 成为超链接。

Answer 1

您可以为此使用 parsed-literal 指令：

.. parsed-literal::

  {
    "id": <number>,
    "name": <string>,
    "big_property": <see schema of big_object_>
  }

是否可以在 ReST 文字块中插入超链接？

Is it possible to insert hyperlinks in an ReST literal block?

restructuredtext

docutils

python-sphinx