Projet:Laboratoire/Espaces de noms/Wikiversité/Aide archives

Une page de Wikiversité.
Sauter à la navigation Sauter à la recherche
Logo indiquant un résumé
En résumé : Ce document explique la notion d'archive dans un environnement MediaWiki, son implémentation au sein des pages de discussion du projet Wikiversité. Vous apprendrez pourquoi archiver, comment archiver, quelles sont les recommandations particulières sur la Wikiversité en matière d’archivage.

Le système MediaWiki garde chaque modification et son historique en mémoire pour chaque page. Il serait inutile de gérer des archives sans un cas particulier, celui des pages de discussions anciennes que nous souhaitons relayer dans une liste pour afficher uniquement les informations courantes.

Dans ce contexte élargi, les pages de discussions désignent principalement les pages de discussion relatives à un processus, Wikiversité:Requêtes import ; Wikiversité:Requêtes aux administrateurs par exemple[1]. Nous publions sur la page Wikiversité:Archives une liste des pages de discussion qui nécessitent un processus d’archivage.

Les informations ci-dessous s’appliquent à toutes les pages de discussion et notamment aux pages de discussion des utilisateurs. Elles sont fondées sur le document publié par Meta-Wiki "système d’archive standard" qui utilise une convention de nommage et deux modèles, pour nous aider à appréhender le processus d’archivage.

Conventions de nommage[modifier le wikicode]

< Page de discussion courante>/Archives/<date>
Meta-wiki recommande de déplacer les fils de discussions dans le "dossier" Archives, cela permet de les isoler et de les gérer plus facilement.

ou

< Page de discussion courante>/<date>
Dans ce cas de figure les pages d’archives restent à leur emplacement initial ; c’est un cas de figure très répandu que nous conservons pour éviter de nombreuses manipulations. Pour les nouvelles procédures appliquez de préférence le premier exemple.
la date doit répondre au format suivant 
aaaa ou aaaa-mm ou aaa-mm-jj

Les trois exemples suivants sont valides :

Page de discussion courante/Archives/2015 (recommandé)
Page de discussion courante/Archives/2015-12
Page de discussion courante/Archives/2015-12-31

Le système utilise deux modèles pour différencier les pages composant le système d'archivage :

  1. Modèle:Archive-index permet de distinguer l’index des pages archivées (optionnel).
  2. Modèle:Archive s’applique au sommet de la page archivée ; affiche un bandeau d’avertissement pour éviter de nouvelles éditions voir {{Archive de discussion}}.

Archivage manuel[modifier le wikicode]

Manuellement, l’opération est laborieuse, il faut créer la page d’archive placer le code suivant à son sommet:

{{ Modèle:Archive }}

enfin ajouter le lien correspondant sur la page d’index :

Page de discussion courante>/Archives

(placer de préférence les nouvelles archives au sommet de la liste c’est à dire dans l’ordre chronologique décroissant)

Exemple:

== Archives ==
# [[../2016]]: Libellé de l’archive | sujet 1 | sujet 2.
Sinon utilisez le format en cours dans la liste.

Archivage automatique[modifier le wikicode]

La bibliothèque Pywikibot met à disposition un robot archivebot capable d’automatiser l’archivage des fils de discussion.

Le schéma suivant montre l’organisation du processus automatique.

Implémentation archivebot.py

Archivebot n’utilise aucun modèle, il s’appuie sur le code suivant que l’utilisateur doit ajouter, sur la page de discussion dont il souhaite archiver les fils de discussion.

{{ Wikiversité:Archives/config | minthreadsleft = 2 | archive = Discussion utilisateur:Youni Verciti/Archives/%(year)d | algo = old(365d) | minthreadstoarchive = 1 }}

Le code ci-dessus établit un lien entre la page de configuration Wikiversité:Archives/config et la page de discussion courante.

Un utilisateur disposant d’un compte bot démarre alors le programme "archivebot" qui interroge les liens sur la page de configuration passée en paramètre.

@bot$> archive.py Wikiversité:Archives/config

Le paramètre archive permet de préciser l’emplacement des pages d’archives pour chaque page de discussion. Les autres paramètres sont détaillés sur MediaWiki, archivebot/setup/fr.

Pour exécuter le logiciel archive bot à intervalle régulier, il faut utiliser cron.


Avertissement :
Archivebot.py ne modifie pas l’index d’archives. L’utilisation d’un modèle capable de lister automatiquement les nouvelles pages d’archives permet de compléter la solution.

Boite d’archives[modifier le wikicode]

Pour compléter la solution archivebot.py nous avons besoin d’afficher automatiquement les liens vers les nouvelles pages d’archives.

Le modèle {{archive box auto}} est capable de détecter les nouvelles archives et d’afficher les liens automatiquement. Le nom des pages doit répondre à certaines conditions qui justifient la convention aaaa.

Catégorie[modifier le wikicode]

(voir Catégorie:Archives).

Voir aussi[modifier le wikicode]

Modèles :

  • Modèle:Process header défini, les paramètres du processus de discussion, affiche un bandeau navigable.
  • Modèle:Archive box propose une barre latérale de navigation à placer sur l’index d’archives, capable d’afficher automatiquement les pages d’archives qui respectent le format aaaa.

Notes[modifier le wikicode]

  1. La salle café est le premier espace concerné par l’archivage, son système d’archive à évolué d’abord quotidien puis hebdomadaire, désormais mensuel ; la convention de nommage des archives de la salle café est sensiblement différente.