pythonnet.wiki 可以用 sphinx-quickstart,一步一步选择,语言选 zh,最后生成 conf.py,index.md,makefile 三个文件和其他的资源文件。。

如果没选 autodoc,改 conf.py,改成

extensions = ['sphinx.ext.autodoc']

可惜搞出来的东西 markdown 语法没翻译

支持 Markdown 语法

pip install --upgrade recommonmark
# for Sphinx-1.4 or newer
extensions = ['recommonmark']

# for Sphinx-1.3
from recommonmark.parser import CommonMarkParser

source_parsers = {
    '.md': CommonMarkParser,
}

source_suffix = ['.rst', '.md']

有一个文件一直编不过,通过删除文件后面内容再编译,一点点扩大范围,最终找到问题了。。是链接相对引用位置不存在的问题 ../issues/525 。。。改成绝对路径好了。

修改 index.md 文件为 index.rst
加入 README.rst

ls >1.txt 内容加到 index.rst 的 toctree 栏目下