我有一个主要是 Python 的包,主要是为了与 Python 一起使用。但是当模块在 Sage 下使用时,还有一些额外的功能可用。问题是 Sage doctests 必须以 sage: 而不是 >>> 为前缀,Sphinx 在生成文档时不会选择这些。

有没有办法让 Sphinx 在生成 HTML(或其他)文档时识别 sage: 前缀等同于 >>>

最佳答案

好吧,您可以使用 Sage 的内置 Sphinx 版本及其文档构建器。在 http://trac.sagemath.org/ticket/13679 上为 Sage 进行的工作允许为不在 Sage 源代码树中的单个 Python 文件构建文档,因此您可以尝试这样做。

关于python - 如何让 Sphinx 理解 Sage doctests?,我们在Stack Overflow上找到一个类似的问题:https://stackoverflow.com/questions/23274155/

10-12 18:50