Wie können wir, wenn möglich, einen Hyperlink innerhalb des Codeabschnitts in den ersten Dateien einfügen?

Question

Ich habe folgend in einer ersten Datei:

.. 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 

Nun, wie kann ich einen Hyperlink auf dem in diesem Code pytest_tb.json Wort setzen?

Answer 1

.. code-block:: wendet nur die Syntaxhervorhebung auf Literalcode an, was bedeutet, dass es keine Hyperlinks unterstützt, indem reStructuredText-Markup interpretiert wird.

Stattdessen könnten Sie einen benutzerdefinierten Stil in der CSS-Datei Ihres Sphinx Theme verwenden, sagen wir my-code-block, und verwenden Sie reST Markup, etwas wie folgt.

In Ihrer CSS-Datei:

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

Und in Ihrer reST Quelldatei:

.. 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 

Beachten Sie, dass nicht bash Syntax von Pygments markieren gelten. Allerdings könnten Sie sich etwas einfallen lassen und einen JavaScript-Syntax-Highlighter für die HTML-Ausgabe verwenden, aber die HTML-Ausgabe den JavaScript-Anforderungen anzupassen und das Thema zu aktualisieren, kann schwierig und mühsam sein.