home.md

@@ -828,4 +828,18 @@ Sur PLMShift, en Administrateur, dans "Workloads/Deployment Configs", cliquer su
 
 ## Pour gérer le lien entre le dépôt du site web et le stockage S3 du PLMShift
 
-La procédure est pour le moment décrite [ici](https://gitlab.math.unistra.fr/groupe-calcul/website/-/issues/257#note_21137)
\ No newline at end of file
+La procédure est pour le moment décrite [ici](https://gitlab.math.unistra.fr/groupe-calcul/website/-/issues/257#note_21137)
+
+## Lancer le plugin pour vérifier les liens morts
+
+Le plugin n'est pas activé par défaut car il prend beaucoup de temps. Pour chaque page du site, il fait une requête pour chaque lien trouvé (il y a un système de cache pour ne pas refaire plusieurs fois le même lien). 
+Pour l'activer, il faut éditer le fichier `pelicanconf.py` et modifier la ligne `DEADLINK_VALIDATION=False` en `DEADLINK_VALIDATION=True`. Il y a une option `timeout_duration_ms` à changer s'il y a trop d'erreurs dans la détection des site web qui mettent trop longtemps à répondre. Une bonne valeur est `10000` pour `10s` par exemple. Il faut ensuite compiler le site-web avec un `make html` par exemple.
+
+Dans le rapport, il y a plusieurs catégories d'erreur :
+
+- Une liste de lien vers des sites avec un problème dans la chaîne de certificat ;
+- Des sites qui retournent des erreurs 4XX ou 5XX ;
+- Des sites qui mettent trop de temps à répondre. Il faut les vérifier un par un pour être sûr.
+- Des liens vers des fichiers locaux manquant. Parfois, c'est juste un lien sans la partie `http://` ou `https://` qui est considéré comme un lien interne alors que ce n'est pas le cas.
+
+Un autre plugin est tout le temps activé et lancé à chaque compilation du site. Il fait la liste des fichiers n'ayant aucun lien dans le site pointant vers eux.
\ No newline at end of file