Sphinx文档Python代码块仅部分高亮,如何实现全量高亮?
Sphinx实现VS Code风格全量代码高亮
步骤1:安装VS Code风格的Pygments样式
- 执行命令安装对应样式包:
pip install pygments-style-vscode
步骤2:修改Sphinx配置文件(conf.py)
- 替换原有的高亮样式配置:
# 替换之前的 pygments_style = 'default' pygments_style = 'vscode' - 可选优化:若当前使用的Sphinx主题对语法高亮支持有限,建议更换为现代主题(如Furo),这类主题能更好适配完整语法高亮:
- 安装主题:
pip install furo - 在conf.py中设置主题:
html_theme = 'furo'
- 安装主题:
验证效果
修改配置后重新构建文档(sphinx-build -b html docs build),Python代码块即可呈现类似VS Code的全量语法高亮效果,关键字、函数名、字符串、模块名等元素都会被精准区分高亮。
内容的提问来源于stack exchange,提问作者Sirion
相关产品推荐
相关产品推荐

