Manuel:Pywikibot/archivebot.py/configuration
archivebot.py est un script d'archivage des pages de discussion. Ce document explique comment mettre en place des pages de discussion sur le wiki pour l'archivage automatique effectué par ce bot. Pour une documentation pour les opérateurs de bots, voir $link. This document explains how to set up discussion pages on-wiki for the automatic archiving done by this bot. For a documentation on how to operate the bot, please see Manuel:Pywikibot/archivebot.py.
comment mettre en place sur une page de discussion
Ce robot ne traite que les pages qui sont explicitement marquées à l'aide de la transclusion d'un modèle de marque, ainsi que les sections archivées pour cause d'inactivité durant une période spécifiée. Un marqueur habituel est $template. Le modèle peut être paramétré par les paramètres décrits plus bas. (la plupart sont optionnels)
A commonly used marker template is {{User:MiszaBot/config|...}}.
The template may have parameters described below.
(Most of them are optional.)
{{TEMPLATE_PAGE
|archive =
|algo =
|counter =
|maxarchivesize =
|minthreadsleft =
|minthreadstoarchive =
|archiveheader =
|key =
}}
For a section to be archived, it must be a level 2 section, marked with ==. It is possible to opt-out some sections: see the explanation below.
Paramètres du modèle
Les significations de ces paramètres sont:
| Paramètre | Description |
|---|---|
archive |
nom de la page à archiver.
Obligatoirement une sous-page de la page courante. Les Variables sont utilisables. |
algo |
indique l'age maximum des threads actifs.
Doit être sous la forme old(délai), avec délai le nombre d'heures ou de jours comme |
counter |
La valeur actuelle du compteur qui pourrait être affecté à la variable. Sera actualisée par le robot. Initialement la valeur est 1.
|
maxarchivesize |
La taille maximale de l'archive avant l'incrémentation du compteur. L'unité peut être donnée après en concaténant les lettres K et M (respectivement Ko et Mo). Par défaut la valeur est 1000M (1000 Mo).
|
minthreadsleft |
Le nombre minimal de fils qui doivent être laissés sur la page. La valeur par défaut est 5.
|
minthreadstoarchive |
Le nombre maximal de fils à archiver en une seule fois. Par défaut 2.
|
archiveheader |
Contenu qui sera placé en entête sur les nouvelles pages d'archives. On peut y placer des variables. Par défaut la valeur est {{talkarchive}}.
|
key |
Une clé secrète qui (si valide) permet l'archivage de pages qui ne sont pas des sous-pages de l'actuelle. |
Variables pour les motifs des noms de page
Dans le paramètre archive du modèle, les variables suivantes peuvent être utilisées.
| Variable | Substituée comme ... |
|---|---|
%(counter)d |
la valeur actuelle du counter
|
%(year)d |
l'année du fil de discussion à archiver |
%(quarter)d |
trimestre de l'année du fil (1-4) |
%(month)d |
mois (de 1 à 12) du fil |
%(month)02d |
two-digit numeric month (01-12) |
%(monthname)s |
Nom anglais du mois |
%(monthnameshort)s |
trois premières lettres du nom du mois |
Comment empêcher l'archivage
Pour prévenir un fil ou une section d'être archivée pour un temps défini, vous pouvez la ou le modifier et insérer une signature avec un horodatage dans le futur. Le robot ne l'archivera pas avant cette date. Assurez vous de bien former la signature, avec le nom de l'utilisateur et la date pour que le robot la reconnaisse.
Le blocage de l'archivage d'un fil peut s'effectuer en utilisant une date d'un futur très lointain, comme par exemple "16:32, 19 janvier 2043 (UTC)".
To not confuse readers, the dummy signature may be written as a comment only with the dummy user name "DoNotArchiveUntil". Other comments will be ignored by the bot.
Vous pourriez vouloir avoir sur votre wiki un modèle substituable pour cet usage. Voir par exemple ce modèle sur Wikipédia en anglais : w:Template:DNAU.
Voir aussi
- w:Help:Archiving a talk page#Automated_archival - ce qui y est indiqué est valable dans un autre wiki.
- w:User:MiszaBot/config