如果可能，我们如何在 rst 文件的代码部分中放置超链接？

Question

我在 rst 文件中有以下内容：

.. code-block:: bash

   user@adi:~/workspace$ pytest
   test/test/functional/example/test_api_2.py
   --testbed test/test/topo_confs/pytest_tb.json
   --loglevel DEBUG --html /home/user/test.html --self-contained-html

现在如何在该代码中的pytest_tb.json单词上放置超链接？

Answer 1

.. code-block::仅将语法突出显示应用于文字代码，这意味着它不通过解释 reStructuredText 标记来支持超链接。

相反，您可以在 Sphinx 主题的 CSS 文件中使用自定义样式（例如，named）my-code-block，并使用 reST 标记，如下所示。

在你的 CSS 文件中：

p.my-code-block {
    font-family: monospace;
    white-space: pre;
}

在你的rest源文件中：

.. rst-class:: my-code-block

    user@adi:~/workspace$ pytest
    test/test/functional/example/test_api_2.py
    --testbed test/test/topo_confs/`pytest_tb.json <relative/path/to/pytest_tb.json>`_
    --loglevel DEBUG --html /home/user/test.html --self-contained-html

请注意，不会应用 Pygments 中的 bash 语法突出显示。然而，您可以在 HTML 输出上使用 JavaScript 语法荧光笔，但让 HTML 输出符合 JavaScript 的要求以及更新主题可能具有挑战性，而且麻烦得不值得。