Wiem, że reStructuredText ma tę dyrektywę:
.. code:: bash
gedit pohl.m
który renderuje blok kodu. Czy jest jakiś sposób, aby uzyskać podświetlanie składni dla wstawionych fragmentów, takich jak ten:
Do edit the file, type ``gedit pohl.m`` into a terminal.
Backticks oznaczają to jako kod, ale chciałbym to podkreślić pygementami, takimi jak blok. czy to możliwe?
restructuredtext
Martin Ueding
źródło
źródło
Odpowiedzi:
Przyjrzawszy się temu więcej, natknąłem się na dokument reStructuredText Interpreted Text Roles . Z tego dokumentu:
Wygląda na to, że jest
code
rola , więc możesz po prostu wpisaćrenderować wbudowany blok kodu. Aby uzyskać podświetlanie składni, możesz zdefiniować rolę niestandardową. Na przykład
którego możesz następnie użyć w ten sposób:
Zwróć uwagę, że definicja roli musi zostać umieszczona przed odniesieniami do roli.
Należy zauważyć, że dokument, do którego odsyłam, nie wspomina o wersji docutils, do której się odnosi. Rola kodu nie jest dostępna w docutils 0.8.1 (jest to jedyna wersja, dla której muszę testować).
źródło