development/Sphinx: Document how to get Python 3 support.

This commit is contained in:
Benjamin Trigona-Harany 2019-07-26 07:49:27 -07:00 committed by Willy Sudiarto Raharjo
parent f10ec68cac
commit fd2ba954c5
No known key found for this signature in database
GPG key ID: 887B8374D7333381

View file

@ -3,5 +3,14 @@ various output formats, including HTML, ePub, LaTeX and plain text. Sphinx was
originally created for the Python documentation, but it has excellent originally created for the Python documentation, but it has excellent
facilities for the documentation of software projects in a range of languages. facilities for the documentation of software projects in a range of languages.
All Sphinx dependencies must be built with Python 3 support, which usually just All Sphinx dependencies must be built with Python 3 support and since there are
means making sure that python3 is installed before building them. many different way of providing this, the following packages require special
build instructions not captured in REQUIRES:
- python/python-urllib3: install python/python3 first
- python-idna: install python/python3 first
- python/python-chardet: install python/python3 first
- python/imagesize: install python/python3 first
- python/alabaster: install python/python3 first
- python/python-requests: install python/python3-certifi first
- python/pytz: install python/python3 first and use PYTHON3=yes as a build
option