Modèle:Page au hasard/Documentation

Ceci est la page de documentation de Modèle:Page au hasard [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

Fonctions

Ce modèle est destiné à créer dans une page une liste de liens formatés pour être inclus comme modèle de lien au hasard, grâce à l'utilisation du modèle {{rand}} : la page où se trouve le modèle sera incluse par un appel de type :

{{ESPACE_DE_NOMS:TITRE_PAGE|{{rand|1|MAX}}}}

Le paramètre MAX correspond au nombre total d'articles qu'il est nécessaire d'incrémenter manuellement. Un code javascript permet de mettre à jour la sous-page de façon automatisée.

Paramètres

{{{page}}} : Titre de la page à mettre à jour par le script (obligatoire)
{{{catégorie}}} : catégorie ciblée (obligatoire)
{{{miseAjour}}} : paramètre rempli automatiquement lors de la mise à jour.
{{{nbArticles}}} : paramètre rempli automatiquement lors de la mise à jour.

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, de lister toutes les pages puis de créer un modèle de page au hasard dans la page Portail:Colombie/Page au hasard/Liste.

{{Page au hasard
|page=Portail:Colombie/Page au hasard/Liste
|catégorie=Catégorie:Portail:Colombie/Articles liés
}}

Le script effacera tout ce qui se trouve précédemment sur la page et se charge de remettre le modèle.

Mise à jour

Gadget JavaScript

La mise à jour se fait à l'aide d'un code javascript dont le fonctionnement s'apparente à celui d'un bot.

Pour bénéficier du code de mise à jour, ajouter à votre page vector.js (ou autre suivant l'habillage sélectionné dans les préférences) :

obtenir('PageAuHasard');

Remarques

Script testé avec Firefox uniquement.
Script indifférent à l'habillage utilisé

Bot

En plus du code présenté dans la section "Gadget", un Bot (en JavaScript lui aussi) a été développé dans le but de mettre à jour automatiquement toutes les pages contenant ce modèle.

Après le départ de l'utilisateur Dr Brains (d · c · b), le script est maintenu par Prométhée (d · c · b). La liste des pages mises à jour par ProméthéeBot (d · c · b) se trouve sur la page Utilisateur:ProméthéeBot/Liste PageAuHasard.

Voir aussi