<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=Generator content="Microsoft Word 15 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:#954F72;
text-decoration:underline;}
.MsoChpDefault
{mso-style-type:export-only;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style></head><body lang=EN-US link=blue vlink="#954F72"><div class=WordSection1><p class=MsoNormal><span lang=EN-AU>I tried using code blocks while writing PEP 551 but they weren’t highlighted on the python.org rendering.<o:p></o:p></span></p><p class=MsoNormal><span lang=EN-AU><o:p> </o:p></span></p><p class=MsoNormal><span lang=EN-AU>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.)<o:p></o:p></span></p><p class=MsoNormal><span lang=EN-AU><o:p> </o:p></span></p><p class=MsoNormal><span lang=EN-AU>Cheers,<o:p></o:p></span></p><p class=MsoNormal><span lang=EN-AU>Steve<o:p></o:p></span></p><p class=MsoNormal><o:p> </o:p></p><p class=MsoNormal>Top-posted from my Windows phone at North Bay Python</p><p class=MsoNormal><o:p> </o:p></p><div style='mso-element:para-border-div;border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in'><p class=MsoNormal style='border:none;padding:0in'><b>From: </b><a href="mailto:wes.turner@gmail.com">Wes Turner</a><br><b>Sent: </b>Thursday, November 30, 2017 5:06<br><b>To: </b><a href="mailto:python-dev@python.org">Python-Dev</a><br><b>Subject: </b>[Python-Dev] PEPs: ``.. code:: python`` or ``::`` (syntaxhighlighting)</p></div><p class=MsoNormal><o:p> </o:p></p><div><div><p class=MsoNormal>In ReStructuredText, this gets syntax highlighted</p></div><div><p class=MsoNormal>because of the code directive [1][2][3]:</p></div><div><p class=MsoNormal><o:p> </o:p></p></div><p class=MsoNormal>.. code:: python</p><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal> import this</p></div><div><p class=MsoNormal> def func(*args, **kwargs):</p></div><div><p class=MsoNormal> pass</p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>This also gets syntax highlighted as python[3]:</p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>.. code:: python</p><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal> import this</p></div><div><p class=MsoNormal> def func(*args, **kwargs):</p></div><div><p class=MsoNormal> pass</p></div></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>This does not::</p></div><div><div><p class=MsoNormal><br> import this</p></div><div><p class=MsoNormal> def func(*args, **kwargs):</p></div><div><p class=MsoNormal> pass</p></div></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Syntax highlighting in Docutils 0.9+ is powered by Pygments.</p></div><div><p class=MsoNormal>If Pygments is not installed, or there is a syntax error,</p></div><div><p class=MsoNormal>syntax highlighting is absent.</p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>GitHub does show Pygments syntax highlighting</p></div><div><p class=MsoNormal>in .. code:: blocks for .rst and .restructuredtext documents [4]</p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>1. Does the <a href="http://python.org">python.org</a> PEP view support .. code:: blocks? [5]</p></div><div><p class=MsoNormal>2. Syntax highlighting is an advantage for writers, editors, and readers.</p></div><div><p class=MsoNormal>3. Should PEPs use .. code:: blocks to provide this advantage?</p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>[1] <a href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#code">http://docutils.sourceforge.net/docs/ref/rst/directives.html#code</a></p></div><div><p class=MsoNormal>[2] <a href="http://www.sphinx-doc.org/en/stable/markup/code.html">http://www.sphinx-doc.org/en/stable/markup/code.html</a></p></div><div><p class=MsoNormal>[3] <a href="http://www.sphinx-doc.org/en/stable/config.html#confval-highlight_language">http://www.sphinx-doc.org/en/stable/config.html#confval-highlight_language</a></p></div><div><p class=MsoNormal>[4] <a href="https://github.com/python/peps/blob/master/pep-0557.rst">https://github.com/python/peps/blob/master/pep-0557.rst</a></p></div><div><p class=MsoNormal>[5] <a href="https://www.python.org/dev/peps/pep-0557/">https://www.python.org/dev/peps/pep-0557/</a></p></div><div><p class=MsoNormal><o:p> </o:p></p></div></div><p class=MsoNormal><a href="https://www.python.org/dev/peps/pep-0458/">https://www.python.org/dev/peps/pep-0458/</a></p><p class=MsoNormal><o:p> </o:p></p></div></body></html>