使用项目

本次的安装所有在python3.5 环境下安装,

什么? python2.x 怎么办?

都什么年代, 你想要被2的中文折腾可以自己研究一下

安装cookiecutter

pip install cookiecutter

未防止一些全局版本问题尽量使用 virtualenv

生成样板工程

切换到测试演示目录,并且切换到virtualenv

cd tmp
mkdir test_doc
. /data/vpythons/python3/bin/activate 

cookiecutter命令生成项目模板 命令过程中可能需要输入一些基本的数据信息

(python3) ➜  test_doc cookiecutter https://github.com/yishenggudou/cookiecutter-sphinx-doc.git
You've downloaded /Users/timgerk/.cookiecutters/cookiecutter-sphinx-doc before. Is it okay to delete and re-download it? [yes]: yes
project [example project name]: 
project_slug [epo]: 
book_title [实例项目文档]: 
author [author name]: 
version [0.0.1]: 
release [0.0.1]: 
description [some long description]: 
src [docs]: 

安装环境需要的依赖

pip install -r requirements.txt

测试html部分

cd docs
make html
open _build/html/index.html

测试生成pdf

cd docs
./topdf.sh