Shapely: يبني المستند التلقائي

بالمناسبة ، matplotlib يفعل هذا بالفعل. راجع https://github.com/matplotlib/matplotlib/blob/master/.travis.yml#L126

أعتقد بالتأكيد أن العملية يمكن تحسينها على الرغم من ...

بالإضافة إلى ذلك ، اكتشفت للتو أن ReadTheDocs يمكنه الآن القيام بتثبيتات conda ، مما يجعل RTD خيارًا قابلاً للتطبيق لبناء Shapely doc (لقد قدمت إثباتًا لمفهوم Cartopy مع بعض النجاح).

لقد جربت هذا ولدي شيء يعمل ، بناءً على هذا البرنامج التعليمي: https://gist.github.com/domenic/ec8b0fc8ab45f39403dd

التغييرات هنا: https://github.com/Toblerity/Shapely/compare/master...snorfalorpagus : autodoc

تتطلب العملية إنشاء زوج مفاتيح SSH جديد ووضع نسخة مشفرة من المفتاح الخاص في الريبو / ترافيس.

تم إعداده لإنشاء التوثيق فقط في حالة واحدة (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 خيارًا أفضل.

تريد أيضًا زيادة الوعي بـ https://github.com/drdoctr/doctr إذا كنت تنزل في المستندات على طريق travis.

أنا أنقل هذا إلى المرحلة التالية. أرغب في إلغاء حظر 1.6.0 والعمل على المستند أدناه.