osm-commerces/wiki_compare/CHANGES.md

Changements implémentés

Ce document résume les changements et nouvelles fonctionnalités implémentés dans le cadre de la mise à jour du système de gestion des pages wiki OSM.

1. Suivi des changements récents du wiki OSM

Fonctionnalités ajoutées

• Création d'un script fetch_recent_changes.py qui récupère les changements récents dans l'espace de noms français du wiki OSM
• Ajout d'une nouvelle route /wiki/recent-changes dans le contrôleur WikiController
• Création d'un template wiki_recent_changes.html.twig pour afficher les changements récents
• Mise à jour de la navigation pour inclure un lien vers la page des changements récents

Utilisation

• Les changements récents sont automatiquement récupérés toutes les heures
• La page affiche la liste des pages modifiées récemment avec des liens vers ces pages

2. Validation de la hiérarchie des titres

Fonctionnalités ajoutées

• Implémentation d'une logique de détection des hiérarchies de titres incorrectes (par exemple, h4 directement sous h2 sans h3 intermédiaire)
• Ajout d'indicateurs visuels (badges) pour signaler les hiérarchies incorrectes dans les listes de sections
• Mise à jour du template wiki_compare.html.twig pour afficher ces indicateurs

Utilisation

• Les hiérarchies incorrectes sont automatiquement détectées lors de la comparaison des pages wiki
• Un badge rouge avec un point d'exclamation est affiché à côté des titres ayant une hiérarchie incorrecte

3. Vérification des groupes locaux

Fonctionnalités ajoutées

• Mise à jour du script fetch_osm_fr_groups.py pour récupérer les données des groupes locaux depuis Framacalc
• Ajout d'une fonctionnalité de vérification de l'existence d'une page wiki pour chaque groupe
• Mise à jour du template wiki_osm_fr_groups.html.twig pour afficher les résultats de vérification
• Ajout de filtres pour faciliter la navigation parmi les groupes

Utilisation

• Les groupes sont affichés avec des badges indiquant leur source (wiki ou Framacalc)
• Les groupes sans page wiki sont mis en évidence avec un badge rouge
• Les filtres permettent de voir uniquement les groupes d'une certaine catégorie (tous, wiki, Framacalc, avec page wiki, sans page wiki)

Limitations connues

1. Accès aux données externes : Les scripts peuvent rencontrer des difficultés pour accéder aux données externes (wiki OSM, Framacalc) en fonction de l'environnement d'exécution.

2. Détection des hiérarchies : La détection des hiérarchies incorrectes se base uniquement sur les niveaux des titres et ne prend pas en compte le contenu ou la sémantique.

3. Correspondance des groupes : La correspondance entre les groupes Framacalc et les pages wiki se fait par une comparaison approximative des noms, ce qui peut parfois donner des résultats imprécis.

Maintenance future

Scripts Python

• Les scripts Python sont situés dans le répertoire wiki_compare/
• Ils peuvent être exécutés manuellement ou via des tâches cron
• L'option --dry-run permet de tester les scripts sans modifier les fichiers
• L'option --force permet de forcer la mise à jour même si le cache est récent

Templates Twig

• Les templates sont situés dans le répertoire templates/admin/
• wiki_recent_changes.html.twig : Affichage des changements récents
• wiki_compare.html.twig : Comparaison des pages wiki avec validation de hiérarchie
• wiki_osm_fr_groups.html.twig : Affichage des groupes locaux avec vérification des pages wiki

Contrôleur

• Le contrôleur WikiController.php contient toutes les routes et la logique de traitement
• La méthode detectHeadingHierarchyErrors() peut être ajustée pour modifier les règles de validation des hiérarchies
• Les méthodes de rafraîchissement des données (refreshRecentChangesData(), etc.) peuvent être modifiées pour ajuster la fréquence de mise à jour