我使用docutils来通过rst文件生成文档。
在我的文档中,我需要添加并突出显示一些源代码。我还使用交叉引用来为相应的部分创建一些关键字(部分名称)超链接。因此,只需在单词的末尾添加下划线,例如elm = driver.find_element_by_id("my_id")
driver.execute_script("arguments[0].innerHTML = 'My Text';", elm)
,其中包含:
mysection_
当我使用代码突出显示格式时会出现问题。也就是说,如果我使用mysection
---------
Some text...
然后使用一段C代码,则源代码中的交叉引用不起作用:
.. code:: C
那么,我怎样才能让代码突出显示和交叉引用?
更新
Stackoverflow中也可能发生同样的情况。当您将代码放入代码块示例中时,会禁用某些功能(如引用)!是否有任何解决方案可以在代码示例中启用引用?
例如,在下文中,引用不起作用:
.. code:: C
#include "example.h"
int main()
{
printf("My Section is:");
mysection_();
return 0;
}