Aller au contenu

Modèle:Articles manquants/Documentation

Une page de Wikipédia, l'encyclopédie libre.
Ceci est une version archivée de cette page, en date du 2 décembre 2009 à 02:34 et modifiée en dernier par Dr Brains (discuter | contributions) (Résumé automatique : contenu remplacé par « {{subst:Utilisateur:Dr Brains/ArticlesManquants.js}} ».). Elle peut contenir des erreurs, des inexactitudes ou des contenus vandalisés non présents dans la version actuelle.

/*

Fonctions

Ce modèle est destiné à créer un tableau triable avec les pages d'une catégorie (typiquement Portail:TRUC/Articles liés, mais cela peut être n'importe quelle catégorie). Le tableau est inséré entre les modèles {{Articles récents}} et {{Articles récents fin}} dans un cadre défilant à la hauteur paramétrable pour faciliter l'inclusion dans un cadre de portail ou de projet.

Un code javascript permet de mettre à jour le tableau de façon automatisée.

Paramètres

  • {{{Portail}}} : Nom du portail sans l'espace de noms, les espaces remplacés par des "underscore" (obligatoire[1])
  • {[[pageportail}}} : Titre de la page à mettre à jour par le script (obligatoire)
  • {{{catégorie}}} : catégorie à checker ( catégorie:Portail:TRUC/Articles liés ) (obligatoire)
  • {{{defilant}}} : mettre « non » pour annuler le cadre défilant (facultatif).
  • {{{hauteur}}} : hauteur du cadre défilant créé, en pixels (facultatif : 250px par défaut)
  1. Dans d'autres versions du script, ce paramètre permet de rechercher la première apposition du bandeau

Exemples

L'exemple ci-dessous est celui d'un modèle avec comme instruction pour le script de vérifier la catégorie Catégorie:Portail:Colombie/Articles liés, d'extraire l'historique de chaque page, de vérifier la date de la dernière version (formatée pour le tri) puis d'apposer (ou mettre à jour) le tableau triable sur la page Portail:Colombie/Articles récents. Le tableau sera inséré dans un cadre défilant de 300 pixels de hauteur.


Catégorie:Portail:Colombie/Articles liés


Il est tout à fait possible de créer un tableau de la sorte sans forcément ajouter le modèle (et le cadre défilant qui va avec) dans la page à modifier, mais il reste nécessaire d'ajouter le modèle correctement paramétré sur une page quelconque pour avoir accès au lien de mise à jour. En d'autres termes, le modèle et le tableau créé sont parfaitement dissociables.

Par contre, les commentaires sont importants car ce sont eux que le script recherche pour détecter le début et la fin du tableau lors de sa mise à jour. S'il ne les trouve pas, le script ajoutera le modèle, et le tableau au début de la page.

Mise à jour

Aperçu du tableau de bord.

La mise à jour se fait à l'aide d'un code javascript dont le fonctionnement s'apparente à celui d'un bot. Il est à copier dans sa page monobook.js (ou autre suivant l'habillage choisi) .
L'utilisation du script permet l'affichage d'un lien au-dessus du tableau qui lance le processus de mise à jour :

  1. Un "tableau de bord" apparaît et deux pop-up successives permettent de commander le début de la mise à jour :
    • La première récapitule les paramètres du futur tableau. Il est possible d'annuler ou de poursuivre.
    • La deuxième permet de choisir le renouvellement automatique du processus. Cliquer OK pour lancer en mode automatique, annuler pour une mise à jour simple (dans ce cas, une pop-up de confirmation apparaît avant la sauvegarde).
  2. Requête ajax sur la catégorie (renouvellée autant de fois qu'il y a de pages) pour créer une liste de toutes les pages (liens).
  3. Requête ajax sur l'historique de chaque page, recopiage de la date et de l'URL de chacune des version en dessous du lien créé précédemment dans un span. Le format de la date est modifié pour s'adapter au tri ( aaaa/mm/jj à hh:mn ).
  4. Lancement de l'édition de la page, création du tableau triable, mise à jour du tableau entre les balises de commentaire, pop-up de confirmation si mode "normal", publication.
  5. Si mode "auto", renouvellement de l'étape 2.

Remarques

  • A tout moment, un gros bouton rouge permet de recharger la page et ainsi d'arrêter le processus.
  • Lors de l'analyse de la catégorie, s'il y a plusieurs pages à analyser, il peut arriver que le navigateur détecte un script qui ne répond plus, il faut alors lui préciser de le laisser continuer.
  • Script testé avec Firefox uniquement.
  • Script indifférent à l'habillage utilisé

Code JavaScript

  • Durée : environ 10 minutes pour 600 pages [1]