feat: Update FES2022 documentation and binder configuration

The code changes include adding a new environment.yml file in the binder directory, which specifies the dependencies for the pyfes project. Additionally, the postBuild script has been modified to generate Jupyter notebooks from Python files and remove non-notebook files. The conf.py file in the docs/source directory has been updated to include the binder configuration for the FES2022 documentation.

Recent user commits and repository commits indicate a focus on documentation updates, code development information, and fixing syntax errors.

binder/environment.yml

@@ -0,0 +1,10 @@
+name: pyfes
+channels:
+  - conda-forge
+dependencies:
+  - cartopy
+  - matplotlib
+  - jupyter
+  - pyfes
+  - sphinx-gallery
+  - sphinx-inline-tabs

binder/postBuild

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -e
+
+TMP_CONTENT_DIR=/tmp/pyinterp
+mkdir -p $TMP_CONTENT_DIR
+cp -r examples binder $TMP_CONTENT_DIR
+
+find . -delete
+
+GENERATED_NOTEBOOKS_DIR=.generated-notebooks
+cp -r $TMP_CONTENT_DIR/examples $GENERATED_NOTEBOOKS_DIR
+
+find $GENERATED_NOTEBOOKS_DIR -name '*.py' -exec sphx_glr_python_to_jupyter.py '{}' +
+NON_NOTEBOOKS=$(find $GENERATED_NOTEBOOKS_DIR -type f | grep -v '\.ipynb')
+rm -f $NON_NOTEBOOKS
+
+mv $TMP_CONTENT_DIR/binder .
+rm -rf $TMP_CONTENT_DIR
+
+mkdir notebooks
+ln -s ../$GENERATED_NOTEBOOKS_DIR notebooks/auto_examples

docs/source/conf.py

@@ -81,17 +81,22 @@ def push_front_syspath():
     'examples_dirs': [HERE.parent.parent.joinpath('examples')],
     'filename_pattern': r'[\\\/]ex_',
     'pypandoc': False,
-    # 'binder': {
-    #     'org': 'CNES',
-    #     'repo': 'aviso-fes',
-    #     'branch': 'main',
-    #     'binderhub_url': 'https://mybinder.org',
-    #     'dependencies':
-    #     [HERE.joinpath('..', '..', 'binder', 'environment.yml')],
-    #     'use_jupyter_lab': True,
-    # }
+    'binder': {
+        'org':
+        'CNES',
+        'repo':
+        'aviso-fes',
+        'branch':
+        'main',
+        'binderhub_url':
+        'https://mybinder.org',
+        'dependencies':
+        [HERE.joinpath('..', '..', 'binder', 'environment.yml').resolve()],
+        'use_jupyter_lab':
+        True,
+    }
 }
-
+print([HERE.joinpath('..', '..', 'binder', 'environment.yml').resolve()])
 exclude_patterns = []
 
 # -- Options for HTML output -------------------------------------------------