我了解Sphinx可选地支持markdown或.md文件,这对我的补充文档非常有用。我想做的是在markdown文件中使用autoclass
或automodule
标签。
通常,如果是,在.rst
文件中
.. autoclass:: my.module.SomeClass
:members:
它会自动提取所有文档字符串并创建文档。可以在.md
文件中使用它吗?目前,当我尝试这样做时,生成的文档仅包含预期的.. autoclass:...
。
我的conf.py
是
extensions = ["sphinx.ext.autodoc", "sphinx.ext.napoleon", "recommonmark"]
source_suffix = {
'.rst': 'restructuredtext',
'.txt': 'markdown',
'.md': 'markdown',
}
由于阅读了docs兼容性,我确实考虑了mkdocs,但它不提供类似autodoc的功能。为了达到这个目的,我对任何其他库都非常开放(不必与RTD兼容)。