Ich weiß, dass reStructuredText diese Direktive hat:
.. code:: bash
gedit pohl.m
Dadurch wird ein Codeblock gerendert. Gibt es eine Möglichkeit, die Syntax für Inline-Snippets wie diese hervorzuheben:
Do edit the file, type ``gedit pohl.m`` into a terminal.
Die Backticks markieren es als Code, aber ich möchte es mit Pygementen wie dem Block hervorheben. Ist das möglich?
restructuredtext
Martin Ueding
quelle
quelle
Antworten:
Nachdem ich mich etwas genauer damit befasst hatte, stieß ich auf das Dokument reStructuredText Interpreted Text Roles . Aus diesem Dokument:
Es scheint, dass es eine
code
Rolle gibt , also können Sie einfach tippenum einen Inline-Codeblock zu rendern. Um eine Syntaxhervorhebung zu erhalten, können Sie eine benutzerdefinierte Rolle definieren. Beispielsweise
die du dann so verwenden kannst:
Beachten Sie, dass die Rollendefinition vor Verweisen auf die Rolle platziert werden muss.
Beachten Sie, dass in dem Dokument, auf das ich verweise, die Version der Dokumente, auf die es verweist, nicht erwähnt wird. Die Code-Rolle ist in docutils 0.8.1 nicht verfügbar (dies ist die einzige Version, gegen die ich testen muss).
quelle