Utilisateur:OrlodrimBot/Suivi catégorie/Documentation

Utilisation

Ce modèle permet de suivre l'évolution des articles appartenant à une catégorie ou à une combinaison de catégories. La mise à jour est effectuée toutes les cinq minutes par OrlodrimBot (d · c · b). La liste des articles est ajoutée juste après le modèle. Il est possible d'utiliser plusieurs fois le modèle dans la même page.

Limitation : le contenu des sous-catégories n'est pas pris en compte. Seules les pages contenues directement dans les catégories indiquées sont listées.

Syntaxe

{{Utilisateur:OrlodrimBot/Suivi catégorie
 | type            = 
 | catégorie       = 
 | nbMax           = 
 | format date     = 
 | format sections = 
 | format liens    = 
 | filtre1         = 
 | description1    = 
 | ...
}}

Paramètres

type

Le suivi effectué. Les valeurs possibles sont « ajout » (affiche les articles récemment ajoutés à la catégorie, valeur par défaut), « création » (affiche les articles de la catégorie par date de création, du plus récent au plus ancien), « retrait » (affiche les articles supprimés de la catégorie), « changement » (liste combinée des ajouts et des retraits), « liste alphabétique » (affichage de tous les articles triés par nom).

catégorie

Une catégorie sous forme de lien ou une combinaison de catégories. Par exemple « [[Catégorie:Wiki]] » ou « [[Catégorie:Page proposée au débat d'admissibilité]] inter [[Catégorie:Portail:Cinéma/Articles liés]] » (pour suivre l'intersection des deux catégories). La syntaxe complète est donnée ci-dessous.

nbMax

Nombre maximum d'articles dans la liste. Ce paramètre n'est pris en compte que si le type est « ajout », « création », « retrait » ou « changement ». Dans ce cas, sa valeur par défaut est 10. Si le type est « liste alphabétique », nbMax est ignoré et tous les articles sont affichés (il existe cependant une limite globale de 5000 articles par page, toutes listes confondues).

date min

date max

Afficher uniquement les articles plus récents ou plus anciens que cette date (uniquement lorsque le type est « ajout », « retrait » ou « changement »). La date doit être au format jour mois année, par exemple « date min = 23 mars 2001 ».

filtreN

descriptionN

Le champ filtreN, pour N compris entre 1 et 20, peut contenir une combinaison de catégories suivant le même format que pour le champ catégorie. Les articles correspondant à ce filtre sont signalés par une mention entre parenthèses (la mention est fixée par le champ descriptionN).

transclusion

Si ce paramètre est présent, les premiers articles de la liste sont placés dans une balise <onlyinclude>, afin qu'il soit possible d'insérer seulement un extrait de la liste par transclusion dans une autre page. La valeur du paramètre est le nombre d'articles à mettre dans <onlyinclude> (par exemple, « transclusion = 20 » pour afficher les 20 premiers articles lors de la transclusion de la page).

id

Identifiant à utiliser dans le commentaire de diff pour indiquer dans quel modèle le changement a eu lieu, lorsque la page contient plusieurs modèles de suivi (par défaut, le numéro du modèle dans la page est utilisé).

format date

Si la valeur est « jour », la date d'ajout ou de retrait est affichée entre parenthèses pour chaque article. Le format de {{Articles récents}} (celui de strftime) est également géré en grande partie.

format sections

Format des titres de section. Exemples :

Valeur	Type	Effet
== %(mois) %(année) ==	ajout, retrait, changement	Crée une section par mois, dont le titre indique le mois et l'année.
== %(année) ==, === %(mois) ===	ajout, retrait, changement	Crée des sections de niveau 2 par année et des sous-sections de niveau 3 par mois.
=== %(lettre) ===	liste alphabétique	Crée des sections de niveau 3 pour les listes alphabétiques (au lieu de 2 par défaut).
-	liste alphabétique	Désactive les sections.

Il est possible d'afficher le nombre d'articles dans la section (variable %(total_section)) ou le nombre d'articles dans la section qui correspondent au filtre numéro N (variable %(total_filtreN)).

format liens

Permet de personnaliser le format des liens. Par exemple, « format liens = # [[%(page)]] » produit une liste numérotée plutôt qu'une liste à puces.

Variables disponibles

Variable	Description
%(page)	Titre de page
%(date)	Date de l'ajout ou du retrait de la page
%(retrait)	Vaut « 1 » lorsque l'article est retiré, est vide sinon (à utiliser uniquement si le type est « changement »)
%(index)	Numéro de l'article dans la section
%(total_section)	Nombre total d'articles dans la section
%(filtreN)	Égal à la description du filtre N si l'article y correspond, vide sinon.

Autres exemples, « format liens = * {{Article simple|%(page)}} (%(date)) » produit une liste à puces avec discussion et date.

« format liens = {{Article simple|%(page)|puce=#}} (%(date)) (sans "#" ni "*" avant le modèle) produit une liste numérotée avec discussion historique et date de dernière mise à jour

texte si vide

Texte affiché si la liste ne contient aucune page.

Combinaisons de catégories

Opérateurs

Dans les champs catégorie et filtreN, les catégories peuvent être combinées avec les opérations « inter » (C1 inter C2 = articles à la fois dans C1 et C2), « union » (C1 union C2 = articles dans C1 ou dans C2), « moins » (C1 moins C2 = articles dans C1 mais pas dans C2).

Il est possible de faire des opérations plus complexes en utilisant des parenthèses. Par exemple :

([[Catégorie:Tous les articles dont l'admissibilité est à vérifier]] union [[Catégorie:Page proposée au débat d'admissibilité]]) inter ([[Catégorie:Portail:Cinéma/Articles liés]] union [[Catégorie:Portail:Théâtre/Articles liés]])

correspond au pages des portails du théâtre et du cinéma qui ont soit un bandeau {{Admissibilité}}, soit un bandeau {{Suppression}}.

Les catégories peuvent être croisées avec un espace de noms nsNuméro, où le numéro peut être trouvé sur Aide:Espace de noms. Par exemple, [[Catégorie:Page avec des liens de fichiers brisés]] inter ns0 renvoie les pages avec des liens de fichiers brisés dans l'espace principal uniquement.

Fonctions

Certaines catégories sont apposées sur les pages de discussion ou des sous-pages de la page de discussion. Pour permettre le croisement avec des catégories de l'espace encyclopédique, trois fonctions sont disponibles :

• article() : transforme les pages de discussion en articles. Par exemple, si Catégorie:Article du projet Espagne d'importance faible contient « Discussion:Aéroport de Séville » et « Discussion:Aéroport de Valence », article([[Catégorie:Article espagnol d'importance faible]]) donnera la liste « Aéroport de Séville, Aéroport de Valence ». Les pages de la catégorie qui ne sont pas des pages de discussion sont conservées telles quelles.
• discussion() : transforme les articles en pages de discussion, c'est-à-dire l'opération inverse de article().
• base() : calcule les pages principales à partir de sous-pages. Par exemple, article(base([[Catégorie:Wikipédia:Archives PàS]])) donne la liste des articles qui ont été un jour proposé à la suppression, qu'ils existent encore ou non (les pages utilisant base() ne sont mises à jour qu'une fois par jour).

Archivage

Il est possible de combiner ce modèle avec {{Archivage par bot}} pour que les anciens articles soient déplacés vers une page d'archive. Pour que cela fonctionne :

• {{Archivage par bot}} doit être placé avant ce modèle.
• L'archivage se fait toujours sur les sections de niveau 2 (« == »). Ainsi, le paramètre « format section » de ce modèle doit être rempli et les sections principales doivent être de niveau 2 (« == »). Il ne faut pas ajouter de contenu avant ou après la date dans ces sections (utiliser uniquement les formats « %(jour) %(mois) %(année) », « %(mois) %(année) » ou « %(année) »). Par exemple, « == %(mois) %(année) == » ou « == %(année) ==, === %(mois) === » peuvent fonctionner, mais pas « === %(mois) %(année) === », qui ne génère aucune section de niveau 2.
• Les articles doivent être classés par date (le paramètre « type » ne doit pas être égal à « liste alphabétique »).
• {{Archivage par bot}} doit être utilisé avec l'algorithme spécial « oldtitle ». Par exemple, {{Archivage par bot|algo=oldtitle(3d)|archive=/%(year)d}} archive les sections couvrant une période terminée depuis au moins 3 jours (par exemple, la section « août 2010 » sera archivée à partir du 3 septembre 2010).

Pour un exemple, voir Projet:Cinéma/Articles récents.

Exemples

Ajouts récents sur Catégorie:Page proposée au débat d'admissibilité :

{{Utilisateur:OrlodrimBot/Suivi catégorie
| type         = ajout 
| catégorie    = [[Catégorie:Page proposée au débat d'admissibilité]]
}}

Liste des pages à supprimer du portail Sciences humaines et sociales, triée par date (voir) :

{{Utilisateur:OrlodrimBot/Suivi catégorie
| type         = ajout 
| catégorie    = [[Catégorie:Page proposée au débat d'admissibilité]] inter [[Catégorie:Portail:Sciences humaines et sociales/Articles liés]]
| nbMax        = 200
| format date   = jour
}}

Liste des pages à supprimer ou dont l'admissibilité est à vérifier pour le portail Musique classique (voir) :

{{Utilisateur:OrlodrimBot/Suivi catégorie
| type         = ajout
| catégorie    = [[Catégorie:Portail:Musique classique/Articles liés]] inter ([[Catégorie:Tous les articles dont l'admissibilité est à vérifier]] union [[Catégorie:Page proposée au débat d'admissibilité]])
| nbMax        = 500
| format date  = jour
| filtre1      = [[Catégorie:Page proposée au débat d'admissibilité]]
| description1 = en PàS
}}

Archive de la liste précédente (voir) :

{{Utilisateur:OrlodrimBot/Suivi catégorie
| type         = retrait
| catégorie    = [[Catégorie:Portail:Musique classique/Articles liés]] inter ([[Catégorie:Tous les articles dont l'admissibilité est à vérifier]] union [[Catégorie:Page proposée au débat d'admissibilité]])
| nbMax        = 500
| format date  = jour
}}

Tableau des articles orphelins du portail Cinéma, avec une colonne indiquant s'ils ont un bandeau d'admissibilité (voir) :

{|class='wikitable sortable'
!Titre!!Bandeau admissible
{{User:OrlodrimBot/Suivi catégorie
|catégorie = [[Catégorie:Portail:Cinéma/Articles liés]] inter [[Catégorie:Article orphelin/Liste complète]]
|filtre1 = [[Catégorie:Tous les articles dont l'admissibilité est à vérifier]]
|description1 = Oui
|type=liste alphabétique
|format sections=-
|format liens = {{!}}-
{{!}} [[%(page)]] {{!}}{{!}} %(filtre1)
|nbMax = 5000
}}
{{Utilisateur:OrlodrimBot/Suivi catégorie/fin}}
|}

Liste des articles du portail Sciences de l'information et des bibliothèques, classée par année et par mois, en affichant tous les articles du mois sur une seule ligne (voir) :

{{Utilisateur:OrlodrimBot/Suivi catégorie
| type = ajout
| catégorie = Catégorie:Portail:Sciences de l'information et des bibliothèques/Articles liés
| nbMax = 5000
| format liens = {{#ifeq:%(index)|%(total_section)|[[%(page)]].|[[%(page)]] ;}}
| format sections = == %(année) ==,=== %(mois) ===
| transclusion = 200
}}

Voir aussi

• {{Articles récents}} (fonction similaire, peut descendre dans les sous-catégories mais ne gère pas les combinaisons de catégories)
• {{Requête petscan}} (fonction similaire, peut descendre dans les sous-catégories, liste mise à jour une fois par jour)
• {{Utilisateur:OrlodrimBot/Suivi fusions}} (pour le suivi des pages à fusionner, regroupe sur une même ligne les pages à fusionner les unes avec les autres)
• {{Archivage par bot}} (peut archiver le contenu généré par ce modèle)