本地安装 readthedocs的过程及遇到的问题解决

我使用的系统是Ubuntu 16.03 server版

安装完成后，本地安装readthedocs的步骤：

================================================================

1 参照官方教程，https://docs.readthedocs.io/en/latest/install.html

2 提前安装下面的部分，这部分教程里面没有提到

apt-get install virtualenv  python-virtualenv
生成pdf部分
apt-get install texlive
apt-get install texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended

先运行第二步，再按照教程一步步来就可以

最后一步运行的时候，runserver后面一定跟0.0.0.0而不是某一个ip

这个时候会遇到的问题是：项目没办法编译，卡在triggered的状态

解决：

3 增加文件
rtd/checkouts/readthedocs.org/readthedocs/local_settings.py

import os
# Set this to the root domain where this RTD installation will be running
PRODUCTION_DOMAIN = os.getenv('RTD_PRODUCTION_DOMAIN', 'yourip:8000')
# Enable private Git doc repositories
ALLOW_PRIVATE_REPOS = True


这样编译就可以通过了
========================================================


=======================================================
本地的git，怎么配置使用http


https://my.oschina.net/yushulx/blog/609779


这样之后，路径就是 http://yourip/git
push的时候需要提供用户名和密码

========================================================

还有个问题就是webHook的配置，可以让git库将改动自动发送给readthedocs，不用每次手动trigger 编译，后面再写。。。