asit-asso · benoitregamey · Nov 27, 2025 · Apr 15, 2025 · Apr 28, 2025 · Sep 4, 2025
diff --git a/.github/workflows/docs-ci.yml b/.github/workflows/docs-ci.yml
@@ -0,0 +1,29 @@
+name: Build documentation
+run-name: Building static documentation website after push by ${{ github.actor }}
+on:
+  push:
+    branches:
+      - master
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV 
+      - uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache 
+          restore-keys: |
+            mkdocs-material-
+      - run: pip install mkdocs-material mkdocs-exclude-search
+      - run: mkdocs gh-deploy --force
diff --git a/.gitignore b/.gitignore
@@ -13,3 +13,5 @@ extract-task-validation/target/
 CLAUDE.md
 INTEGRATION_TESTS_PLAN.md
 .claude/
+.venv/
+.smarttomcat/
diff --git a/README.md b/README.md
@@ -19,6 +19,10 @@ En automatisant le processus d'extraction et de livraison de vos géodonnées, v
 
 Extract est modulable et extensible, à installer dans l’environnement informatique de chaque fournisseur de données, et accessible via un navigateur.
 
+## 📋Documentation
+
+Toute la documentation pour installer, paramétrer et utiliser Extract est en ligne (en anglais) : https://asit-asso.github.io/extract/
+
 ## Groupe utilisateurs
 
 L'ASIT, des administrations et gestionnaires de réseaux forment un groupe utilisateur qui pilote et finance le projet
@@ -41,62 +45,12 @@ Actuellement, 37 fournisseurs diffusent tout ou partie de leurs géodonnées ave
 * Holdigaz Prestations SA
 * ASIT - Association pour le système d'information du territoire
 
-## Pour installer
-
-Suivez les guides d'installation et d'exploitation ici : https://github.com/asit-asso/extract/wiki
-
-### Prérequis:
-* Windows or Linux, 64bit
-* Java 17 (Oracle ou OpenJDK)
-* Tomcat 9 (Extract n’est actuellement pas compatible avec Tomcat 10 en raison de l’utilisation de Spring Boot 2)
-* PostgreSQL >= 12
-
-## Développement
-
-### Packaging
-
-Pour générer un WAR de l'application, il faut lancer la commande suivante
-```bash
-mvn package
-```
-
-Outre le fichier WAR, l'archive de livraison d'une nouvelle version contient :
-
-* La dernière version du script de mise à jour de la base de données (`sql/update_db.sql`)
-* La documentation : 
-  * guide d'installation (`doc/MAN_ASIT_Extract_ManuelInstallation.pdf`)
-  * guide d'exploitation (`doc/MAN_ASIT_Extract_ManuelExploitation.pdf`) 
-  * guide d'utilisation (`doc/MAN_ASIT_Extract_ManuelUtilisation.pdf`)
-  * documentation de création d'un connecteur (`doc/extract-connector-sample/`)
-  * documentation de création d'un plugin de tâche (`doc/extract-task-sample/`)
-* Le script d'exemple FME (`fme/`)
-
-### Tests
-
-Les tests unitaires peuvent se lancer indépendamment du packaging par la commande
-```bash
-mvn -q test -Punit-tests --batch-mode --fail-at-end
-```
-
-Pour exécuter les tests d'intégration
-```bash
-mvn -q verify -Pintegration-tests --batch-mode
-```
-
-Pour les tests fonctionnels (nécessite que l'application tourne sur le port 8080 du localhost)
-```bash
-mvn -q verify -Pfunctional-tests --batch-mode
-```
-
-## Documentation et liens:
-
-Aide et documentation : https://github.com/asit-asso/extract/wiki
+## Liens:
 
 Présentations sur le projet aux Rencontres ASIT : https://asit-asso.ch/toutes-les-rencontres#2018
 
 L'ASIT, Association pour le Système d'Information du Territoire, à l'origine du projet : https://asit-asso.ch
 
-Forked from easySDI (www.easysdi.org) : https://svn.easysdi.org/svn/easysdi/branches/4.5.x/java
 
 ## Screenshots:
 

diff --git a/doc/DC_ASITVD_Extract_DossierArchitectureTechnique_V1.12.pdf b/doc/DC_ASITVD_Extract_DossierArchitectureTechnique_V1.12.pdf
diff --git a/doc/MAN_ASIT_Extract_ManuelExploitation.pdf b/doc/MAN_ASIT_Extract_ManuelExploitation.pdf
diff --git a/doc/MAN_ASIT_Extract_ManuelExploitation_V1.13.docx b/doc/MAN_ASIT_Extract_ManuelExploitation_V1.13.docx
diff --git a/doc/MAN_ASIT_Extract_ManuelInstallation.pdf b/doc/MAN_ASIT_Extract_ManuelInstallation.pdf
diff --git a/doc/MAN_ASIT_Extract_ManuelInstallation_V1.13.docx b/doc/MAN_ASIT_Extract_ManuelInstallation_V1.13.docx
diff --git a/doc/MAN_ASIT_Extract_ManuelUtilisation.pdf b/doc/MAN_ASIT_Extract_ManuelUtilisation.pdf
diff --git a/doc/MAN_ASIT_Extract_ManuelUtilisation_V1.9.docx b/doc/MAN_ASIT_Extract_ManuelUtilisation_V1.9.docx
diff --git a/doc/extract-connector-sample/getting-started.md b/doc/extract-connector-sample/getting-started.md
diff --git a/doc/extract-task-sample/getting-started.md b/doc/extract-task-sample/getting-started.md
diff --git a/docs/assets/admin-guide/connectors-list.png b/docs/assets/admin-guide/connectors-list.png
diff --git a/docs/assets/admin-guide/connectors-parameters.png b/docs/assets/admin-guide/connectors-parameters.png
diff --git a/docs/assets/admin-guide/connectors-rules.png b/docs/assets/admin-guide/connectors-rules.png
diff --git a/docs/assets/admin-guide/ldap-authentication.png b/docs/assets/admin-guide/ldap-authentication.png
diff --git a/docs/assets/admin-guide/misc.png b/docs/assets/admin-guide/misc.png
diff --git a/docs/assets/admin-guide/operating-hours.png b/docs/assets/admin-guide/operating-hours.png
diff --git a/docs/assets/admin-guide/orchestration.png b/docs/assets/admin-guide/orchestration.png
diff --git a/docs/assets/admin-guide/processes-list.png b/docs/assets/admin-guide/processes-list.png
diff --git a/docs/assets/admin-guide/processes-parameters.png b/docs/assets/admin-guide/processes-parameters.png
diff --git a/docs/assets/admin-guide/processes-tasks.png b/docs/assets/admin-guide/processes-tasks.png
diff --git a/docs/assets/admin-guide/smtp-server.png b/docs/assets/admin-guide/smtp-server.png
diff --git a/docs/assets/admin-guide/tasks-list.png b/docs/assets/admin-guide/tasks-list.png
diff --git a/docs/assets/admin-guide/users-groups-list.png b/docs/assets/admin-guide/users-groups-list.png
diff --git a/docs/assets/admin-guide/users-groups-settings.png b/docs/assets/admin-guide/users-groups-settings.png
diff --git a/docs/assets/admin-guide/users-list.png b/docs/assets/admin-guide/users-list.png
diff --git a/docs/assets/admin-guide/users-settings.png b/docs/assets/admin-guide/users-settings.png
diff --git a/docs/assets/admin-guide/validation-template-details.png b/docs/assets/admin-guide/validation-template-details.png
diff --git a/docs/assets/admin-guide/validation-templates-list.png b/docs/assets/admin-guide/validation-templates-list.png
diff --git a/docs/assets/admin-guide/validation.png b/docs/assets/admin-guide/validation.png
diff --git a/docs/assets/asit_extract_blanc.png b/docs/assets/asit_extract_blanc.png
diff --git a/docs/assets/dev-guide/2fa-connection-flow.png b/docs/assets/dev-guide/2fa-connection-flow.png
diff --git a/docs/assets/dev-guide/2fa-parameters-admin.png b/docs/assets/dev-guide/2fa-parameters-admin.png
diff --git a/docs/assets/dev-guide/2fa-parameters-own.png b/docs/assets/dev-guide/2fa-parameters-own.png
diff --git a/docs/assets/dev-guide/basic-logic-diagram.png b/docs/assets/dev-guide/basic-logic-diagram.png
diff --git a/docs/assets/dev-guide/data-model.png b/docs/assets/dev-guide/data-model.png
diff --git a/docs/assets/dev-guide/ldap-synchro.jpg b/docs/assets/dev-guide/ldap-synchro.jpg
diff --git a/docs/assets/dev-guide/login-diagram.jpg b/docs/assets/dev-guide/login-diagram.jpg
diff --git a/docs/assets/dev-guide/request-lifecycle.png b/docs/assets/dev-guide/request-lifecycle.png
diff --git a/docs/assets/dev-guide/software-architecture-diagram.png b/docs/assets/dev-guide/software-architecture-diagram.png
diff --git a/docs/assets/extract_favicon64.png b/docs/assets/extract_favicon64.png
diff --git a/docs/assets/how-to/fme-flow/connection.png b/docs/assets/how-to/fme-flow/connection.png
diff --git a/docs/assets/how-to/fme-flow/create-webhook.png b/docs/assets/how-to/fme-flow/create-webhook.png
diff --git a/docs/assets/how-to/fme-flow/data-download.png b/docs/assets/how-to/fme-flow/data-download.png
diff --git a/docs/assets/how-to/fme-flow/download-webhook.png b/docs/assets/how-to/fme-flow/download-webhook.png
diff --git a/docs/assets/how-to/fme-flow/manage-tokens.png b/docs/assets/how-to/fme-flow/manage-tokens.png
diff --git a/docs/assets/how-to/fme-flow/plugin.png b/docs/assets/how-to/fme-flow/plugin.png
diff --git a/docs/assets/how-to/fme-flow/publish-files.png b/docs/assets/how-to/fme-flow/publish-files.png
diff --git a/docs/assets/how-to/fme-flow/publish-repo.png b/docs/assets/how-to/fme-flow/publish-repo.png
diff --git a/docs/assets/how-to/fme-flow/publish.png b/docs/assets/how-to/fme-flow/publish.png
diff --git a/docs/assets/how-to/fme-flow/repo-permissions.png b/docs/assets/how-to/fme-flow/repo-permissions.png
diff --git a/docs/assets/how-to/fme-flow/token.png b/docs/assets/how-to/fme-flow/token.png
diff --git a/docs/assets/how-to/fme-flow/user-parameter.png b/docs/assets/how-to/fme-flow/user-parameter.png
diff --git a/docs/assets/how-to/fme-form/plugin.png b/docs/assets/how-to/fme-form/plugin.png
diff --git a/docs/assets/how-to/fme-form/read-data.png b/docs/assets/how-to/fme-form/read-data.png
diff --git a/docs/assets/how-to/fme-form/read-parameters.png b/docs/assets/how-to/fme-form/read-parameters.png
diff --git a/docs/assets/how-to/fme-form/retrieve-variable.png b/docs/assets/how-to/fme-form/retrieve-variable.png
diff --git a/docs/assets/how-to/fme-form/save-data.png b/docs/assets/how-to/fme-form/save-data.png
diff --git a/docs/assets/how-to/fme-form/set-variable.png b/docs/assets/how-to/fme-form/set-variable.png
diff --git a/docs/assets/how-to/fme-form/user-parameter.png b/docs/assets/how-to/fme-form/user-parameter.png
diff --git a/docs/assets/how-to/python/plugin.png b/docs/assets/how-to/python/plugin.png
diff --git a/docs/assets/how-to/qgis/atlas.png b/docs/assets/how-to/qgis/atlas.png
diff --git a/docs/assets/how-to/qgis/control.png b/docs/assets/how-to/qgis/control.png
diff --git a/docs/assets/how-to/qgis/max-features.png b/docs/assets/how-to/qgis/max-features.png
diff --git a/docs/assets/how-to/qgis/plugin.png b/docs/assets/how-to/qgis/plugin.png
diff --git a/docs/assets/how-to/qgis/preview.png b/docs/assets/how-to/qgis/preview.png
diff --git a/docs/assets/how-to/viageo/metadata.png b/docs/assets/how-to/viageo/metadata.png
diff --git a/docs/assets/how-to/viageo/resources-id.png b/docs/assets/how-to/viageo/resources-id.png
diff --git a/docs/assets/install/create_admin.png b/docs/assets/install/create_admin.png
diff --git a/docs/assets/introduction/extract_robot.png b/docs/assets/introduction/extract_robot.png
diff --git a/docs/assets/introduction/shema_global_transparent2.png b/docs/assets/introduction/shema_global_transparent2.png
diff --git a/docs/assets/misc/data-replication.png b/docs/assets/misc/data-replication.png
diff --git a/docs/assets/user-guide/2FA-setup.png b/docs/assets/user-guide/2FA-setup.png
diff --git a/docs/assets/user-guide/2FA.png b/docs/assets/user-guide/2FA.png
diff --git a/docs/assets/user-guide/active-connectors.png b/docs/assets/user-guide/active-connectors.png
diff --git a/docs/assets/user-guide/login.png b/docs/assets/user-guide/login.png
diff --git a/docs/assets/user-guide/request-details.png b/docs/assets/user-guide/request-details.png
diff --git a/docs/assets/user-guide/request-reset-code.png b/docs/assets/user-guide/request-reset-code.png
diff --git a/docs/assets/user-guide/requests-admin-panel.png b/docs/assets/user-guide/requests-admin-panel.png
diff --git a/docs/assets/user-guide/requests-completed.png b/docs/assets/user-guide/requests-completed.png
diff --git a/docs/assets/user-guide/requests-customer-request.png b/docs/assets/user-guide/requests-customer-request.png
diff --git a/docs/assets/user-guide/requests-customer-response.png b/docs/assets/user-guide/requests-customer-response.png
diff --git a/docs/assets/user-guide/requests-error.png b/docs/assets/user-guide/requests-error.png
diff --git a/docs/assets/user-guide/requests-export-error.png b/docs/assets/user-guide/requests-export-error.png
diff --git a/docs/assets/user-guide/requests-import-error.png b/docs/assets/user-guide/requests-import-error.png
diff --git a/docs/assets/user-guide/requests-in-progress.png b/docs/assets/user-guide/requests-in-progress.png
diff --git a/docs/assets/user-guide/requests-no-processing.png b/docs/assets/user-guide/requests-no-processing.png
diff --git a/docs/assets/user-guide/requests-processing-history.png b/docs/assets/user-guide/requests-processing-history.png
diff --git a/docs/assets/user-guide/requests-validation.png b/docs/assets/user-guide/requests-validation.png
diff --git a/docs/assets/user-guide/reset-password.png b/docs/assets/user-guide/reset-password.png
diff --git a/docs/assets/user-guide/user-admin-menu.png b/docs/assets/user-guide/user-admin-menu.png
diff --git a/CHANGES.md → docs/changelog/v2.3/CHANGES.md b/CHANGES.md → docs/changelog/v2.3/CHANGES.md
diff --git a/doc/PATCH_ISSUE_308.md → docs/changelog/v2.3/PATCH_ISSUE_308.md b/doc/PATCH_ISSUE_308.md → docs/changelog/v2.3/PATCH_ISSUE_308.md
diff --git a/doc/PATCH_ISSUE_321.md → docs/changelog/v2.3/PATCH_ISSUE_321.md b/doc/PATCH_ISSUE_321.md → docs/changelog/v2.3/PATCH_ISSUE_321.md
diff --git a/doc/PATCH_ISSUE_323.md → docs/changelog/v2.3/PATCH_ISSUE_323.md b/doc/PATCH_ISSUE_323.md → docs/changelog/v2.3/PATCH_ISSUE_323.md
diff --git a/doc/PATCH_ISSUE_333.md → docs/changelog/v2.3/PATCH_ISSUE_333.md b/doc/PATCH_ISSUE_333.md → docs/changelog/v2.3/PATCH_ISSUE_333.md
diff --git a/doc/PATCH_ISSUE_337.md → docs/changelog/v2.3/PATCH_ISSUE_337.md b/doc/PATCH_ISSUE_337.md → docs/changelog/v2.3/PATCH_ISSUE_337.md
diff --git a/doc/PATCH_ISSUE_344.md → docs/changelog/v2.3/PATCH_ISSUE_344.md b/doc/PATCH_ISSUE_344.md → docs/changelog/v2.3/PATCH_ISSUE_344.md
diff --git a/doc/PATCH_ISSUE_346.md → docs/changelog/v2.3/PATCH_ISSUE_346.md b/doc/PATCH_ISSUE_346.md → docs/changelog/v2.3/PATCH_ISSUE_346.md
diff --git a/doc/PATCH_ISSUE_347.md → docs/changelog/v2.3/PATCH_ISSUE_347.md b/doc/PATCH_ISSUE_347.md → docs/changelog/v2.3/PATCH_ISSUE_347.md
diff --git a/doc/PATCH_ISSUE_351.md → docs/changelog/v2.3/PATCH_ISSUE_351.md b/doc/PATCH_ISSUE_351.md → docs/changelog/v2.3/PATCH_ISSUE_351.md
diff --git a/doc/PATCH_ISSUE_353.md → docs/changelog/v2.3/PATCH_ISSUE_353.md b/doc/PATCH_ISSUE_353.md → docs/changelog/v2.3/PATCH_ISSUE_353.md
diff --git a/doc/extract-connector-sample/.gitignore → docs/extract-connector-sample/.gitignore b/doc/extract-connector-sample/.gitignore → docs/extract-connector-sample/.gitignore