Read the Docs build information Build id: 4283786 Project: continuumio-conda Version: latest Commit: c56ba2c50f8c7548e0f0e62907f700837fa23f7d Date: 2026-08-04T20:50:58.054555Z State: cancelled Success: False [rtd-command-info] start-time: 2026-08-04T20:51:01.327642Z, end-time: 2026-08-04T20:51:04.773374Z, duration: 3, exit-code: 0 git clone --depth 1 https://github.com/conda/conda.git . Cloning into '.'... [rtd-command-info] start-time: 2026-08-04T20:51:04.850440Z, end-time: 2026-08-04T20:51:05.952716Z, duration: 1, exit-code: 0 git fetch origin --force --prune --prune-tags --depth 50 refs/heads/main:refs/remotes/origin/main From https://github.com/conda/conda * [new tag] 26.7.0 -> 26.7.0 [rtd-command-info] start-time: 2026-08-04T20:51:06.922683Z, end-time: 2026-08-04T20:51:07.439352Z, duration: 0, exit-code: 0 git checkout --force origin/main Note: switching to 'origin/main'. You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by switching back to a branch. If you want to create a new branch to retain commits you create, you may do so (now or later) by using -c with the switch command. Example: git switch -c Or undo this operation with: git switch - Turn off this advice by setting config variable advice.detachedHead to false HEAD is now at c56ba2c docs: update channels concept page (#16484) [rtd-command-info] start-time: 2026-08-04T20:51:07.512056Z, end-time: 2026-08-04T20:51:07.556608Z, duration: 0, exit-code: 0 cat .readthedocs.yml version: 2 sphinx: configuration: docs/source/conf.py # Set the version of Python and other tools you might need build: os: ubuntu-22.04 tools: python: miniconda-latest jobs: post_checkout: # Unshallow the git clone to make sure we can identify the version - git fetch --unshallow pre_install: - git update-index --assume-unchanged docs/environment.yml docs/source/conf.py pre_build: # Install conda so we can run conda commands (e.g., see configuration.rst) - python -m pip install --no-deps --no-cache-dir --editable . conda: environment: docs/environment.yml # Build PDF, ePub and zipped HTML formats: - epub - pdf - htmlzip [rtd-command-info] start-time: 2026-08-04T20:51:07.657074Z, end-time: 2026-08-04T20:51:12.808639Z, duration: 5, exit-code: 0 git fetch --unshallow From https://github.com/conda/conda * [new tag] 1.1.0 -> 1.1.0 * [new tag] 1.2.0 -> 1.2.0 * [new tag] 1.2.1 -> 1.2.1 * [new tag] 1.3.0 -> 1.3.0 * [new tag] 1.3.1 -> 1.3.1 * [new tag] 1.3.2 -> 1.3.2 * [new tag] 1.3.3 -> 1.3.3 * [new tag] 1.3.4 -> 1.3.4 * [new tag] 1.3.5 -> 1.3.5 * [new tag] 1.4.0 -> 1.4.0 * [new tag] 1.4.1 -> 1.4.1 * [new tag] 1.4.2 -> 1.4.2 * [new tag] 1.4.3 -> 1.4.3 * [new tag] 1.4.4 -> 1.4.4 * [new tag] 1.4.5 -> 1.4.5 * [new tag] 1.4.6 -> 1.4.6 * [new tag] 1.5.0 -> 1.5.0 * [new tag] 1.5.1 -> 1.5.1 * [new tag] 1.5.2 -> 1.5.2 * [new tag] 1.6.0 -> 1.6.0 * [new tag] 1.6.0rc1 -> 1.6.0rc1 * [new tag] 1.6.0rc2 -> 1.6.0rc2 * [new tag] 1.7.0 -> 1.7.0 * [new tag] 1.7.0a1 -> 1.7.0a1 * [new tag] 1.7.0a2 -> 1.7.0a2 * [new tag] 1.7.1 -> 1.7.1 * [new tag] 1.7.2 -> 1.7.2 * [new tag] 1.8.0 -> 1.8.0 * [new tag] 1.8.1 -> 1.8.1 * [new tag] 1.8.2 -> 1.8.2 * [new tag] 1.9.0 -> 1.9.0 * [new tag] 1.9.1 -> 1.9.1 * [new tag] 2.0.0 -> 2.0.0 * [new tag] 2.0.1 -> 2.0.1 * [new tag] 2.0.2 -> 2.0.2 * [new tag] 2.0.3 -> 2.0.3 * [new tag] 2.0.4 -> 2.0.4 * [new tag] 2.1.0 -> 2.1.0 * [new tag] 2.2.0 -> 2.2.0 * [new tag] 2.2.1 -> 2.2.1 * [new tag] 2.2.2 -> 2.2.2 * [new tag] 2.2.3 -> 2.2.3 * [new tag] 2.2.4 -> 2.2.4 * [new tag] 2.2.5 -> 2.2.5 * [new tag] 2.2.6 -> 2.2.6 * [new tag] 2.2.7 -> 2.2.7 * [new tag] 2.2.8 -> 2.2.8 * [new tag] 2.3.0 -> 2.3.0 * [new tag] 2.3.1 -> 2.3.1 * [new tag] 22.11.0 -> 22.11.0 * [new tag] 22.11.1 -> 22.11.1 * [new tag] 22.9.0 -> 22.9.0 * [new tag] 23.1.0 -> 23.1.0 * [new tag] 23.10.0 -> 23.10.0 * [new tag] 23.11.0 -> 23.11.0 * [new tag] 23.3.0 -> 23.3.0 * [new tag] 23.3.1 -> 23.3.1 * [new tag] 23.5.0 -> 23.5.0 * [new tag] 23.5.1 -> 23.5.1 * [new tag] 23.5.2 -> 23.5.2 * [new tag] 23.7.0 -> 23.7.0 * [new tag] 23.7.1 -> 23.7.1 * [new tag] 23.7.2 -> 23.7.2 * [new tag] 23.7.3 -> 23.7.3 * [new tag] 23.7.4 -> 23.7.4 * [new tag] 23.9.0 -> 23.9.0 * [new tag] 24.1.0 -> 24.1.0 * [new tag] 24.1.1 -> 24.1.1 * [new tag] 24.1.2 -> 24.1.2 * [new tag] 24.11.0 -> 24.11.0 * [new tag] 24.11.1 -> 24.11.1 * [new tag] 24.11.2 -> 24.11.2 * [new tag] 24.11.3 -> 24.11.3 * [new tag] 24.3.0 -> 24.3.0 * [new tag] 24.4.0 -> 24.4.0 * [new tag] 24.5.0 -> 24.5.0 * [new tag] 24.7.0 -> 24.7.0 * [new tag] 24.7.1 -> 24.7.1 * [new tag] 24.9.0 -> 24.9.0 * [new tag] 24.9.1 -> 24.9.1 * [new tag] 24.9.2 -> 24.9.2 * [new tag] 25.1.0 -> 25.1.0 * [new tag] 25.1.1 -> 25.1.1 * [new tag] 25.11.0 -> 25.11.0 * [new tag] 25.11.1 -> 25.11.1 * [new tag] 25.3.0 -> 25.3.0 * [new tag] 25.3.1 -> 25.3.1 * [new tag] 25.5.0 -> 25.5.0 * [new tag] 25.5.1 -> 25.5.1 * [new tag] 25.7.0 -> 25.7.0 * [new tag] 25.9.0 -> 25.9.0 * [new tag] 25.9.1 -> 25.9.1 * [new tag] 26.1.0 -> 26.1.0 * [new tag] 26.1.1 -> 26.1.1 * [new tag] 26.3.0 -> 26.3.0 * [new tag] 26.3.1 -> 26.3.1 * [new tag] 26.3.2 -> 26.3.2 * [new tag] 26.5.0 -> 26.5.0 * [new tag] 26.5.1 -> 26.5.1 * [new tag] 26.5.2 -> 26.5.2 * [new tag] 26.5.3 -> 26.5.3 * [new tag] 3.0.0 -> 3.0.0 * [new tag] 3.0.1 -> 3.0.1 * [new tag] 3.0.2 -> 3.0.2 * [new tag] 3.0.3 -> 3.0.3 * [new tag] 3.0.4 -> 3.0.4 * [new tag] 3.0.5 -> 3.0.5 * [new tag] 3.0.6 -> 3.0.6 * [new tag] 3.1.0 -> 3.1.0 * [new tag] 3.1.1 -> 3.1.1 * [new tag] 3.10.0 -> 3.10.0 * [new tag] 3.10.1 -> 3.10.1 * [new tag] 3.11.0 -> 3.11.0 * [new tag] 3.12.0 -> 3.12.0 * [new tag] 3.13.0 -> 3.13.0 * [new tag] 3.14.0 -> 3.14.0 * [new tag] 3.14.1 -> 3.14.1 * [new tag] 3.15.0 -> 3.15.0 * [new tag] 3.15.1 -> 3.15.1 * [new tag] 3.16.0 -> 3.16.0 * [new tag] 3.17.0 -> 3.17.0 * [new tag] 3.18.0 -> 3.18.0 * [new tag] 3.18.1 -> 3.18.1 * [new tag] 3.18.2 -> 3.18.2 * [new tag] 3.18.3 -> 3.18.3 * [new tag] 3.18.4 -> 3.18.4 * [new tag] 3.18.5 -> 3.18.5 * [new tag] 3.18.6 -> 3.18.6 * [new tag] 3.18.7 -> 3.18.7 * [new tag] 3.18.8 -> 3.18.8 * [new tag] 3.18.9 -> 3.18.9 * [new tag] 3.19.0 -> 3.19.0 * [new tag] 3.19.1 -> 3.19.1 * [new tag] 3.19.2 -> 3.19.2 * [new tag] 3.19.3 -> 3.19.3 * [new tag] 3.2.0 -> 3.2.0 * [new tag] 3.2.0a1 -> 3.2.0a1 * [new tag] 3.2.1 -> 3.2.1 * [new tag] 3.3.0 -> 3.3.0 * [new tag] 3.3.1 -> 3.3.1 * [new tag] 3.3.2 -> 3.3.2 * [new tag] 3.4.0 -> 3.4.0 * [new tag] 3.4.1 -> 3.4.1 * [new tag] 3.4.2 -> 3.4.2 * [new tag] 3.4.3 -> 3.4.3 * [new tag] 3.5.0 -> 3.5.0 * [new tag] 3.5.1 -> 3.5.1 * [new tag] 3.5.2 -> 3.5.2 * [new tag] 3.5.3 -> 3.5.3 * [new tag] 3.5.4 -> 3.5.4 * [new tag] 3.5.5 -> 3.5.5 * [new tag] 3.6.0 -> 3.6.0 * [new tag] 3.6.1 -> 3.6.1 * [new tag] 3.6.2 -> 3.6.2 * [new tag] 3.6.3 -> 3.6.3 * [new tag] 3.6.4 -> 3.6.4 * [new tag] 3.7.0 -> 3.7.0 * [new tag] 3.7.1 -> 3.7.1 * [new tag] 3.7.2 -> 3.7.2 * [new tag] 3.7.3 -> 3.7.3 * [new tag] 3.7.4 -> 3.7.4 * [new tag] 3.8.0 -> 3.8.0 * [new tag] 3.8.1 -> 3.8.1 * [new tag] 3.8.2 -> 3.8.2 * [new tag] 3.8.3 -> 3.8.3 * [new tag] 3.8.4 -> 3.8.4 * [new tag] 3.9.0 -> 3.9.0 * [new tag] 3.9.1 -> 3.9.1 * [new tag] 4.0.0 -> 4.0.0 * [new tag] 4.0.1 -> 4.0.1 * [new tag] 4.0.10 -> 4.0.10 * [new tag] 4.0.11 -> 4.0.11 * [new tag] 4.0.2 -> 4.0.2 * [new tag] 4.0.3 -> 4.0.3 * [new tag] 4.0.4 -> 4.0.4 * [new tag] 4.0.5 -> 4.0.5 * [new tag] 4.0.6 -> 4.0.6 * [new tag] 4.0.7 -> 4.0.7 * [new tag] 4.0.8 -> 4.0.8 * [new tag] 4.0.9 -> 4.0.9 * [new tag] 4.1.0 -> 4.1.0 * [new tag] 4.1.1 -> 4.1.1 * [new tag] 4.1.10 -> 4.1.10 * [new tag] 4.1.11 -> 4.1.11 * [new tag] 4.1.12 -> 4.1.12 * [new tag] 4.1.2 -> 4.1.2 * [new tag] 4.1.3 -> 4.1.3 * [new tag] 4.1.4 -> 4.1.4 * [new tag] 4.1.5 -> 4.1.5 * [new tag] 4.1.6 -> 4.1.6 * [new tag] 4.1.7 -> 4.1.7 * [new tag] 4.1.8 -> 4.1.8 * [new tag] 4.1.9 -> 4.1.9 * [new tag] 4.10.0 -> 4.10.0 * [new tag] 4.10.1 -> 4.10.1 * [new tag] 4.10.2 -> 4.10.2 * [new tag] 4.10.3 -> 4.10.3 * [new tag] 4.11.0 -> 4.11.0 * [new tag] 4.12.0 -> 4.12.0 * [new tag] 4.13.0 -> 4.13.0 * [new tag] 4.14.0 -> 4.14.0 * [new tag] 4.2.0 -> 4.2.0 * [new tag] 4.2.1 -> 4.2.1 * [new tag] 4.2.10 -> 4.2.10 * [new tag] 4.2.11 -> 4.2.11 * [new tag] 4.2.12 -> 4.2.12 * [new tag] 4.2.13 -> 4.2.13 * [new tag] 4.2.14 -> 4.2.14 * [new tag] 4.2.15 -> 4.2.15 * [new tag] 4.2.16 -> 4.2.16 * [new tag] 4.2.2 -> 4.2.2 * [new tag] 4.2.3 -> 4.2.3 * [new tag] 4.2.4 -> 4.2.4 * [new tag] 4.2.5 -> 4.2.5 * [new tag] 4.2.6 -> 4.2.6 * [new tag] 4.2.7 -> 4.2.7 * [new tag] 4.2.8 -> 4.2.8 * [new tag] 4.2.9 -> 4.2.9 * [new tag] 4.3.0 -> 4.3.0 * [new tag] 4.3.1 -> 4.3.1 * [new tag] 4.3.10 -> 4.3.10 * [new tag] 4.3.11 -> 4.3.11 * [new tag] 4.3.12 -> 4.3.12 * [new tag] 4.3.13 -> 4.3.13 * [new tag] 4.3.14 -> 4.3.14 * [new tag] 4.3.15 -> 4.3.15 * [new tag] 4.3.16 -> 4.3.16 * [new tag] 4.3.17 -> 4.3.17 * [new tag] 4.3.18 -> 4.3.18 * [new tag] 4.3.19 -> 4.3.19 * [new tag] 4.3.2 -> 4.3.2 * [new tag] 4.3.20 -> 4.3.20 * [new tag] 4.3.21 -> 4.3.21 * [new tag] 4.3.22 -> 4.3.22 * [new tag] 4.3.23 -> 4.3.23 * [new tag] 4.3.24 -> 4.3.24 * [new tag] 4.3.25 -> 4.3.25 * [new tag] 4.3.26 -> 4.3.26 * [new tag] 4.3.27 -> 4.3.27 * [new tag] 4.3.28 -> 4.3.28 * [new tag] 4.3.29 -> 4.3.29 * [new tag] 4.3.3 -> 4.3.3 * [new tag] 4.3.30 -> 4.3.30 * [new tag] 4.3.31 -> 4.3.31 * [new tag] 4.3.32 -> 4.3.32 * [new tag] 4.3.33 -> 4.3.33 * [new tag] 4.3.34 -> 4.3.34 * [new tag] 4.3.4 -> 4.3.4 * [new tag] 4.3.5 -> 4.3.5 * [new tag] 4.3.6 -> 4.3.6 * [new tag] 4.3.7 -> 4.3.7 * [new tag] 4.3.8 -> 4.3.8 * [new tag] 4.3.9 -> 4.3.9 * [new tag] 4.4.0 -> 4.4.0 * [new tag] 4.4.0alpha0 -> 4.4.0alpha0 * [new tag] 4.4.0beta2 -> 4.4.0beta2 * [new tag] 4.4.0rc0 -> 4.4.0rc0 * [new tag] 4.4.1 -> 4.4.1 * [new tag] 4.4.10 -> 4.4.10 * [new tag] 4.4.11 -> 4.4.11 * [new tag] 4.4.2 -> 4.4.2 * [new tag] 4.4.3 -> 4.4.3 * [new tag] 4.4.4 -> 4.4.4 * [new tag] 4.4.5 -> 4.4.5 * [new tag] 4.4.6 -> 4.4.6 * [new tag] 4.4.7 -> 4.4.7 * [new tag] 4.4.8 -> 4.4.8 * [new tag] 4.4.9 -> 4.4.9 * [new tag] 4.5.0 -> 4.5.0 * [new tag] 4.5.0rc0 -> 4.5.0rc0 * [new tag] 4.5.1 -> 4.5.1 * [new tag] 4.5.10 -> 4.5.10 * [new tag] 4.5.11 -> 4.5.11 * [new tag] 4.5.12 -> 4.5.12 * [new tag] 4.5.2 -> 4.5.2 * [new tag] 4.5.3 -> 4.5.3 * [new tag] 4.5.4 -> 4.5.4 * [new tag] 4.5.5 -> 4.5.5 * [new tag] 4.5.6 -> 4.5.6 * [new tag] 4.5.7 -> 4.5.7 * [new tag] 4.5.8 -> 4.5.8 * [new tag] 4.5.9 -> 4.5.9 * [new tag] 4.6.0 -> 4.6.0 * [new tag] 4.6.0a1 -> 4.6.0a1 * [new tag] 4.6.0a2 -> 4.6.0a2 * [new tag] 4.6.0b0 -> 4.6.0b0 * [new tag] 4.6.0b1 -> 4.6.0b1 * [new tag] 4.6.0rc1 -> 4.6.0rc1 * [new tag] 4.6.1 -> 4.6.1 * [new tag] 4.6.10 -> 4.6.10 * [new tag] 4.6.11 -> 4.6.11 * [new tag] 4.6.12 -> 4.6.12 * [new tag] 4.6.13 -> 4.6.13 * [new tag] 4.6.14 -> 4.6.14 * [new tag] 4.6.2 -> 4.6.2 * [new tag] 4.6.3 -> 4.6.3 * [new tag] 4.6.4 -> 4.6.4 * [new tag] 4.6.5 -> 4.6.5 * [new tag] 4.6.6 -> 4.6.6 * [new tag] 4.6.7 -> 4.6.7 * [new tag] 4.6.8 -> 4.6.8 * [new tag] 4.6.9 -> 4.6.9 * [new tag] 4.7.0 -> 4.7.0 * [new tag] 4.7.1 -> 4.7.1 * [new tag] 4.7.10 -> 4.7.10 * [new tag] 4.7.11 -> 4.7.11 * [new tag] 4.7.12 -> 4.7.12 * [new tag] 4.7.2 -> 4.7.2 * [new tag] 4.7.3 -> 4.7.3 * [new tag] 4.7.4 -> 4.7.4 * [new tag] 4.7.5 -> 4.7.5 * [new tag] 4.7.6 -> 4.7.6 * [new tag] 4.7.7 -> 4.7.7 * [new tag] 4.7.8 -> 4.7.8 * [new tag] 4.7.9 -> 4.7.9 * [new tag] 4.8.0 -> 4.8.0 * [new tag] 4.8.0rc0 -> 4.8.0rc0 * [new tag] 4.8.1 -> 4.8.1 * [new tag] 4.8.2 -> 4.8.2 * [new tag] 4.8.3 -> 4.8.3 * [new tag] 4.8.4 -> 4.8.4 * [new tag] 4.8.5 -> 4.8.5 * [new tag] 4.9.0 -> 4.9.0 * [new tag] 4.9.1 -> 4.9.1 * [new tag] 4.9.2 -> 4.9.2 [rtd-command-info] start-time: 2026-08-04T20:51:23.128714Z, end-time: 2026-08-04T20:51:23.225251Z, duration: 0, exit-code: 0 asdf global python miniconda3-3.12-24.9.2-0 [rtd-command-info] start-time: 2026-08-04T20:51:25.159914Z, end-time: 2026-08-04T20:51:25.208587Z, duration: 0, exit-code: 0 cat docs/environment.yml channels: - conda-forge dependencies: - Pillow==12.3.0 - Sphinx<10 - boltons>=26.1.0 - conda-sphinx-theme==0.4.0 - frozendict>=2.4.7 - linkify-it-py==2.1.0 - myst-parser==5.1.0 - plantuml==1.2026.6 - pluggy==1.6.0 - pylint==4.0.6 - requests>=2.28.0,<3 - ruamel.yaml>=0.11.14,<0.20 - sphinx-argparse==0.5.2 - sphinx-autoapi==3.8.0 - sphinx-autobuild==2025.8.25 - sphinx-reredirects==1.1.0 - sphinx-sitemap==2.9.0 - sphinx-design==0.7.0 - sphinx-copybutton==0.5.2 - sphinxcontrib-applehelp==2.0.0 - sphinxcontrib-devhelp==2.0.0 - sphinxcontrib-htmlhelp==2.1.0 - sphinxcontrib-jsmath==1.0.1 - sphinxcontrib-mermaid==2.1.0 - sphinxcontrib-programoutput==0.20 - sphinxcontrib-qthelp==2.0.0 - sphinxcontrib-serializinghtml==2.0.0 - tqdm>=4.70.0 - conda-libmamba-solver>=26.7.0 - pip>25 - pip: - sphinxcontrib-plantuml==0.31 - sphinx name: sphinx [rtd-command-info] start-time: 2026-08-04T20:51:25.287085Z, end-time: 2026-08-04T20:52:12.963149Z, duration: 47, exit-code: 0 conda env create --quiet --name latest --file docs/environment.yml /home/docs/.asdf/installs/python/miniconda3-3.12-24.9.2-0/lib/python3.12/argparse.py:2006: FutureWarning: `remote_definition` is deprecated and will be removed in 25.9. Use `conda env create --file=URL` instead. action(self, namespace, argument_values, option_string) Channels: - conda-forge - defaults Platform: linux-64 Collecting package metadata (repodata.json): ...working... done Solving environment: ...working... done Preparing transaction: ...working... done Verifying transaction: ...working... done Executing transaction: ...working... done Installing pip dependencies: ...working... done [rtd-command-info] start-time: 2026-08-04T20:52:13.036182Z, end-time: 2026-08-04T20:52:13.080302Z, duration: 0, exit-code: 0 git update-index --assume-unchanged docs/environment.yml docs/source/conf.py [rtd-command-info] start-time: 2026-08-04T20:52:13.208069Z, end-time: 2026-08-04T20:52:17.090719Z, duration: 3, exit-code: 0 python -m pip install --no-deps --no-cache-dir --editable . Obtaining file:///home/docs/checkouts/readthedocs.org/user_builds/continuumio-conda/checkouts/latest Installing build dependencies: started Installing build dependencies: finished with status 'done' Checking if build backend supports build_editable: started Checking if build backend supports build_editable: finished with status 'done' Getting requirements to build editable: started Getting requirements to build editable: finished with status 'done' Installing backend dependencies: started Installing backend dependencies: finished with status 'done' Preparing editable metadata (pyproject.toml): started Preparing editable metadata (pyproject.toml): finished with status 'done' Building wheels for collected packages: conda Building editable for conda (pyproject.toml): started Building editable for conda (pyproject.toml): finished with status 'done' Created wheel for conda: filename=conda-26.7.1.dev19-py3-none-any.whl size=9620 sha256=7d771e0a5f0bfce54fb38f7a9a26c638b1e60b2245f25067a218a7af0b16f02f Stored in directory: /tmp/pip-ephem-wheel-cache-melmreoi/wheels/ed/0a/91/fcd7bae38f67abe701da28c3e9587c0a5ac58b7a7e802cadfd Successfully built conda Installing collected packages: conda Successfully installed conda-26.7.1.dev19 [rtd-command-info] start-time: 2026-08-04T20:52:17.166087Z, end-time: 2026-08-04T20:52:17.205703Z, duration: 0, exit-code: 0 cat docs/source/conf.py #!/usr/bin/env python3 # Copyright (C) 2012 Anaconda, Inc # SPDX-License-Identifier: BSD-3-Clause import os.path import sys from pathlib import Path # expose custom extensions sys.path.insert(0, os.path.abspath("_extensions")) # expose source code for import sys.path.insert(0, os.path.abspath("../..")) import conda # -- Project information ----------------------------------------------------- project = conda.__name__ copyright = "2017, Anaconda, Inc" author = conda.__author__ version = release = conda.__version__ # -- General configuration ------------------------------------------------ # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ "autoapi.extension", "conda_umls", "conda_sphinx_theme.version_anchors", "myst_parser", "sphinx.ext.autodoc", "sphinx.ext.autosectionlabel", "sphinx.ext.autosummary", "sphinx.ext.graphviz", "sphinx.ext.ifconfig", "sphinx.ext.inheritance_diagram", "sphinx.ext.intersphinx", "sphinx.ext.napoleon", "sphinx_reredirects", "sphinx_sitemap", "sphinxarg.ext", "sphinx_copybutton", "sphinxcontrib.mermaid", "sphinxcontrib.plantuml", "sphinxcontrib.programoutput", "sphinx_design", ] templates_path = ["_templates"] # Leave double dashes as they are in the docs. Don't replace -- with - smartquotes = False # If true, the current module name will be prepended to all description # unit titles (such as .. function::). add_module_names = False # -- Options for HTML output ---------------------------------------------- # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. html_theme = "conda_sphinx_theme" # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ["_static"] # Add any extra paths that contain custom files (such as robots.txt or # .htaccess) here, relative to this directory. These files are copied # directly to the root of the documentation. html_extra_path = [ # Serving the robots.txt since we want to point to the sitemap.xml file "robots.txt", ] html_js_files = [ "https://cdn.jsdelivr.net/npm/jspanel4@4.12.0/dist/jspanel.js", "https://cdn.jsdelivr.net/npm/jspanel4@4.12.0/dist/extensions/modal/jspanel.modal.js", "https://unpkg.com/@panzoom/panzoom@4.4.1/dist/panzoom.min.js", "js/panzoom.js", ] html_css_files = [ "https://cdn.jsdelivr.net/npm/jspanel4@4.12.0/dist/jspanel.css", "css/custom.css", ] # Setting the prod URL of the site here as the base URL. html_baseurl = f"https://docs.conda.io/projects/{project}/" html_theme_options = { # The maximum depth of the table of contents tree. Set this to -1 to allow # unlimited depth. "navigation_depth": -1, "show_prev_next": False, # Navbar icon links "navbar_start": ["navbar-logo"], "use_edit_page_button": True, "goatcounter_url": "https://docs-conda-io.goatcounter.com/count", "show_version_warning_banner": True, "switcher": { # This should live in "latest" (=in-development version) since # we can modify the supported versions in the version switcher "json_url": "https://docs.conda.io/projects/conda/en/latest/_static/switcher.json", # Use RTD's automatic version variable, and fallback to "stable" "version_match": os.environ.get("READTHEDOCS_VERSION", "stable"), }, } html_context = { "github_user": "conda", "github_repo": "conda", "github_version": "main", "doc_path": "docs/source", "goatcounter_dashboard_url": "https://docs-conda-io.goatcounter.com", } # -- sphinxcontrib.plantuml ------------------------------------------------ plantuml_output_format = "svg_img" plantuml = ( f"java -Djava.awt.headless=true -jar {Path(sys.prefix) / 'lib' / 'plantuml.jar'}" ) # -- For sphinx.ext.intersphinx -------------------------------------------- intersphinx_mapping = { "python": ("https://docs.python.org/3", None), "pluggy": ("https://pluggy.readthedocs.io/en/stable/", None), } # -- For sphinx_sitemap ---------------------------------------------------- sitemap_locales = [None] sitemap_url_scheme = "{lang}stable/{link}" # -- For myst_parser ------------------------------------------------------- myst_heading_anchors = 3 myst_enable_extensions = [ "amsmath", "colon_fence", "deflist", "dollarmath", "html_admonition", "html_image", "linkify", "replacements", "smartquotes", "substitution", "tasklist", ] # -- For sphinx_copybutton ------------------------------------------------- # Remove prompt text when copying code blocks copybutton_prompt_text = r"\$ |> " copybutton_prompt_is_regexp = True copybutton_only_copy_prompt_lines = True copybutton_remove_prompts = True # -- For autoapi.extension ------------------------------------------------- autoapi_dirs = ["../../conda"] autoapi_root = "dev-guide/api" # Manually inserted into TOC in dev-guide/api.rst for proper integration into # folder-view autoapi_add_toctree_entry = False autoapi_template_dir = "_templates/autoapi" autoapi_python_class_content = "both" autoapi_keep_files = True suppress_warnings = [ "autosectionlabel.*", ] def skip_log(app, what, name, obj, skip, options): if what == "data" and name.split(".")[-1] == "log": skip = True return skip def setup(sphinx): sphinx.connect("autoapi-skip-member", skip_log) # ----------------------------------------------------------------------------- # Source code links # ----------------------------------------------------------------------------- link_github = True # -- For sphinx_reredirects ------------------------------------------------ redirects = { # internal redirects "admin": "user-guide/configuration/admin-multi-user-install.html", "api/api": "../dev-guide/api/conda/index.html", "api/index": "../dev-guide/api.html", "api/python_api": "../dev-guide/api/conda/cli/python_api/index.html", "api/solver": "../dev-guide/api/conda/api/index.html#conda.api.Solver", "changelog": "release-notes.html", "channels": "user-guide/tasks/manage-channels.html", "commands": "commands/index.html", "config": "user-guide/configuration/index.html", "custom-channels": "user-guide/tasks/create-custom-channels.html", "download": "user-guide/install/download.html", "env-commands": "commands/index.html", "faq": "user-guide/tasks/index.html", "general-commands": "commands/index.html", "get-started": "user-guide/index.html", "help/conda-pip-virtualenv-translator": "../commands/index.html", "help/silent": "../user-guide/install/index.html", "install/central": "../user-guide/configuration/admin-multi-user-install.html", "install/full": "../user-guide/install/index.html", "install/quick": "../user-guide/install/index.html", "install/sample-condarc": "../user-guide/configuration/sample-condarc.html", "install/tab-completion": "../user-guide/configuration/enable-tab-completion.html", "installation": "user-guide/install/index.html", "intro": "index.html", "mro": "user-guide/tasks/use-mro-with-conda.html", "py2or3": "user-guide/tasks/manage-python.html", "r-with-conda": "user-guide/tasks/use-r-with-conda.html", "redirects": "index.html", "test-drive": "user-guide/getting-started.html", "troubleshooting": "user-guide/troubleshooting.html", "using/cheatsheet": "../user-guide/cheatsheet.html", "using/envs": "../user-guide/tasks/manage-environments.html", "using/index": "../user-guide/tasks/index.html", "using/pkgs": "../user-guide/tasks/manage-pkgs.html", "using/test-drive": "../user-guide/getting-started.html", "using/using": "../user-guide/tasks/manage-conda.html", "user-guide/install/download": "../install/index.html", "user-guide/configuration/sample-condarc": "../configuration/use-condarc.html#sample-condarc", "user-guide/configuration/enable-tab-completion": "../configuration/index.html", # external redirects "travis": "https://github.com/conda-incubator/setup-miniconda", "user-guide/tasks/use-conda-with-travis-ci": "https://github.com/conda-incubator/setup-miniconda", "user-guide/tasks/use-mro-with-conda": "https://docs.anaconda.com/anaconda/user-guide/tasks/use-r-language", "user-guide/tasks/use-r-with-conda": "https://docs.anaconda.com/anaconda/user-guide/tasks/use-r-language", } [rtd-command-info] start-time: None, end-time: None, duration: None, exit-code: None python -m sphinx -T -b html -d _build/doctrees -D language=en . $READTHEDOCS_OUTPUT/html