Modèle:Articles récents/Documentation

Ceci est la page de documentation de Modèle:Articles récents [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 une liste avec les pages récemment ajoutées à une catégorie (typiquement Portail:TRUC/Articles liés, mais cela peut être n'importe quelle catégorie). Le modèle par défaut permet un cadre défilant afin de faciliter l'insertion dans un cadre de portail ou de projet, ou bien dans l'en-tête d'une catégorie.

Un bot, ZéroBot, met à jour le tableau de façon automatisée.

Paramètres

{{{catégorie}}} : Catégorie à vérifier (généralement catégorie:Portail:TRUC/Articles liés) (obligatoire)
{{{nbMax}}} : Nombre maximum de pages dans la liste des articles récents (facultatif, 10 pages par défaut)
{{{defilant}}} : Mettre
non
pour annuler le cadre défilant (facultatif).
{{{hauteur}}} : Hauteur du cadre défilant créé en pixels, sans l'unité
px
(facultatif : 250 par défaut)
{{{listeRecents}}} : Liste des articles récents, mise à jour automatiquement
{{{align}}} : Alignement (left, center ou right) de la liste des articles récents (facultatif : center par défaut)
{{{namespaces}}} : Espaces de noms des articles récents, sous forme des nombres associés aux espaces de noms désirés, séparés par des virgules (« , ») (facultatif, 0 par défaut : espace de nom principal)
exemple : « |namespaces = 0,10 » (le bot ne prendra alors en compte que les pages de l'espace principal et de l'espace modèle lors de la recherche des articles récents)
{{{recurse}}} : Indiquer oui si le bot doit vérifier les sous-catégories (et ce, de manière récursive) de la catégorie indiquée (facultatif, non par défaut)
{{{delai}}} : Délai (en heures) imposé depuis la création : l'article ne sera ajouté à la liste que si sa création remonte à moins de x heures. Indiquer 0 pour ignorer ce délai (tous les articles récemment ajoutés à la catégorie indiquée seront alors pris en compte, quelle que soit la date de création) ou -1 pour que le bot ne prenne en compte que les articles créés depuis la dernière mise à jour de la liste. (facultatif, 0 par défaut)
exemple : « |delai = -1 » (le bot ne prendra alors en compte que les articles créés depuis la dernière mise à jour de la liste)
{{{date}}} : Ajout de la date à laquelle l'article a été ajouté à la catégorie. Remplir avec le format voulu (ou laisser vide pour ne pas avoir de date) ; les possibilités sont détaillées sur une page de la documentation python.
exemple 1 : « |date = %d/%m/%y » renverra une date de la forme "09/10/15"

exemple 2 : « |date = %d %B » renverra une date de la forme "09 octobre"

exemple 3 : « |date = %-d %B » renverra une date de la forme "9 octobre" sans le zéro devant
{{{puces}}} : Puces utilisées par le bot (# par défaut)
exemple : « |puces = * » (la liste créée sera dépourvue de numérotation)

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, puis d'apposer (ou mettre à jour) la liste des derniers articles sur la page Portail:Colombie/Suivi/Articles récents.

<noinclude>
{{Articles récents
 | catégorie    = Catégorie:Portail:Colombie/Articles liés
 | défilant     = non
 | hauteur      =
 | nbMax        = 10
 | delai        = 0
 | date         = %d %B <!-- mettre à vide pour ne pas avoir de date -->
 | listeRecents =
</noinclude>
<!-- Ce tableau est créé automatiquement par un robot. Articles Récents DEBUT -->
<!-- Ce tableau est créé automatiquement par un robot. Articles Récents FIN -->
<noinclude>}}</noinclude>

Les commentaires sont importants car ce sont eux que le script recherche pour détecter le début et la fin des listes lors de leur mise à jour.

Voir aussi