Modèle:Archivage par bot — Wikipédia
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
[modifier le code]L'archivage avec incrément
[modifier le code]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
[modifier le code]{{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
[modifier le code]{{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
[modifier le code]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
[modifier le code]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 :
Les algorithmes peuvent être combinés en les séparant par des virgules, par exemple |
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
[modifier le code]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
[modifier le code]- 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
[modifier le code]Il est possible d'ajouter un bandeau afin d'indiquer l'emplacement des 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.
![]() | 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
[modifier le code]Ce modèle permet l'archivage automatique d'une page de discussion.
Paramètre | Description | Type | État | |
---|---|---|---|---|
Archive | archive | Nom de l'archive où les discussions doivent être déplacées.
| Inconnu | facultatif |
Algorithme | algo | Algorithme d'achivage.
| 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.
| Inconnu | facultatif |
minthreadsleft | minthreadsleft | Le nombre minimum de fils de discussion à laisser dans la page de discussion afin d'éviter le blanchiment.
| Nombre | facultatif |
minthreadstoarchive | minthreadstoarchive | Le nombre minimum de fils de discussion à archiver à la fois.
| Nombre | facultatif |
En-tête archive | archiveheader | Contenu à placer comme en-tête dans les nouvelles pages d'archive.
| 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.