.readthedocs.yaml

# Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
version: 2
build:
  os: ubuntu-24.04
  tools:
    python: "3.12"
  commands:
    #
    # Install git-lfs
    #
    # Download and uncompress the binary
    # https://git-lfs.github.com/
    - wget https://github.com/git-lfs/git-lfs/releases/download/v3.6.0/git-lfs-linux-amd64-v3.6.0.tar.gz
    - tar xvfz git-lfs-linux-amd64-v3.6.0.tar.gz
    # Modify LFS config paths to point where git-lfs binary was downloaded
    - git config filter.lfs.process "`pwd`/git-lfs filter-process"
    - git config filter.lfs.smudge  "`pwd`/git-lfs smudge -- %f"
    - git config filter.lfs.clean "`pwd`/git-lfs clean -- %f"
    # Make LFS available in current repository
    - ./git-lfs-3.6.0/git-lfs install
    # Download content from remote
    - ./git-lfs-3.6.0/git-lfs fetch
    # Make local files to have the real content on them
    - ./git-lfs-3.6.0/git-lfs checkout
    #
    # Build using uv
    #
    - asdf plugin add uv
    - asdf install uv latest
    - asdf global uv latest
    - uv sync --only-group doc --frozen
    - uv run -m sphinx -T -b html -d doc/_build/doctrees doc $READTHEDOCS_OUTPUT/html