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 и поместили зашифрованную версию закрытого ключа в репозиторий / 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 , прежде чем вы потратите на это больше времени, позвольте мне посмотреть, помогают ли наши многочисленные колеса Linux1 сделать readthedocs лучшим вариантом.

Также хочу повысить осведомленность о https://github.com/drdoctr/doctr , если вы просматриваете документы на маршруте travis.

Я перемещаю это на следующую веху. Я хотел бы разблокировать 1.6.0 и работать над документом ниже.