ezio-melotti / docsbuild-scripts

scripts for building documentation on docs.python.org

This repository contains scripts for automatically building the Python documentation on docs.python.org.

How to test it?

The following command should build all maintained versions and translations in ./www, beware it can take a few hours:

python3 ./build_docs.py --quick --build-root ./build_root --www-root ./www --log-directory ./logs --group $(id -g) --skip-cache-invalidation

If you don't need to build all translations of all branches, add --language en --branch main.

Check current version

Install tools_requirements.txt then run python check_versions.py ../cpython/ (pointing to a real CPython clone) to see which version of Sphinx we're using where:

Sphinx configuration in various branches:

=========  =============  =============  ==================  ==================
  version  travis         azure          requirements.txt    conf.py
=========  =============  =============  ==================  ==================
     2.7   sphinx~=2.0.1  ø              ø                   needs_sphinx='1.2'
     3.5   sphinx==1.8.2  ø              ø                   needs_sphinx='1.8'
     3.6   sphinx==1.8.2  sphinx==1.8.2  ø                   needs_sphinx='1.2'
     3.7   ø              ø              ø                   ø
     3.8   ø              ø              sphinx==2.4.4       needs_sphinx='1.8'
     3.9   ø              ø              sphinx==2.4.4       needs_sphinx='1.8'
     3.1   ø              ø              sphinx==3.4.3       needs_sphinx='3.2'
     3.11  ø              ø              sphinx==4.5.0       needs_sphinx='4.2'
     3.12  ø              ø              sphinx==4.5.0       needs_sphinx='4.2'
     3.13  ø              ø              sphinx==6.2.1       needs_sphinx='4.2'
=========  =============  =============  ==================  ==================

Sphinx build as seen on docs.python.org:

=========  =====  =====  =====  =====  =====  =====  =====  =====  =======  =====  =====  =======  =======
version    en     es     fr     id     it     ja     ko     pl     pt-br    tr     uk     zh-cn    zh-tw
=========  =====  =====  =====  =====  =====  =====  =====  =====  =======  =====  =====  =======  =======
2.7        ø      2.3.1  ø      2.3.1  2.3.1  ø      2.3.1  2.3.1  ø        2.3.1  2.3.1  ø        2.3.1
3.5        ø      1.8.4  1.8.4  1.8.4  1.8.4  ø      1.8.4  1.8.4  ø        1.8.4  1.8.4  1.8.4    1.8.4
3.6        ø      2.3.1  2.3.1  2.3.1  2.3.1  ø      2.3.1  2.3.1  ø        2.3.1  2.3.1  2.3.1    2.3.1
3.7        2.3.1  2.3.1  2.3.1  2.3.1  2.3.1  2.3.1  2.3.1  2.3.1  2.3.1    2.3.1  2.3.1  2.3.1    2.3.1
3.8        2.4.4  2.4.4  2.4.4  2.4.4  2.4.4  2.4.4  2.4.4  2.4.4  2.4.4    2.4.4  2.4.4  2.4.4    2.4.4
3.9        2.4.4  2.4.4  2.4.4  2.4.4  2.4.4  2.4.4  2.4.4  2.4.4  2.4.4    2.4.4  2.4.4  2.4.4    2.4.4
3.10       3.4.3  3.4.3  3.4.3  3.4.3  3.4.3  3.4.3  3.4.3  3.4.3  3.4.3    3.4.3  3.4.3  3.4.3    3.4.3
3.11       4.5.0  4.5.0  4.5.0  4.5.0  4.5.0  4.5.0  4.5.0  4.5.0  4.5.0    4.5.0  4.5.0  4.5.0    4.5.0
3.12       4.5.0  4.5.0  4.5.0  4.5.0  4.5.0  4.5.0  4.5.0  4.5.0  4.5.0    4.5.0  4.5.0  4.5.0    4.5.0
3.13       6.2.1  6.2.1  6.2.1  6.2.1  6.2.1  6.2.1  6.2.1  6.2.1  6.2.1    6.2.1  6.2.1  6.2.1    6.2.1
=========  =====  =====  =====  =====  =====  =====  =====  =====  =======  =====  =====  =======  =======