redoc markdonw支持

1. 设置 pip的镜像源

pip 国内镜像源:

清华：https://pypi.tuna.tsinghua.edu.cn/simple

阿里云：http://mirrors.aliyun.com/pypi/simple/

中国科技大学 https://pypi.mirrors.ustc.edu.cn/simple/

华中理工大学：http://pypi.hustunique.com/

山东理工大学：http://pypi.sdutlinux.org/

豆瓣：http://pypi.douban.com/simple/

使用方式一

直接在命令上输入: pip install -i 镜像链接 模块名

使用方式二

windows: 在 user 目录下创建一个 pip 文件夹，在里面新建文件 pip.ini.例如：C:\Users\Administrator\pip\pip.ini
Linux下，修改 ~/.pip/pip.conf

内容如:

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host=pypi.tuna.tsinghua.edu.cn

2. read the docs支持markdown

 pip install recommonmark
 pip install sphinx_markdown_tables
 pip install sphinx-autobuild

在 source/conf.py中 编辑 extensions

 extensions = [
     'recommonmark',
     'sphinx_markdown_tables'
 ]

---

Sphinx 主题宽度

https://github.com/readthedocs/sphinx_rtd_theme/issues/295#issuecomment-511887805

在 source/_templates的layout.html(如果没有就添加这个文件)中的内容为:

{% extends "!layout.html" %}
  {% block footer %} {{ super() }}

  <style>
         .wy-nav-content { max-width: none; }
  </style>

{% endblock %}

References

• python国内镜像
• python国内镜像源
• Sphinx + Read the Docs 从懵逼到入门