我使用的系统是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 编译,后面再写。。。