readthedocs上的nbsphinx语法突出显示

Posted 2023-01-10

我有一个readthedocs sphinx文档，该文档使用nbsphinx显示jupyter笔记本。当我使用autobuild在本地构建文档时，在jupyter笔记本的代码单元中有语法突出显示的内容。但是在readthedocs上，代码单元没有任何语法高亮显示。

是否需要激活某些内容才能在这些单元格中突出显示语法？

答案

我遇到了同样的问题，并通过阅读问题注释中张贴的link to the documentation中的内容来设法解决了该问题。

最简单的解决方法是在RTD用于构建文档的pip要求文件中包含“ IPython”（通常在项目根目录中为“ requirements.txt”）。