Shapely: 自动文档构建

顺便说一句，matplotlib 已经这样做了。 见https://github.com/matplotlib/matplotlib/blob/master/.travis.yml#L126

我绝对认为这个过程可以改进......

此外，我刚刚发现 ReadTheDocs 现在可以进行 conda 安装，使 RTD 成为 Shapely 文档构建的可行选择（我为 Cartopy 做了一个概念验证并取得了一些成功）。

根据本教程，我已经尝试过并且有一些工作： https ://gist.github.com/domenic/ec8b0fc8ab45f39403dd

更改在这里： https://github.com/Toblerity/Shapely/compare/master...snorfalorpagus :autodoc

该过程要求您创建一个新的 SSH 密钥对并将私钥的加密版本放入 repo / Travis。

它设置为仅在一个实例中构建文档（具有加速功能的 Python 3.5）。 https://travis-ci.org/snorfalorpagus/Shapely/jobs/177188968

这突出表明，在文档中创建图形的许多脚本与 Python 3.x 不兼容，例如 buffer.py 给出：

Traceback (most recent call last):
  File "buffer.py", line 29, in <module>
    ax.set_xticks(range(*xrange) + [xrange[-1]])
TypeError: unsupported operand type(s) for +: 'range' and 'list'

@snorfalorpagus在您花更多时间在此之前，让我看看我们的 manylinux1 轮子是否有助于使 readthedocs 成为更好的选择。

如果您确实了解 travis 路线上的文档，还想提高对https://github.com/drdoctr/doctr的认识。

我正在将此移至下一个里程碑。 我想解除对 1.6.0 的阻止并在之后处理 doc infra。