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 栏目下