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



>我在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单词上放置超链接?

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

相反,您可以在狮身人面像主题的 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 的要求以及更新主题可能具有挑战性,而且比它的价值更麻烦。

最新更新