New docs action

Author: C-Achard

.github/workflows/build_docs.yml

@@ -7,21 +7,30 @@ on:
       - cy/docs-action
 
 jobs:
-  build:
-
+  sphinx_docs_to_gh-pages:
     runs-on: ubuntu-latest
-
+    name: Sphinx docs to gh-pages
     steps:
-    - run: sudo apt-get update && sudo apt-get install libgl1
-    - uses: actions/checkout@v1
-    # Standard drop-in approach that should work for most people.
-    - uses: ammaraskar/sphinx-action@master
-      with:
-        pre-build-command: "pip install --upgrade pip \ pip install -r requirements.txt napari-cellseg3d opencv-python-headless"
-        docs-folder: "docs/"
-
-    - name: GitHub Pages action
-      uses: peaceiris/[email protected]
-      with:
-        github_token: ${{ secrets.GITHUB_TOKEN }}
-        publish_dir: ./docs/_build/html
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: Make conda environment
+        uses: conda-incubator/setup-miniconda@v2
+        with:
+          python-version: 3.9    # Python version to build the html sphinx documentation
+          environment-file: devtools/conda-envs/docs_env.yaml    # Path to the documentation conda environment
+          auto-update-conda: false
+          auto-activate-base: false
+          show-channel-urls: true
+      - name: Installing the library
+        shell: bash -l {0}
+        run: |
+          python setup.py install
+      - name: Running the Sphinx to gh-pages Action
+        uses: uibcdf/[email protected]
+        with:
+          branch: main
+          dir_docs: docs
+          sphinxapiopts: '--separate -o . ../'
+          sphinxapiexclude: '../*setup* ../*.ipynb'
+          sphinxopts: ''

devtools/__init__.py

@@ -0,0 +1,25 @@
+name: docs-env
+dependencies:
+  - black
+  - coverage
+  - isort
+  - pytest
+  - pytest
+  - pytest-qt
+  - sphinx
+  - sphinx-autodoc-typehints
+  - sphinx-rtd-theme
+  - tox
+  - twine
+  - numpy
+  - napari[all]>=0.4.14
+  - QtPy
+  - opencv-python>=4.5.5
+  - dask-image>=0.6.0
+  - matplotlib>=3.4.1
+  - tifffile>=2022.2.9
+  - imageio-ffmpeg>=0.4.5
+  - torch>=1.11
+  - monai[nibabel,scikit-image,itk,einops]>=0.9.0
+  - pillow
+  - vispy>=0.9.6