Markdown+Pandoc+Sphinx+ Git

本篇主要用于记录 实践Mankdown+Pandoc+Sphinx+Git 的流程以备后续查阅。

1.准备篇

  1.1：教程文章地址：https://yq.aliyun.com/articles/8524?spm=5276.8091938.0.0.gl12VD#

  1.2：待编译的项目源码地址：https://gitlab.com/yangzhihong20141/gitbook/

2.安装篇

  2.1：安装python2.7.12

  2.2：安装Pandoc （Tips：将安装路径安装到文章目录下，要不然执行的时候回出现 => pandoc不是批处理命令错误）

  2.3：安装easy_install （Url:https://pypi.python.org/pypi/setuptools  32位选择 setuptools-27.3.0.tar.gz (md5)）

    2.3.1:运行easy_install sphinx (下载网速巨慢，要反复安装好几次才成功)

    2.3.2:运行easy_install pip

3.实践篇

  3.1：cmd切换到文章文件所在目录，执行make clean; make html; 即可将文章生成为 html格式

4.资料篇

  4.1：sphinx使用手册：http://zh-sphinx-doc.readthedocs.io/en/latest/tutorial.html

  4.2：makdown 手册：http://wowubuntu.com/markdown/ 

  4.3：已下载软件地址：https://pan.baidu.com/s/1nvLHzPv

效果如下图：