version: 2

# Important: we need to disable all unneeded formats.

# Note that HTML and JSON are always built: https://docs.readthedocs.io/en/latest/yaml-config.html#formats

# Especially, the 'htmlzip' format takes a LOT of memory and causes the build to fail - see our issue #1472:

# https://github.com/aiidateam/aiida-core/issues/1472

formats: []

build:

apt_packages:

- graphviz

os: ubuntu-22.04

tools:

python: '3.11'

jobs:

# Use uv to speed up the build

# https://docs.readthedocs.io/en/stable/build-customization.html#install-dependencies-with-uv

pre_create_environment:

- asdf plugin add uv

- asdf install uv 0.5.22

- asdf global uv 0.5.22

create_environment:

- uv venv

install:

- uv sync --extra docs --extra tests --extra rest --extra atomic_tools

build:

html:

- uv run sphinx-build -T -W --keep-going -b html -d _build/doctrees -D language=en docs/source $READTHEDOCS_OUTPUT/html

search:

ranking:

reference/apidoc/*: -7