1

我使用 docutils 来通过 rst 文件生成文档。

在我的文档中，我需要添加并突出显示一些源代码。我还使用交叉引用将一些关键字（部分名称）超链接到相应的部分。因此，只需在单词末尾添加下划线即可，例如mysection_：

mysection
---------

Some text...

当我使用代码突出显示的格式时会出现问题。也就是说，如果我使用.. code:: C然后一段 C 代码，源代码中的交叉引用不起作用：

.. code:: C

    #include "example.h"
    int main()
    {
        printf("My Section is:");
        mysection_();
        return 0;    
    }

那么，我怎样才能同时拥有代码高亮和交叉引用呢？

更新：

同样的情况也可能发生在 Stackoverflow 中。当您将代码放入代码块中时，某些功能（例如引用）将被禁用！是否有任何解决方案可以在代码示例中启用引用？

例如在下面，引用不起作用：

# This hello world example was copied from [C-HowTo website][1]
# As you noticed, links do not work here, but you see below code block,
# the same link works.
# Also link to [Stackoverflow](http://stackoverflow.com) does not work!

#include<stdio.h>

int main() {
    printf("Hello World\n");
    return 0;
}

C-HowTo 网站

堆栈溢出

4

0 回答 0