.readthedocs.yaml

# SPDX-FileCopyrightText: Contributors to the Power Grid Model project <powergridmodel@lfenergy.org>
#
# SPDX-License-Identifier: MPL-2.0

version: 2

# Build from the docs/ directory with Sphinx
sphinx:
  configuration: docs/conf.py

build:
  os: "ubuntu-22.04"
  tools:
    python: "3.11"
  jobs:
    post_install:
      # Build package with doc requirements from pyproject.optional-dependencies
      - pip install --verbose --editable .[doc]
      # remove API DLL define in header
      - find power_grid_model_c/power_grid_model_c/include -name *.h -exec sed -i -r "s/#define PGM.*//g" {} \;
      - find power_grid_model_c/power_grid_model_c/include -name *.h -exec sed -i -r "s/PGM_API //g" {} \;
      # build doxygen for C header
      - cd docs/doxygen && doxygen && cd ../..
      # download support
      - wget -P docs/release_and_support https://github.com/PowerGridModel/.github/raw/main/RELEASE.md
      - wget -P docs/release_and_support https://github.com/PowerGridModel/.github/raw/main/SUPPORT.md
      - wget -P docs/release_and_support https://github.com/PowerGridModel/.github/raw/main/SECURITY.md
      - wget -P docs/release_and_support https://github.com/PowerGridModel/.github/raw/main/CITATION.md
      # download contribution
      - wget -P docs/contribution https://github.com/PowerGridModel/.github/raw/main/GOVERNANCE.md
      - wget -P docs/contribution https://github.com/PowerGridModel/.github/raw/main/CONTRIBUTING.md
      - wget -P docs/contribution https://github.com/PowerGridModel/.github/raw/main/CODE_OF_CONDUCT.md
      # fix links
      - find docs/release_and_support -name "*.md" -exec sed -i -r "s|./CONTRIBUTING.md|../contribution/CONTRIBUTING.md|g" {} \;