Build doc in CI

.github/workflows/ci-linux.yml

@@ -28,6 +28,9 @@ jobs:
         pip install pdm nox
     - name: Test with nox
       run: |
+        $(hg debuginstall -T '{pythonexe}') -m pip install hg-evolve hg-git --no-cache-dir --user --break-system-packages
+        cp docker/hgrc $HOME/.hgrc
+        hg version -v
         cp .github/workflows/.fluidfft-site.cfg $HOME
         nox -s test_without_fft_and_pythran
         nox -s test_with_fft_and_pythran

.gitlab-ci.yml

@@ -3,6 +3,7 @@ stages:
   - lint
   - test
   - report
+  - doc
 
 variables:
   COVERAGE_DIR: .coverage_$CI_COMMIT_SHA
@@ -107,3 +108,33 @@ report_coverage:
     - pip install coverage
     - coverage combine
     - coverage report
+
+
+doc:build:
+  stage: doc
+  needs:
+    - job: "CI image"
+      optional: true
+  variables:
+    FLUIDFFT_TRANSONIC_BACKEND: "python"
+  script:
+    - python -m venv .venv
+    - . .venv/bin/activate
+    - pip install fluidfft
+    - pdm install -G doc -G fft -G test --no-self
+    - pip install . --config-settings=setup-args=-Dtransonic-backend=python
+    - pdm run xvfb-run --auto-servernum sphinx-build -W -b html -d doc/_build/doctrees doc doc/_build/html
+    - mkdir -p public/$CI_COMMIT_REF_NAME
+    - rsync -rvc --delete doc/_build/html/* public/$CI_COMMIT_REF_NAME/
+    # This directory can become too large leading to error.
+    # It can be purged with the botton "Clear runner caches"
+    # in https://foss.heptapod.net/fluiddyn/fluidsim/-/pipelines
+    - ls public
+    - echo "CI_COMMIT_REF_NAME="$CI_COMMIT_REF_NAME
+    - echo See https://fluiddyn.pages.heptapod.net/fluidsim/$CI_COMMIT_REF_NAME
+  artifacts:
+    name: "$CI_COMMIT_REF_NAME"
+    paths:
+      - public
+    expire_in: 5 days
+  when: always

.readthedocs.yml

@@ -1,24 +1,17 @@
-# Read the Docs configuration file
-# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
-
-# Required
 version: 2
 
-# Set the version of Python and other tools you might need
 build:
   os: ubuntu-22.04
   tools:
     python: "3.11"
+  jobs:
+    post_create_environment:
+      - pip install pdm pip -U
+    post_install:
+      - pdm use -f $READTHEDOCS_VIRTUALENV_PATH
+      - FLUIDFFT_TRANSONIC_BACKEND="python" pip install fluidfft
+      - pdm install -G doc -G fft -G test --no-self
+      - pip install . --config-settings=setup-args=-Dtransonic-backend=python
 
-# Build documentation in the doc directory with Sphinx
 sphinx:
   configuration: doc/conf.py
-
-python:
-  install:
-    - requirements: .readthedocs.req
-    - method: pip
-      path: .
-      extra_requirements:
-        - doc
-        - fft