pip install sphinx sphinx-autobuild

#創建目錄cd /path/to/projectmkdir docs#sphinx工作目錄基本配置cd docs#可以回車按默認配置來寫sphinx-quickstart#quickstart 后生成的目錄結構readthedocs│ make.bat│ Makefile├─build└─source　　│ conf.py　　│ index.rst　　├─_static　　└─_templates# 默認會有一個index.rst,make html用來生成html頁面make html

hello,world======================================

Contents:.. toctree:: :maxdepth: 2 hello

pip install recommonmark

from recommonmark.parser import CommonMarkParsersource_parsers = { '.md': CommonMarkParser,}source_suffix = ['.rst', '.md']

pip install sphinx_rtd_theme

import sphinx_rtd_themehtml_theme = "sphinx_rtd_theme"html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]