Utilisateur:OrlodrimBot/Suivi catégorie
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)[1]. 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[2]), « 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 :
Il est possible d'afficher le nombre d'articles dans la section (variableValeur 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. %(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.
Autres exemples, «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. 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 }}
Notes
- Après deux mises à jour en moins d'une heure sur une même page, la fréquence de mise à jour est cependant limitée à une fois par heure.
- Le bot ne connaît les dates de création que pour les pages de l'espace encyclopédique. Pour les pages de discussion ou tout autre espace de noms, ce mode est équivalent à « ajout ».
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)
La documentation de ce modèle est générée par le modèle {{Documentation}}.
Elle est incluse depuis sa sous-page de documentation. Veuillez placer les catégories sur cette page-là.
Les éditeurs peuvent travailler dans le bac à sable (créer) et la page de test (créer).
Voir les statistiques d'utilisation du modèle sur l'outil wstat.