【发布时间】:2026-01-30 23:55:02
【问题描述】:
我将 Sphinx 用于代码文档并在代码中使用多种语言,我想为所有代码设置突出显示。 Sphinx 简要提到了它支持的一些语言 (on this page),然后提到它使用 Pygments 进行词法分析和突出显示。筛选 Sphinx 和 Pygments 的文档后,我不知道如何执行高亮 Objective-c 代码之类的操作。
Pygments 确实提到了它支持的语言列表here,但这并没有告诉我必须在 Sphinx(.rst 文件)中使用的确切语法来告诉代码块突出显示特定语言。例如,要突出显示 c++ 代码,您只需在代码块之前使用它:
.. highlight:: c++
但是在尝试了这些之后,我似乎无法突出显示 Objective-C 代码:
.. highlight:: Objective-C
.. highlight:: objective-c
.. highlight:: Obj-C
.. highlight:: obj-c
任何人都可以向我提供语言列表(您会在文档中引用它们)吗?
【问题讨论】:
标签: documentation-generation python-sphinx pygments