Syntax highlighting is an advantage for writers, editors, and readers.
reStructuredText PEPs are rendered into HTML with docutils. Syntax highlighting in Docutils 0.9+ is powered by Pygments. If Pygments is not installed, or there is a syntax error, syntax highlighting is absent. Docutils renders .. code:: blocks with Python syntax highlighting by default. You can specify .. code:: python or .. code:: python3.
In order to use pygments with pythondotorg-hosted PEPs, a few things need to happen:
PEPs may use .. code:: directives instead of :: so that code is syntax highlighted.
Syntax highlighting is an advantage for writers, editors, and readers.
reStructuredText PEPs are rendered into HTML with docutils. Syntax highlighting in Docutils 0.9+ is powered by Pygments. If Pygments is not installed, or there is a syntax error, syntax highlighting is absent. Docutils renders
.. code::blocks with Python syntax highlighting by default. You can specify.. code:: pythonor.. code:: python3.for
.. code::directives for .rst and .restructuredtext documentsBuild PEPs using Sphinx peps#2
Move the PEPs to Read the Docs core-workflow#5
In order to use pygments with pythondotorg-hosted PEPs, a few things need to happen:
pygmentsinbase-requirements.txtPEPs may use
.. code::directives instead of::so that code is syntax highlighted.