Automatisez notre workflow de création et de publication de documents à l'aide du système de déploiement de Travis.
Voir aussi #336.
Incidemment, matplotlib le fait déjà. Voir https://github.com/matplotlib/matplotlib/blob/master/.travis.yml#L126
Je pense vraiment que le processus pourrait être amélioré...
De plus, je viens de découvrir que ReadTheDocs peut désormais effectuer des installations conda, faisant de RTD une option viable pour la construction de documents Shapely (j'ai fait une preuve de concept pour Cartopy avec un certain succès).
J'ai essayé et j'ai quelque chose qui fonctionne, basé sur ce tutoriel: https://gist.github.com/domenic/ec8b0fc8ab45f39403dd
Les changements sont ici : https://github.com/Toblerity/Shapely/compare/master...snorfalorpagus :autodoc
Le processus vous oblige à créer une nouvelle paire de clés SSH et à mettre une version chiffrée de la clé privée dans le repo / Travis.
Il est configuré pour ne construire la documentation que dans une seule instance (le Python 3.5 avec des accélérations). https://travis-ci.org/snorfalorpagus/Shapely/jobs/177188968
Cela a mis en évidence que bon nombre des scripts qui créent des figures dans la documentation ne sont pas compatibles avec Python 3.x, par exemple buffer.py qui donne :
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 avant de passer plus de temps là-dessus, permettez-moi de voir si nos roues manylinux1 aident à faire de readthedocs une meilleure option.
Je souhaite également faire connaître https://github.com/drdoctr/doctr si vous suivez la documentation sur la route travis.
Je déplace celui-ci à la prochaine étape. J'aimerais débloquer la 1.6.0 et travailler sur la doc infra après.
Commentaire le plus utile
Je souhaite également faire connaître https://github.com/drdoctr/doctr si vous suivez la documentation sur la route travis.