Modèle:Archivage par bot

Documentation[voir] [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

L'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.

L'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).

L'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 = 
}}

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. Trois formats sont acceptés : `old(...)` où ... signifie l'âge maximum en jours (d) (5d, 21d, etc.). Dans ce cas les fils de discussion sont archivés sans condition après le délai indiqué. `checked+old(...)` où ... signifie l'âge maximum en jours. Seuls les fils de discussion dont le titre contient l'un des modèles {{Fait}}, {{Pas fait}}, {{Oui}}, {{Non}}, {{Croix3}} ou {{Déplacé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(...)` où ... signifie l'âge maximum en jours. 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(...)` où ... signifie l'âge maximum en jours. Efface sans archiver les messages après le délai indiqué. `erasenewsletters(...)` où ... signifie l'âge maximum en jours. Efface sans archiver les messages distribués par MediaWiki message delivery correspondant à une liste de publications périodiques connues. 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.
`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}}

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

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.