30.11.17 15:00, Wes Turner пише:
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 <http://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?

This was discussed when PEPs were converted to the .rst format. At that time this didn't work. I'm sure there is an open issue about adding support of Pygments. If this isn't, open the one.

_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
https://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com

Reply via email to