diff --git a/.github/workflows/continuous-integration.yml b/.github/workflows/continuous-integration.yml index eddb6f80..ef4a0268 100644 --- a/.github/workflows/continuous-integration.yml +++ b/.github/workflows/continuous-integration.yml @@ -80,19 +80,23 @@ jobs: docs: name: docs runs-on: ubuntu-latest + # Required shell entrypoint to have properly activated conda environment + defaults: + run: + shell: bash -l {0} steps: - uses: actions/checkout@v3 - - uses: actions/setup-python@v4 + - name: Setup Conda Environment + uses: conda-incubator/setup-miniconda@v2.2.0 with: + miniforge-variant: Mambaforge + miniforge-version: latest python-version: 3.9 - cache: "pip" - cache-dependency-path: "requirements-docs.txt" - - name: Install pandoc - run: sudo apt-get update && sudo apt-get -y install pandoc - - name: Install docs requirements - run: pip install -r requirements-docs.txt - - name: Install pystac_client - run: pip install . + use-mamba: true + channel-priority: strict + environment-file: ./docs/environment.yml + activate-environment: pystac-client-docs + auto-activate-base: false - name: Build docs run: ./scripts/build-docs diff --git a/docs/conf.py b/docs/conf.py index be94acf8..2fa352b4 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -63,7 +63,7 @@ ) } -nbsphinx_allow_errors = True +nbsphinx_allow_errors = False # Add any paths that contain templates here, relative to this directory. templates_path = ["_templates"] diff --git a/docs/environment.yml b/docs/environment.yml index 20d8d096..d3fc870d 100644 --- a/docs/environment.yml +++ b/docs/environment.yml @@ -3,7 +3,11 @@ channels: - conda-forge - defaults dependencies: - - python=3.8 + - cartopy + - geoviews + - pandoc + - python=3.9 + - pip - pip: - -r ../requirements-docs.txt - -e ../