Readthedocs + Gitee 搭建文档

一、文档撰写前提

环境部署:

# git clone https://gitee.com/zhyantao/readthedocs.git
# pip install sphinx recommonmark sphinx-autobuild sphinx_rtd_theme -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host=mirrors.aliyun.com

二、撰写博文并发表

1. 把你要发表的博文放在 demo-readthedocs/source/docs 文件夹中
2. CMD中输入 make html 回车，打开 build/html/index.html 预览效果
3. 提交代码(博文)到 Gitee 仓库 [git简易指南]
4. 在 Read the Docs中导入 Gitee 项目
5. 导入成功后，点击 View the documentation 查看最终效果 [示例]

Warning

除了 demo-readthedocs/source/docs 下的文件和 source/index.rst 可以修改外，其他位置的文件不要修改，否则可能会引起错误。另外，务必在 source/index.rst 文件中添加刚编辑过的博文路径