Shapely: 자동 문서 빌드

덧붙여서, matplotlib는 이미 이것을 하고 있습니다. https://github.com/matplotlib/matplotlib/blob/master/.travis.yml#L126 참조

확실히 프로세스가 개선될 수 있다고 생각하지만...

또한 ReadTheDocs가 이제 콘다 설치를 수행할 수 있어 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 에 더 많은 시간을 할애하기 전에 많은 linux1 휠이 readthedocs를 더 나은 옵션으로 만드는 데 도움이 되는지 살펴보겠습니다.

또한 travis 경로에서 문서로 이동하는 경우 https://github.com/drdoctr/doctr 에 대한 인식을 높이고 싶습니다.

나는 이것을 다음 이정표로 옮기고 있다. 1.6.0 차단을 해제하고 문서 인프라에서 작업하고 싶습니다.