Trying to help improve documentation, issue with building it locally

Developers Chat
#1

I’m following the documentation here (GitHub - OpenDroneMap/docs: 🎉 Contribute to OpenDroneMap's documentation! Read how below! 🎉) on my Mac, and trying to get the local documentation env working. It is failing in the pip install stage (please see details below). The instructions for the documentation state python3 is needed, but the library “transifex-client==0.14.3” seems to be requiring python2.7, and not python3. Any ideas?

(venv) [email protected] odm_docs % pip install -r requirements.txt
Collecting sphinx==4.2.0
  Using cached Sphinx-4.2.0-py3-none-any.whl (3.1 MB)
Collecting sphinx-autobuild==2021.3.14
  Using cached sphinx_autobuild-2021.3.14-py3-none-any.whl (9.9 kB)
Collecting sphinx-intl==2.0.1
  Using cached sphinx-intl-2.0.1.tar.gz (17 kB)
  Preparing metadata (setup.py) ... done
Collecting sphinx-rtd-theme==1.0.0
  Using cached sphinx_rtd_theme-1.0.0-py2.py3-none-any.whl (2.8 MB)
ERROR: Ignored the following versions that require a different python version: 0.13.0 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<3.6; 0.13.1 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<3.7; 0.13.10 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.9; 0.13.11 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.9; 0.13.12 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.9; 0.13.2 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<3.7; 0.13.3 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<3.7; 0.13.4 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<3.8; 0.13.5 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<3.8; 0.13.6 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.8; 0.13.7 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.9; 0.13.8 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.9; 0.13.9 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.9; 0.14.0 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.10; 0.14.1 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.10; 0.14.2 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.10; 0.14.3 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.10; 0.14.4 Requires-Python >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,<3.10
ERROR: Could not find a version that satisfies the requirement transifex-client==0.14.3 (from versions: 0.1, 0.2, 0.2.1, 0.3, 0.4, 0.4.1, 0.5, 0.5.1, 0.5.2, 0.6, 0.6.1, 0.7, 0.7.2, 0.7.3, 0.8, 0.9, 0.9.1, 0.10, 0.11b0, 0.11b3, 0.11, 0.11.1b0, 0.12b0, 0.12.1, 0.12.2, 0.12.3, 0.12.4, 0.12.5)
ERROR: No matching distribution found for transifex-client==0.14.3

(venv) [email protected] odm_docs % which python
/Users/tislam/dev/odm/odm_docs/venv/bin/python

(venv) [email protected] odm_docs % python --version
Python 3.10.6

(venv) tisla[email protected] odm_docs % pip --version
pip 22.3.1 from /Users/tislam/dev/odm/odm_docs/venv/lib/python3.10/site-packages/pip (python 3.10)
1 Like
#2

You can safely not install the transifex-client package (you can edit the requirements.txt file) or you can install the latest version of the package which should be for Python 3.

1 Like
#3

Welcome!

Thanks for helping me out with the docs!

If you’d like to coordinate or chat about any of it, please feel free to contact me directly here :slight_smile:

1 Like