Question

我在第一个文件中有以下内容：

.. 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文件中使用自定义样式，例如名为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的要求以及更新主题可能会带来挑战，而且比它的价值更麻烦。

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

1 个答案: