Merge pull request OSGeo#13036 from rouault/ci_win_doc

CI: test building HTML documentation on Windows

Author: rouault

.github/workflows/cmake_builds.yml

@@ -436,6 +436,7 @@ jobs:
             sqlite tiledb zstd cryptopp cgal doxygen librttopo openssl liblzma-devel \
             openjdk ant qhull armadillo blas blas-devel libblas libcblas liblapack liblapacke blosc libarchive \
             libarrow pyarrow libaec libheif libavif muparser cmake fsspec
+        pip install -r doc/requirements.txt
     - name: Check CMake version
       shell: bash -l {0}
       run: |
@@ -468,14 +469,18 @@ jobs:
       run: cmake --build $GITHUB_WORKSPACE/build --config Release -j 2
       env:
         GIT_LFS_SKIP_SMUDGE: 1 # for PublicDecompWT github repository clone
+    - name: Build HTML pages
+      shell: bash -l {0}
+      run: cmake --build $GITHUB_WORKSPACE/build --config Release -j 2 --target html
     - name: test
       shell: bash -l {0}
       run: |
         cmake --build $GITHUB_WORKSPACE/build --config Release --target quicktest
     - name: test (with ctest)
       shell: bash -l {0}
       run: |
-        ctest --test-dir $GITHUB_WORKSPACE/build -C Release -V -j 3
+        # Exclude doc spellcheck as it crashes
+        ctest --test-dir $GITHUB_WORKSPACE/build -C Release -V -j 3 -E spelling
       env:
         SKIP_OGR_GMLAS_HUGE_PROCESSING_TIME: YES
         SKIP_OGR_GMLAS_HTTP_RELATED: YES

doc/source/conf.py

@@ -310,6 +310,7 @@ def check_python_bindings():
     (".*", "classPythonPluginLayer"),
     (".*", "classPythonPluginDriver"),
     (".*", "classGDALSubsetGroup"),
+    (".*", "structOGRwkbExportOptions"),  # only emitted by Windows CI
     # FIXME We ignore everything python related for now...
     ("py:.*", ".*"),
     # TODO: To examine

doc/source/drivers/raster/Idrisi.rst doc/source/drivers/raster/idrisi.rstdoc/source/drivers/raster/Idrisi.rst renamed to doc/source/drivers/raster/idrisi.rst

@@ -1,4 +1,4 @@
-.. _raster.Idrisi:
+.. _raster.idrisi:
 
 ================================================================================
 RST -- Idrisi Raster Format

doc/source/drivers/raster/index.rst

@@ -85,7 +85,7 @@ Raster drivers
    heif
    hf2
    hfa
-   Idrisi
+   idrisi
    ilwis
    iris
    isce

doc/source/spelling_wordlist.txt

@@ -297,6 +297,8 @@ buildbot
 Buildbot
 BuildVRT
 BuildVRTOptions
+bulleted
+Bulleted
 bumpmap
 BUnits
 bUnlinkAndSeize
@@ -1206,6 +1208,7 @@ gnot
 Gohlke
 Golang
 Golomb
+Goode
 goog
 googleapis
 gpkg
@@ -1256,6 +1259,7 @@ gz
 gzip
 GZip
 gzipped
+Hadoop
 Haff
 Halasz
 hana
@@ -1847,6 +1851,7 @@ Mollweide
 Mongo
 MONGOCXX
 mongocxxv
+MongoDB
 monoblock
 Monospace
 Morissette
@@ -1892,6 +1897,7 @@ multilines
 multilinestring
 multilinestrings
 Multipage
+multipart
 multipatch
 Multiplatform
 multipoint
@@ -2591,6 +2597,7 @@ precompiled
 precompute
 predefine
 predelete
+preinstalled
 prelimenary
 preload
 premultiplication
@@ -2760,8 +2767,8 @@ rasterization
 rasterize
 Rasterize
 rasterized
-rasterizes
 RasterizeOptions
+rasterizes
 rasterizing
 rasterlite
 Rasterlite