« Aide:Archive » : différence entre les versions

Contenu supprimé Contenu ajouté
Les discussions utilisateurs ne sont pas liées à un processus formel
Ligne 1 :
{{En résumé | Ce document explique la notion d''''archive''' dans un environnement MediaWiki, et son implémentation au sein des pages de discussion du projet Wikiversité. Vous apprendrez pourquoi archiver, commentconformément archiver,à quellesla sontprise lesde recommandations particulières sur ladécision [[Projet:Wikiversité/Modèles en matière d’archivaged'archivage]].}}
{{en travaux|JackPotte}}
{{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.
 
Les pages de discussions désignent aussi bien les demandes telles que [[Wikiversité:Requêtes aux administrateurs]], les échanges comme [[Wikiversité:La salle café]], ou encore les pages de discussion des utilisateurs.
{{attention}} Il doit être réécrit en conformité avec [[Projet:Wikiversité/Modèles d'archivage]].}}
 
Afin d'éviter de parcourir de très longues pages, les discussions peuvent être séparées dans des sous-pages, par années ou pas mois selon les volumes produis.
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.
 
Pour ne pas avoir à déplacer ces écrits, il convient de les poster directement dans les sous-pages. Pour faciliter ce processus, un lien "Effectuer une requête" pointant vers la bonne sous-page, est placé dans en-tête de discussion. Par exemple sur [[Wikiversité:Requêtes aux bots]], ce lien permet automatiquement en 2016 de poster dans [[Wikiversité:Requêtes aux bots/2016]].
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 <ref>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.</ref>.
Nous publions sur la page [[Wikiversité:Archives]] une liste des pages de discussion qui nécessitent un processus d’archivage.
 
De plus, l'historique des sous-pages est automatiquement affichée via {{m|archives}}.
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 "[[m:Archive/fr |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 ==
: <code>< Page de discussion courante>/Archives/<date></code>
: 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
: <code>< Page de discussion courante>/<date></code>
: 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 :
: <code> '''aaaa''' </code> ou <code> aaaa-mm</code> ou <code> aaa-mm-jj </code>
Les trois exemples suivants sont valides :
: <code>Page de discussion courante/Archives/'''2015'''</code> (recommandé)
: <code>Page de discussion courante/Archives/2015-12</code>
: <code>Page de discussion courante/Archives/2015-12-31</code>
Le système utilise deux modèles pour différencier les pages composant le système d'archivage :
# [[Modèle:Archive-index]] permet de distinguer l’index des pages archivées (optionnel).
# [[Modèle:Archive]] s’applique au sommet de la page archivée ; affiche un bandeau d’avertissement pour éviter de nouvelles éditions voir {{m|Archive}}.
 
== Archivage manuel ==
Manuellement, l’opération est laborieuse, il faut créer la page d’archive placer le code suivant à son sommet:
: <code><nowiki>{{ Modèle:Archive }}</nowiki></code>
enfin ajouter le lien correspondant sur la page d’index :
: <code>Page de discussion courante>/Archives</code>
(placer de préférence les nouvelles archives au sommet de la liste c’est à dire dans l’ordre chronologique décroissant)
 
Exemple:
== Archives ==
# <nowiki>[[../2016]]</nowiki>: Libellé de l’archive | sujet 1 | sujet 2.
<small>Sinon utilisez le format en cours dans la liste.</small>
 
== Archivage automatique ==
La bibliothèque Pywikibot met à disposition un robot [[mw:Manual:Pywikibot/archivebot.py/fr |archivebot]] capable d’automatiser l’archivage des fils de discussion.
 
Le schéma suivant montre l’organisation du processus automatique.
[[File:Archivebot.png|thumb|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.
 
<code><nowiki>{{ Wikiversité:Archives/config
| minthreadsleft = 2
| archive = Discussion utilisateur:Youni Verciti/Archives/%(year)d
| algo = old(365d)
| minthreadstoarchive = 1
}}
</nowiki></code>
 
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.
 
<code>@bot$> archive.py Wikiversité:Archives/config</code>
 
Le paramètre <code>archive</code> 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, [[mw:Manual:Pywikibot/archivebot.py/setup/fr | archivebot/setup/fr]].
 
Pour exécuter le logiciel archive bot à intervalle régulier, il faut utiliser [[mw:Toolserver:Cron |cron]].
 
{{Note |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 ==
Pour compléter la solution archivebot.py nous avons besoin d’afficher automatiquement les liens vers les nouvelles pages d’archives.
 
Le modèle {{m|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 ==
(voir [[:Catégorie:Archives]]).
 
== Voir aussi ==
* [[Wikiversité:Archives]] pour les conventions de nommage des archives
* [[:Catégorie:Archives]] pour la liste des pages archivées
* [[m:Archive/fr |Archive sur Meta-Wiki]]
* [[w:en:Help:Archiving a talk page |Wikipedia Archiving a talk page]]
Modèles :
* [[Modèle:Process header]] défini, les paramètres du processus de discussion, affiche un bandeau navigable.
* [[Modèle:Archive box auto]] 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 ==
 
[[Catégorie:Archives|*]]