Shapely: Pembuatan dokumen otomatis

Kebetulan, matplotlib sudah melakukan ini. Lihat https://github.com/matplotlib/matplotlib/blob/master/.travis.yml#L126

Saya pasti berpikir prosesnya dapat ditingkatkan ...

Selain itu, saya baru tahu bahwa ReadTheDocs sekarang dapat melakukan instalasi conda, menjadikan RTD pilihan yang layak untuk pembuatan dokumen Shapely (saya melakukan bukti konsep untuk Cartopy dengan beberapa keberhasilan).

Saya sudah mencoba ini dan memiliki sesuatu yang berfungsi, berdasarkan tutorial ini: https://Gist.github.com/domenic/ec8b0fc8ab45f39403dd

Perubahannya ada di sini: https://github.com/Toblerity/Shapely/compare/master...snorfalorpagus :autodoc

Prosesnya mengharuskan Anda untuk membuat pasangan kunci SSH baru dan memasukkan versi terenkripsi dari kunci pribadi ke dalam repo / Travis.

Ini diatur untuk hanya membangun dokumentasi dalam satu contoh (Python 3.5 dengan percepatan). https://travis-ci.org/snorfalorpagus/Shapely/jobs/177188968

Ini telah menyoroti bahwa beberapa skrip yang membuat gambar dalam dokumentasi tidak kompatibel dengan Python 3.x, misalnya buffer.py yang memberikan:

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 sebelum Anda menghabiskan lebih banyak waktu untuk ini, izinkan saya melihat apakah roda manylinux1 kami membantu menjadikan readthedocs pilihan yang lebih baik.

Juga ingin meningkatkan kesadaran https://github.com/drdoctr/doctr jika Anda menelusuri dokumen di rute travis.

Aku pindah satu ini ke tonggak berikutnya. Saya ingin membuka blokir 1.6.0 dan mengerjakan dokumen infra setelahnya.