Merge branch 'api-docs' into 'master'

updated gitlab-ci to install requirements before building the documentation....

See merge request m300602/pyicon!26

.gitlab-ci.yml

 pages:
   script:
+  - apt-get update
+  - apt-get -y upgrade
+  - apt-get -y install make
+  - conda env create -f ci/requirements_py311.yml
+  - source activate pyicon_py311
+  - pip install -e .
   - cd doc
-  - apk add --repository https://dl-cdn.alpinelinux.org/alpine/edge/community pandoc
-  - pip install nbsphinx nbsphinx_link pydata_sphinx_theme
   - make html
   - mv _build/html/* ../public/
 
   tags:
-  - sphinx
+  - conda
 
   only:
   - master
@@ -15,4 +19,4 @@ pages:
   artifacts:
     paths:
     - public
-    expire_in: 5min
+    expire_in: 10min

ci/requirements_py311.yml

+name: pyicon_py311
+channels:
+  - conda-forge
+dependencies:
+  - python=3.11
+  - numpy
+  - dask
+  - matplotlib
+  - cartopy
+  - netcdf4
+  - xarray
+  - zarr
+  - pandas
+  - cmocean
+  - scipy
+  - ipdb
+  - ipywidgets
+  - jupytext
+  - pytest
+  - healpy
+  - pandoc
+  - sphinx  # Documentation
+  - nbsphinx  # Documentation
+  - nbsphinx-link  # Documentation
+  - sphinx-copybutton  # Documentation
+  - pydata-sphinx-theme  # Documentation