Modèle:Archivage par bot — Wikipédia

 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[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 :

  1. dans la page, avant le premier == Deuxième niveau ==
  2. 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 :
  • old(...)... 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(...)... 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(...)... 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(...)... signifie l'âge maximum en jours. Efface sans archiver les messages après le délai indiqué.
  • erasenewsletters(...)... 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[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è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ètreDescriptionTypeÉtat
Archivearchive

Nom de l'archive où les discussions doivent être déplacées.

Exemple
/Archive %(counter)d
Inconnufacultatif
Algorithmealgo

Algorithme d'achivage.

Exemple
old(15d)
Inconnusuggéré
Numéro de l'archivecounter

Numéro de la page d'archive actuelle.

Nombrefacultatif
Taille max archivemaxarchivesize

La taille que doit atteindre une page d'archive avant de passer à la suivante.

Par défaut
250K
Inconnufacultatif
minthreadsleftminthreadsleft

Le nombre minimum de fils de discussion à laisser dans la page de discussion afin d'éviter le blanchiment.

Par défaut
5
Nombrefacultatif
minthreadstoarchiveminthreadstoarchive

Le nombre minimum de fils de discussion à archiver à la fois.

Par défaut
2
Nombrefacultatif
En-tête archivearchiveheader

Contenu à placer comme en-tête dans les nouvelles pages d'archive.

Par défaut
{{Archive de discussion}}
Contenufacultatif