(original) (raw)
I tried using code blocks while writing PEP 551 but they weren’t highlighted on the python.org rendering.
Personally I think it would be great, provided a good colour scheme is available (some default schemes are... not always works of art). I’m not sure who is responsible for that side of things though – presumably it’s just a case of installing pygments. (FWIW, I’m not keen on going back and modifying old PEPs, but I won’t stop someone doing it on their own terms.)
Cheers,
Steve
Top-posted from my Windows phone at North Bay Python
From: Wes Turner
Sent: Thursday, November 30, 2017 5:06
To: Python-Dev
Subject: \[Python-Dev\] PEPs: \`\`.. code:: python\`\` or \`\`::\`\` (syntaxhighlighting)
In ReStructuredText, this gets syntax highlighted
because of the code directive \[1\]\[2\]\[3\]:
.. code:: python
import this
def func(\*args, \*\*kwargs):
pass
This also gets syntax highlighted as python\[3\]:
.. code:: python
import this
def func(\*args, \*\*kwargs):
pass
This does not::
import this
def func(\*args, \*\*kwargs):
pass
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.
GitHub does show Pygments syntax highlighting
in .. code:: blocks for .rst and .restructuredtext documents \[4\]
1\. Does the python.org PEP view support .. code:: blocks? \[5\]
2\. Syntax highlighting is an advantage for writers, editors, and readers.
3\. Should PEPs use .. code:: blocks to provide this advantage?
https://www.python.org/dev/peps/pep-0458/