Fonctionnalité : validation des liens Mkdocs 1.5 (#966)

Cette PR ajoute la configuration pour la validation des liens (externes et internes) désormais intégrée à Mkdocs directement : https://www.mkdocs.org/user-guide/configuration/#validation ```yaml links: absolute_links: warn not_found: warn unrecognized_links: info nav: absolute_links: ignore not_found: warn omitted_files: info ``` ## Changement des consignes de rédaction Cela a des impacts au moment de la rédaction car jusqu'à présent on recommandait plutôt la notation de liens sous forme absolue : - avant : ```markdown [forces de l'ordre](/rdp/2011/rdp_2011-12-09#openstreetmap-et-les-forces-de-lordre). ``` - maintenant : ```markdown [forces de l'ordre](../../rdp/2011/rdp_2011-12-09.md#openstreetmap-et-les-forces-de-lordre) ``` ## Avantages - on utilise la syntaxe de Mkdocs et on profite de la validation intégrée - on peut naviguer entre les contenus depuis un IDE ou GitHub - on profite des fonctionnalités d'autocomplétion des IDE comme VS Code : [edition_hyperliens_vscode_autocompletion.webm](https://github.com/geotribu/website/assets/1596222/0b1acd8f-adb8-4407-8491-bacb20316c75)
geotribu · Sep 18, 2023 · a2e87cb · a2e87cb
2 parents 4093b0a + 1739884
commit a2e87cb
Show file tree

Hide file tree

Showing 176 changed files with 2,287 additions and 446 deletions.
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -11,6 +11,13 @@
     "editor.codeActionsOnSave": {
         "source.organizeImports": true
     },
+    // Markdown
+    "markdown.validate.enabled": true,
+    "markdown.validate.fileLinks.markdownFragmentLinks": "warning",
+    "markdown.validate.fragmentLinks.enabled": "warning",
+    "[markdown]": {
+        "files.trimTrailingWhitespace": false,
+    },
     // Python
     "python.defaultInterpreterPath": ".venv/bin/python",
     "python.formatting.provider": "none",

diff --git a/config/redirection_mapping_geotribu_tutoriels.txt b/config/redirection_mapping_geotribu_tutoriels.txt
diff --git a/config/validation.yml b/config/validation.yml
@@ -0,0 +1,8 @@
+links:
+  absolute_links: warn
+  not_found: warn
+  unrecognized_links: warn
+nav:
+  absolute_links: warn
+  not_found: warn
+  omitted_files: warn
diff --git a/...ticles/2008/2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles.md b/...ticles/2008/2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles.md
@@ -22,7 +22,7 @@ tags:
 
 ![logo Google](https://cdn.geotribu.fr/img/logos-icones/entreprises_association/google/google.webp "logo Google"){: .img-rdp-news-thumb }
 
-Suite au [tutoriel d'introduction](/articles/2008/2008-08-22_1-introduction-a-l-api-google-maps/) sur l'API Google Maps, il devient nécessaire d'enrichir un peu la carte de boutons de contrôle et de sélecteurs de vue. Nous verrons ici comment utiliser les méthodes de l'API Google Maps pour étoffer la carte.
+Suite au [tutoriel d'introduction](2008-08-22_1-introduction-a-l-api-google-maps.md) sur l'API Google Maps, il devient nécessaire d'enrichir un peu la carte de boutons de contrôle et de sélecteurs de vue. Nous verrons ici comment utiliser les méthodes de l'API Google Maps pour étoffer la carte.
 
 ## Initialisation
 

diff --git a/content/articles/2008/2008-08-22_deplacer-des-objets-vecteurs-sur-la-carte.md b/content/articles/2008/2008-08-22_deplacer-des-objets-vecteurs-sur-la-carte.md
@@ -20,7 +20,7 @@ tags:
 
 ![Logo OpenLayers](https://cdn.geotribu.fr/img/logos-icones/logiciels_librairies/openlayers.png){: .img-rdp-news-thumb }
 
-Ce tutorial est la suite logique de "[Ajout d'une barre d'outil dessin à OpenLayers](/articles/2008/2008-08-22_ajouter-une-barre-de-dessin-a-openlayers/)". En effet, nous allons étudier les différentes interactions possibles avec les objets de type vectors. Il s'appuie en grande partie de ressources disponibles sur le net, et notamment : [OpenLayers Drag Feature](http://www.openlayers.org/dev/examples/drag-feature.html).
+Ce tutorial est la suite logique de "[Ajout d'une barre d'outil dessin à OpenLayers](2008-08-22_ajouter-une-barre-de-dessin-a-openlayers.md)". En effet, nous allons étudier les différentes interactions possibles avec les objets de type vectors. Il s'appuie en grande partie de ressources disponibles sur le net, et notamment : [OpenLayers Drag Feature](http://www.openlayers.org/dev/examples/drag-feature.html).
 
 ## Déplacer des objets sur la carte
 

diff --git a/content/articles/2008/2008-08-24_6-personnaliser-les-controles.md b/content/articles/2008/2008-08-24_6-personnaliser-les-controles.md
@@ -27,7 +27,7 @@ Il est parfois frustrant lorsqu'on utilise des API de ne pas pouvoir personnalis
 
 ### Initialisation
 
-Reprendre la carte du [tutoriel n°1](/articles/2008/2008-08-22_1-introduction-a-l-api-google-maps/).  
+Reprendre la carte du [tutoriel n°1](2008-08-22_1-introduction-a-l-api-google-maps.md).  
 
 ### Création de la fonction zoom
 

diff --git a/...icles/2008/2008-09-05_8-superposer-un-fichier-kml-et-enrichir-les-infobulles.md b/...icles/2008/2008-09-05_8-superposer-un-fichier-kml-et-enrichir-les-infobulles.md
@@ -27,7 +27,7 @@ L'API Google Maps permet de superposer des fichiers KML sur une carte. Et d'affi
 
 ## Initialisation
 
-Reprendre la carte du [deuxième tutoriel](/articles/2008/2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles/).
+Reprendre la carte du [deuxième tutoriel](2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles.md).
 
 ## Appel d'un fichier KML et affichage sur la carte
 

diff --git a/content/articles/2008/2008-09-07_11-geocoder-une-adresse.md b/content/articles/2008/2008-09-07_11-geocoder-une-adresse.md
@@ -26,7 +26,7 @@ Nous allons voir dans ce tutoriel comment utiliser cette fonctionnalité et comm
 
 ## Initialisation
 
-Reprendre la carte du [tutoriel n°2](/articles/2008/2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles/).  
+Reprendre la carte du [tutoriel n°2](2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles.md).  
 
 ## Géocodage
 

diff --git a/content/articles/2008/2008-09-07_12-calculer-un-itineraire.md b/content/articles/2008/2008-09-07_12-calculer-un-itineraire.md
@@ -24,7 +24,7 @@ De la même manière que le géocodage à l'adresse, l'API Google Maps permet de
 
 ## Initialisation
 
-Reprendre la carte du [tutoriel n°2](/articles/2008/2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles/).
+Reprendre la carte du [tutoriel n°2](2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles.md).
 
 ## Calcul de l'itinéraire
 

diff --git a/...-07_9-superposer-une-carte-a-google-maps-avec-generation-prealable-de-tuiles.md b/...-07_9-superposer-une-carte-a-google-maps-avec-generation-prealable-de-tuiles.md
@@ -37,7 +37,7 @@ Il convient alors de stocker les tuiles générées dans un répertoire sur votr
 
 ## Initialisation de la carte
 
-Reprendre la carte du [tutoriel n°2](/articles/2008/2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles/) pour initialiser la carte.  
+Reprendre la carte du [tutoriel n°2](2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles.md) pour initialiser la carte.  
 
 ## Définition des fonctions
 

diff --git a/...articles/2008/2008-09-15_interfacer-openlayers-avec-un-serveur-wfs-mapserver.md b/...articles/2008/2008-09-15_interfacer-openlayers-avec-un-serveur-wfs-mapserver.md
@@ -71,7 +71,7 @@ Un exemple de requête serait la suivante : une requête de type "GetFeature" es
 
 ## Faire de MapServer un serveur WFS
 
-Cette partie suppose que vous soyez déjà familier de l'environnement MapServer et que vous sachiez comment est constitué un MapFile. Dans le cas contraire, je vous invite à lire auparavant ce tutoriel : [Tutorial MapServer](/articles/2008/2008-08-22_initiation-a-mapserver/).
+Cette partie suppose que vous soyez déjà familier de l'environnement MapServer et que vous sachiez comment est constitué un MapFile. Dans le cas contraire, je vous invite à lire auparavant ce tutoriel : [Tutorial MapServer](2008-08-22_initiation-a-mapserver.md).
 
 Pour spécifier à MapServer de fonctionner en tant que serveur WMS, il sera nécessaire d'ajouter différents attributs à votre MapFile. Les blocs à modifier sont les suivants :
 

diff --git a/content/articles/2008/2008-09-20_mettre-en-place-un-serveur-wfs-t.md b/content/articles/2008/2008-09-20_mettre-en-place-un-serveur-wfs-t.md
@@ -18,7 +18,7 @@ tags:
 
 ## Qu'est ce que FeatureServer ?
 
-Dans un [précédent tutoriel](/articles/2008/2008-09-15_interfacer-openlayers-avec-un-serveur-wfs-mapserver/) nous avions appris que les serveurs WFS, en fonction de leurs capacités, peuvent être regroupés en différentes catégories. Si la plupart permettent l'affichage des objets géographiques sous forme de vecteur, peu d'entre eux permettent de réaliser des opérations de mises à jour, suppression ou création sur ces mêmes objets.  
+Dans un [précédent tutoriel](2008-09-15_interfacer-openlayers-avec-un-serveur-wfs-mapserver.md) nous avions appris que les serveurs WFS, en fonction de leurs capacités, peuvent être regroupés en différentes catégories. Si la plupart permettent l'affichage des objets géographiques sous forme de vecteur, peu d'entre eux permettent de réaliser des opérations de mises à jour, suppression ou création sur ces mêmes objets.  
 
 C'est là tout l'intérêt de "Feature Server". En effet, basé sur la même logique que TileCache, il permet au moyen d'un simple fichier de configuration de disposer d'un serveur WFS transactionnel.  
 

diff --git a/content/articles/2008/2008-11-02_2-ajoutons-quelques-controles.md b/content/articles/2008/2008-11-02_2-ajoutons-quelques-controles.md
@@ -23,11 +23,11 @@ tags:
 
 ![logo Google Earth](https://cdn.geotribu.fr/img/logos-icones/entreprises_association/google/googleearth.png "logo Google Earth"){: .img-rdp-news-thumb }
 
-Ce deuxième tutoriel reprend le globe défini dans le [premier tutoriel](/articles/2008/2008-10-28_1-introduction-a-l-api-google-earth/) en lui ajoutant des éléments de contrôle.  
+Ce deuxième tutoriel reprend le globe défini dans le [premier tutoriel](2008-10-28_1-introduction-a-l-api-google-earth.md) en lui ajoutant des éléments de contrôle.  
 
 ## Initialisation
 
-Reprendre le globe défini dans le [premier tutoriel](/articles/2008/2008-10-28_1-introduction-a-l-api-google-earth/).  
+Reprendre le globe défini dans le [premier tutoriel](2008-10-28_1-introduction-a-l-api-google-earth.md).  
 
 ## Processus
 

diff --git a/content/articles/2008/2008-11-02_3-la-tour-eiffel-en-3d.md b/content/articles/2008/2008-11-02_3-la-tour-eiffel-en-3d.md
@@ -30,7 +30,7 @@ Nous verrons ici comment afficher la tour Eiffel et comment définir par défaut
 
 ## Initialisation
 
-Reprendre le globe du [tutoriel n°2](/articles/2008/2008-11-02_2-ajoutons-quelques-controles/).  
+Reprendre le globe du [tutoriel n°2](2008-11-02_2-ajoutons-quelques-controles.md).  
 
 ## Processus
 

diff --git a/content/articles/2008/2008-11-02_4-marqueurs-et-evenements.md b/content/articles/2008/2008-11-02_4-marqueurs-et-evenements.md
@@ -27,7 +27,7 @@ Il est possible à l'instar de l'API Google Maps de créer des marqueurs sur la
 
 ## Initialisation
 
-Reprendre le globe du [deuxième tutoriel](/articles/2008/2008-11-02_2-ajoutons-quelques-controles/).  
+Reprendre le globe du [deuxième tutoriel](2008-11-02_2-ajoutons-quelques-controles.md).  
 
 ## Processus
 

diff --git a/content/articles/2008/2008-11-02_5-ajouter-un-fichier-kml.md b/content/articles/2008/2008-11-02_5-ajouter-un-fichier-kml.md
@@ -24,9 +24,9 @@ tags:
 ## Prérequis
 
 - Tutoriaux :
-    - [1. Introduction à l'API Google Earth](/articles/2008/2008-11-02_2-ajoutons-quelques-controles/)
-    - [2. Ajoutons quelques contrôles](/articles/2008/2008-11-02_2-ajoutons-quelques-controles/)
-    - [4. Marqueurs et événements](/articles/2008/2008-11-02_4-marqueurs-et-evenements/)
+    - [1. Introduction à l'API Google Earth](2008-11-02_2-ajoutons-quelques-controles.md)
+    - [2. Ajoutons quelques contrôles](2008-11-02_2-ajoutons-quelques-controles.md)
+    - [4. Marqueurs et événements](2008-11-02_4-marqueurs-et-evenements.md)
 
 - Connaissances :
     - notions de HTML, notions de JavaScript, notions d'algorithmique
@@ -148,7 +148,7 @@ google.earth.fetchKml(ge, kmlUrl, finished);
 
 ## Processus
 
-1. Reprendre la carte du [tutoriel sur les marqueurs et les événements](/articles/2008/2008-09-15_interfacer-openlayers-avec-un-serveur-wfs-mapserver/)
+1. Reprendre la carte du [tutoriel sur les marqueurs et les événements](2008-09-15_interfacer-openlayers-avec-un-serveur-wfs-mapserver.md)
 
 2. Définir une fonction qui vérifie la validité du fichier KML :  
 

diff --git a/content/articles/2008/2008-11-17_13-ajouter-la-couche-streetview.md b/content/articles/2008/2008-11-17_13-ajouter-la-couche-streetview.md
@@ -29,7 +29,7 @@ L'API Google Maps propose le service Street View qui permet de naviguer virtuell
 
 ## Initialisation
 
-Reprendre la carte du [tutoriel n°2](/articles/2008/2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles/).  
+Reprendre la carte du [tutoriel n°2](2008-08-22_2-enrichir-la-carte-avec-des-boutons-et-des-controles.md).  
 
 ## Superposition de l'emprise
 

diff --git a/content/articles/2008/2008-11-17_15-ajouter-la-googlebar.md b/content/articles/2008/2008-11-17_15-ajouter-la-googlebar.md
@@ -93,7 +93,7 @@ Lorsque l'on fait une recherche grâce à cette GoogleBar, l'API place automatiq
 ## Conclusion
 
 Petit tutorial pour savoir déclarer le service GoogleBar.
-Cette méthode est identique au tutoriel - [11](/articles/2008/2008-09-07_11-geocoder-une-adresse/).
+Cette méthode est identique au tutoriel - [11](2008-09-07_11-geocoder-une-adresse.md).
 
 ----
 

diff --git a/content/articles/2008/2008-11-20_le-webmapping-de-demain-wfs-et-wps.md b/content/articles/2008/2008-11-20_le-webmapping-de-demain-wfs-et-wps.md
@@ -27,15 +27,15 @@ Pour illustrer ces propos, l'interface présentée ci-dessous s'appuie sur Featu
 
 ## Feature Server
 
-[FeatureServer](http://featureserver.org/) a déjà fait l'objet d'un [tutoriel sur ce site](/articles/2008/2008-09-20_mettre-en-place-un-serveur-wfs-t), nous ne nous attarderons donc pas sur celui-ci.Mais globalement il existe deux types de serveurs wfs d'un côté ceux permettant un accés uniquement en lecture et d'un autre côté ceux autorisant la manipulation et la modifications des objets géographiques. FeatureServer fait partie de ces derniers.
+[FeatureServer](http://featureserver.org/) a déjà fait l'objet d'un [tutoriel sur ce site](2008-09-20_mettre-en-place-un-serveur-wfs-t.md), nous ne nous attarderons donc pas sur celui-ci.Mais globalement il existe deux types de serveurs wfs d'un côté ceux permettant un accés uniquement en lecture et d'un autre côté ceux autorisant la manipulation et la modifications des objets géographiques. FeatureServer fait partie de ces derniers.
 
 ## WebProcessingServer
 
 [WebProcessingServer](http://code.google.com/p/webprocessingserver/) est une implémentation de la norme WPS. Il permet, depuis une interface Web, d'interroger un serveur distant qui sera chargé d'effectuer des traitements cartographiques pour ensuite les renvoyer au client.
 
 ## Exemples
 
-[![Applications WFS/WPS](/sites/default/files/Tuto/img/WFS/wfs_wps.jpg)](http://geotribu.net/applications/wfs_wps/index.htm "Applications WFS/WPS")
+![Applications WFS/WPS](https://cdn.geotribu.fr/img/articles-blog-rdp/normes/WFS/wfs_wps.jpg)
 
 ----
 

diff --git a/...ticles/2008/2008-11-30_creer-une-minimap-personnalisable-avec-mapfish-et-ext.md b/...ticles/2008/2008-11-30_creer-une-minimap-personnalisable-avec-mapfish-et-ext.md
@@ -33,7 +33,7 @@ Il existe deux étapes primordiales pour réaliser un héritage de classe avec M
 
 Cet objet qui héritera de la classe windows d'ext permettra d'afficher dans une fenêtre flottante une mini carte. Nous y ajouterons une méthode qui permettra le placement automatique de cette mini-map dans le bloc center.
 
-Commencons par créer notre nouvel objet. La méthode mapfish.widgets.miniMap est le [constructeur de la classe](/articles/2008/2008-08-22_creer-des-classes-en-javascript/). La méthode apply permet d'appeler une fonction Javascrit pour l'objet spécifié en lui passant les paramètres dans un tableau. Ainsi chacune de options de configuration que vous aurez défini deviendra des propriétés de l'objet lui même.
+Commencons par créer notre nouvel objet. La méthode mapfish.widgets.miniMap est le [constructeur de la classe](2008-08-22_creer-des-classes-en-javascript.md). La méthode apply permet d'appeler une fonction Javascrit pour l'objet spécifié en lui passant les paramètres dans un tableau. Ainsi chacune de options de configuration que vous aurez défini deviendra des propriétés de l'objet lui même.
 
 ```javascript
 mapfish.widgets.miniMap = function(config) {  

diff --git a/content/articles/2008/2008-12-01_6-afficher-un-objet-en-3d.md b/content/articles/2008/2008-12-01_6-afficher-un-objet-en-3d.md
@@ -29,7 +29,7 @@ L'API Google Earth propose d'afficher dans son globe des objets en 3D provenant
 
 ## Initialisation
 
-Reprendre la carte du tutoriel sur les marqueurs et les événements : [Tutoriel n°4](/articles/2008/2008-11-02_4-marqueurs-et-evenements/)
+Reprendre la carte du tutoriel sur les marqueurs et les événements : [Tutoriel n°4](2008-11-02_4-marqueurs-et-evenements.md)
 
 ## Processus