Officially docutils and most other rst renderers like pandoc support three source code directives: code, code-block, and sourcecode. I'm observing that Github restored support for rendering code and code-block directives but that although it rendered the sourcecode directive for years the sourcecode code blocks are still no longer rendering correctly.
I noticed our docs looked odd as well, but luckily the workaround to replace .. sourcecode:: with .. code:: worked. Thanks for investigation @trevorld.
This is a refinement of #1796
Officially docutils and most other rst renderers like pandoc support three source code directives:
code
,code-block
, andsourcecode
. I'm observing that Github restored support for renderingcode
andcode-block
directives but that although it rendered thesourcecode
directive for years thesourcecode
code blocks are still no longer rendering correctly.I have a minimal github repo as an example: https://github.com/trevorld/github_rst_code_rendering
{knitr}
uses the sourcecode directive when convertingREADME.Rrst
files intoREADME.rst
files so this still affects some of my repos.Here are some links to the
docutils
andpandoc
source code where they explictly support all three of these: