python - 如何让 Sphinx 理解 Sage doctests？

Question

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

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

Answer 1

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