Modèle:Archivage par bot

Documentationvoir modifier historique purger

Ce modèle permet l'archivage automatique d'une page de discussion. Les sections dont le contenu n'a pas été modifié depuis plus de n jours sont déplacées vers des sous-pages d'archive par un bot. Actuellement, cette tâche est accomplie par OrlodrimBot (d · c · b) une fois par jour, vers 23 h.

L'inclusion de ce modèle n'a aucun effet visible. Il existe d'autres modèles pour signaler que l'archivage automatique est en place ou afficher des liens vers les pages d'archives (voir #Modèles complémentaires).

Exemples

Archivage avec incrément

Insérez le modèle suivant au début de la page de discussion :

{{Archivage par bot
 | algo           = old(15d)
 | archive        = /Archive %(counter)d
 | maxarchivesize = 250K
 | counter        = 
}}

Effet : si le modèle est placé sur Discussion utilisateur:Exemple, les discussions non modifiées depuis 15 jours seront archivées vers Discussion utilisateur:Exemple/Archive 1. Lorsque cette archive dépassera 250 Ko, le bot passera à Discussion:Exemple/Archive 2, puis Discussion:Exemple/Archive 3, etc. Le bot ne s'activera que s'il y a au moins deux sections à archiver et laissera toujours au moins cinq sections.

S'il existe déjà des pages d'archives numérotées avant la mise en place de l'archivage automatique, le bot détermine automatiquement la valeur du compteur pour que l'archivage commence sur la dernière page.

Archivage statique

{{Archivage par bot
 | algo    = old(7d)
 | archive = /Archive
}}

Si le modèle est installé dans la page de discussion de l'utilisateur par exemple, le bot archivera les fils de discussions de Discussion utilisateur:unexemple vers Discussion utilisateur:unexemple/Archive tous les sept jours (à partir de la dernière intervention). À moins de modifier manuellement le paramètre archive, l'archive augmentera jusqu'à saturation (la taille des pages est limitée à 2 mégaoctets).

Archivage basé sur la date

{{Archivage par bot
 | algo    = old(5d)
 | archive = /Archives/%(year)d/%(monthname)s
}}

Avec ces options, le bot transférera les fils de discussion plus vieux de 5 jours dans l'archive correspondant à la date du dernier message du fil.

Syntaxe complète

Vous devez inclure le modèle :

dans la page, avant le premier == Deuxième niveau ==
directement dans la page de discussion, il ne doit pas être importé d'un autre modèle.

{{Archivage par bot
 | archive             = 
 | algo                = 
 | counter             = 
 | maxarchivesize      = 
 | minthreadsleft      = 
 | minthreadstoarchive = 
 | archiveheader       = 
 | archivefooter       = 
}}

Paramètres

paramètre	signification
`archive`	Nom de l'archive où les discussions doivent être déplacées. Si le nom commence par `/`, le bot considère qu'il s'agit du nom d'une sous-page. On peut utiliser des variables afin de créer des noms d'archives dynamiques.
`algo`	Algorithme d'achivage. Plusieurs formats sont acceptés : `old(délai)` où délai est un nombre de jours suivi de la lettre `d` (comme day). Exemple : `old(21d)`. Dans ce cas les fils de discussion sont archivés sans condition après le délai indiqué. `checked+old(délai)`. Seuls les fils de discussion dont le titre contient l'un des modèles {{Fait}}, {{Pas fait}}, {{Oui}}, {{Non}}, {{Croix3}} ou {{Déplacée}} ou le texte « (Traitée) » sont archivés après le délai indiqué (ce mécanisme est principalement destiné aux pages de requêtes telles que Projet:Infobox/Demandes). `FdN(délai)`. Seuls les fils de discussion contenant {{Réponse FdN\|oui}}, {{Réponse FdN\|attente}}, {{Réponse FdN\|encours}} ou l'un des modèles listés sur Utilisateur:OrlodrimBot/Modèles de réponse sont archivés après le délai indiqué. `eraseold(délai)`. Efface sans archiver les messages après le délai indiqué. `erasenewsletters(délai)`. Efface sans archiver les messages distribués par MediaWiki message delivery correspondant à une liste de publications périodiques connues. `DdA(délai)`. Archive les annonces de débat d'admissibilité après le délai indiqué (seules les annonces sans réponse sont concernées). `eraseDdA(délai)`. Variante de `DdA` qui efface les annonces au lieu de les archiver. `anecdotes(délai)`. Archive les annonces de proposition d'anecdote sur la page d'accueil après le délai indiqué (seules les annonces sans réponse sont concernées). `eraseAnecdotes(délai)`. Variante de `anecdotes` qui efface les annonces au lieu de les archiver. Les algorithmes peuvent être combinés en les séparant par des virgules, par exemple `erasenewsletters(7d),old(7d)` efface les newsletters après 7 jours et archive les autres messages. Autre exemple pour archiver rapidement les débats d'admissibilité et les anecdotes sur la page d'un projet tout en laissant les autres messages visibles plus longtemps : `eraseDdA(14d),anecdotes(14d),old(90d)`.
`counter`	La valeur actuelle du compteur. Si l'option `%(counter)d` n'est pas utilisée, la valeur est ignorée. Le bot la mettra à jour si nécessaire.
`maxarchivesize`	La grosseur maximum de l'archive avant l'incrément du compteur. Si l'option du compteur n'est pas utilisée, celle-ci est ignorée. Les valeurs utilisées doivent être de la forme #K (K en majuscule). Par exemple : `maxarchivesize=250K`.
`minthreadsleft`	Le nombre minimum de fils de discussion à laisser dans la page de discussion afin d'éviter le blanchiment. Par défaut, cette valeur est fixée à 5.
`minthreadstoarchive`	Le nombre minimum de fils de discussion à archiver à la fois. Cette option est utilisée pour diminuer la fréquence d'intervention. Le bot n'archivera pas les fils de discussion, si leurs nombres sont inférieurs à la valeur de ce paramètre. Par défaut, la valeur est fixée à 2.
`archiveheader`	Contenu à placer comme entête dans les nouvelles pages d'archive. Par défaut, la valeur est fixée à {{Archive de discussion}}. Modifier ce paramètre n'affecte pas la présentation des pages d'archive qui existent déjà.
`archivefooter`	Contenu à placer comme pied de page dans les nouvelles pages d'archive. Si non vide, ce contenu sera précédé d'un commentaire permettant au bot de séparer le pied de page de la dernière section et de le garder à la fin quand de nouvelles sections sont archivées. Modifier ce paramètre n'affecte pas la présentation des pages d'archive qui existent déjà.

Variables

variable...	explication
`%(counter)d`	la valeur actuelle du compteur `counter`
`%(year)d`	année du fil archivé
`%(quarter)d`	trimestre (nombre de 1 à 4) du fil archivé
`%(month)d`	mois (nombre de 1 à 12) du fil archivé
`%(monthname)s`	Nom du mois
`%(monthnameshort)s`	trois premières lettres du mois

Limitations techniques

Le bot archive les sections de niveau 2 (c'est-à-dire de la forme « == Titre == »). Les sections de niveau 1 (« = Titre = ») ne sont jamais archivées. Les sections de niveau 3 (« === Titre === ») situées avant la première section de niveau 2 non plus. Si une boîte déroulante s'étend sur plusieurs sections, elle peut être cassée lors de l'archivage.
%(counter)d est incompatible avec les autres paramètres (par exemple, « /%(year)d/%(counter)d » n'est pas une page d'archive valide).
L'archivage ne fonctionne que si la page d'archive est une sous-page de la page archivée (si vous avez une bonne raison de vouloir faire autrement, contactez Orlodrim (d · c · b))
L'archivage ne fonctionne pas si la page archivée est une sous-page dont le titre contient "Archive". Le but de cette restriction est d'éviter des problèmes si le modèle d'archivage est déplacé par erreur vers la page d'archive.

Modèles complémentaires

Il est possible d'ajouter un bandeau afin d'indiquer l'emplacement des archives.

Archives

Si vous utilisez la méthode avec incrément (/Archive 1, /Archive 2, etc.), le bandeau {{Archives auto}} repérera automatiquement ces pages pour les afficher.

Il est également possible d'informer par un bandeau que la page est automatiquement archivée.

{{Archive bot}}

Cette page est automatiquement archivée par OrlodrimBot. Les sections n'ayant aucune activité depuis 7 jours sont automatiquement déplacées.

Pour qu'une section ne soit jamais archivée, placez-y le modèle {{Ne pas archiver}}.

Ce modèle peut archiver les sections produites par {{Utilisateur:OrlodrimBot/Suivi catégorie}} (voir la documentation de l'autre modèle pour les détails).

Templatadata

Ce modèle permet l'archivage automatique d'une page de discussion.

Paramètres du modèle[Modifier les données du modèle]
La mise en forme multiligne est préférée pour ce modèle.
Paramètre		Description	Type	État
Archive	`archive`	Nom de l'archive où les discussions doivent être déplacées. Exemple /Archive %(counter)d	Inconnu	facultatif
Algorithme	`algo`	Algorithme d'achivage. Exemple old(15d)	Inconnu	suggéré
Numéro de l'archive	`counter`	Numéro de la page d'archive actuelle.	Nombre	facultatif
Taille max archive	`maxarchivesize`	La taille que doit atteindre une page d'archive avant de passer à la suivante. Par défaut 250K	Inconnu	facultatif
minthreadsleft	`minthreadsleft`	Le nombre minimum de fils de discussion à laisser dans la page de discussion afin d'éviter le blanchiment. Par défaut 5	Nombre	facultatif
minthreadstoarchive	`minthreadstoarchive`	Le nombre minimum de fils de discussion à archiver à la fois. Par défaut 2	Nombre	facultatif
En-tête archive	`archiveheader`	Contenu à placer comme en-tête dans les nouvelles pages d'archive. Par défaut {{Archive de discussion}}	Contenu	facultatif
Pied de page archive	`archivefooter`	Contenu à placer comme pied de page dans les nouvelles pages d'archive. Par défaut {{Archive de discussion}}	Contenu	facultatif

Questions fréquentes

Pourquoi le bot n'archive-t-il rien ?: La raison la plus fréquente est qu'il n'y a pas beaucoup de sections sur la page. Par défaut, le paramètre minthreadsleft vaut 5 et le paramètre minthreadstoarchive vaut 2, donc le bot ne se déclenche que s'il y a au moins 7 sections sur la page dont 2 sont suffisamment anciennes pour être archivées. Si vous voulez archiver plus vite, définissez une valeur plus faible pour ces paramètres.
Comment définir counter quand des pages d'archives existent déjà au moment de l'ajout du modèle ?: En général, il n'est pas nécessaire d'ajouter manuellement le paramètre counter. En son absence, le bot est capable de trouver la dernière page d'archive existante. Le paramètre sert seulement à accélérer le processus les fois suivantes.

Voir aussi

Aide:Archivage
Catégorie:Wikipédia:Archives
{{Archives}} : affiche une boîte avec une zone de saisie permettant de faire des recherches dans les archives, et éventuellement une liste des sous-pages.
{{ArchivesLua}} : affiche une boîte semblable au modèle Archives qui génère automatiquement des liens vers les sous-pages d'archive selon différents paramètres.
{{Archives auto}} : affiche une boîte semblable au modèle Archives qui génère automatiquement des liens vers les sous-pages d'archive à condition qu'elles soient nommées de façon standard.
{{Archives sous-pages}} : affiche un lien vers une sous-page d'archive si celle-ci existe (à utiliser dans un modèle Archive).
{{Archives par diff}} : pour archiver selon la méthode du diff.
{{Archivage par bot}} : pour demander à un bot d'archiver automatiquement la page.
{{Archive de discussion}} : bandeau indiquant qu'il s'agit d'une page d'archives.
{{Page méta archivée}} : bandeau pour les pages d'archives hors de l'espace encyclopédique.

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.