Support for pycon (python interactive snippets)

[mattharrison]

Lots of Python tooling uses doctests and interactive snippets to show code.

i.e:

>>> def add(x, y):
...    return x + y
>>> add(2, 3)
5

The benefit of this is multiple:

• you can test the docs
• you can see both the input and output
• it is a standard that jupyter supports as well

Consider this my vote to add syntax highlighting for pycon like pygments does.

BTW, thanks for Pandoc. 🙏 It is a lifesaver. I've migrated most of my custom rst tooling to it. (Still can't use rst to create LibreOffice slides because none of the existing tooling has the features I need. But I digress). Thanks again!

[jgm]

Using python instead of pycon as the syntax name seems to work well...have you tried that?

[mattharrison]

I haven't because my LaTeX pipeline uses pygments to highlight the code and it does a poor job when you specify python instead of pycon

[jgm]

For now you could use a Lua filter to substitute the pycon class with python in CodeBlock elements, when processing with pandoc.

[jgm]

I looked at python.xml and I don't see any explicit support there for this interactive syntax. So it would be good, probably, to add a new pycon.xml. This can "call out" to the highlighter defined in python.xml, so it might be quite simple to design. There are pointers to the documentation in the README.md for this project.