Help:Export/fr

Les pages Wiki peuvent être exportées dans un format spécial XML vers télécharger l'import dans une autre installation MediaWiki (si cette fonction est activée sur le wiki de destination, et que l'utilisateur est un sysop) ou l'utiliser autrement pour en analyser le contenu. Voir aussi m:Flux de syndication pour exporter d'autres informations sauf les pages et lors de l'importation de pages.



Comment exporter
Il y a au moins quatre manières d'exporter les pages :


 * Collez le nom des articles dans la boîte dans Special:Export ou utilisez.
 * Le script de sauvegarde  enregistre toutes les pages du wiki dans un fichier XML.   ne fonctionne que sur MediaWiki 1.5 ou plus récent. Vous devez avoir un accès direct au serveur pour exécuter ce script. Les vidages des projets Wikimédia sont régulièrement disponibles sur https://dumps.wikimedia.org/.
 * Remarque: vous devrez peut-être configurer AdminSettings.php pour exécuter dumpBackup.php avec succès. Voir m:MediaWiki pour plus d'informations.
 * Il existe une interface OAI-PMH pour récupérer régulièrement les pages qui ont été modifiées depuis un certain temps. Pour les projets Wikimedia, cette interface n'est pas accessible au public. voir . OAI-PMH contient un format d'emballage autour des articles actuellement exportés.
 * Utilisez l'environnement Pywikibot. Cela ne sera pas expliqué ici.

Par défaut, seule la version actuelle d'une page est incluse. En option, vous pouvez obtenir toutes les versions avec la date, l'heure, le nom d'utilisateur et le résumé d'édition. En option, la dernière version de tous les modèles appelés directement ou indirectement est également exportée.

De plus, vous pouvez copier la base de données SQL. C'est ainsi que les vidages de la base de données ont été rendus disponibles avant MediaWiki 1.5 et cela ne sera pas davantage expliqué ici.



Utilisation de 'Special:Export'
Pour exporter toutes les pages d'un espace de noms, par exemple.



Obtenir les noms des pages à exporter
Je pense qu'un exemple est meilleur parce que la description ci-dessous est assez floue.


 * 1) Allez dans Special:Allpages et choisissez l'article/fichier désiré.
 * 2) Copiez la liste des noms des pages dans un éditeur de texte
 * 3) Placez le nom de chaque page sur une ligne séparée
 * 4) Vous pouvez réaliser cela assez rapidement si vous copiez la partie de la page rendue avec les noms souhaités, et la collez dans un fichier du type MS Word - utilisez le collage spécial comme texte non formaté - puis ouvrez la fonction de remplacement (CTRL + h), en entrant ^t dans Rechercher, entrez ^p dans Remplacer par, puis appuyez sur le bouton Remplacer tout. (Cela dépend des onglets entre les noms de pages ; ceux-ci sont généralement le résultat du fait que les noms de pages sont à l'intérieur de td-tags dans la source html.)
 * 5) L'éditeur de texte Vim permet également de corriger rapidement les sauts de ligne : après avoir collé toute la liste, exécutez la commande :1,$s/\t/\r/g pour remplacer tous les tabs par des retours chariot puis :1,$s/^\n//g pour supprimer chaque ligne contenant uniquement un caractère de nouvelle ligne.
 * 6) Une autre approche consiste à copier le texte formaté dans n'importe quel éditeur affichant le HTML. Retirez toutes les balises  et  en remplaçant tous les  par des balises   et les  par  . Le code html sera ensuite analysé dans le format requis.
 * 7) Si vous avez un accès shell et mysql à votre serveur, vous pouvez utiliser ce script :

mysql -umike -pmikespassword -hlocalhost wikidbname select page_title from wiki_page where page_namespace=0 EOF

Remarque, remplacez mike et mikespassword'' par les vôtres. En outre, cet exemple montre les tables avec le préfixe wiki_''


 * 1) Préfixez les noms des pages avec l'espace de noms (par exemple, 'Help:Contenu'), sauf si l'espace de noms sélectionné est l'espace de noms principal.
 * 2) Répétez les étapes ci-dessus pour les autres espaces de noms (e.g. Catégorie ; Modèle ; etc.)

Un script similaire pour des bases de données PostgreSQL ressemble à :

$ psql -At -U wikiuser -h localhost wikidb -c "select page_title from mediawiki.page"

Note, replacez wikuser'' par votre nom d'utilisateur, la base de données demandera ensuite votre mot de passe. Cette exemple montre des tables sans le préfixe wiki_ et avec l'espace de noms spécifié dans le nom de la table.''

Alternativement, une approche rapide pour ceux qui ont accès à une machine où Python est installé :


 * 1) Aller à Special:Allpages et choisissez l'espace de noms desiré.
 * 2) Sauvegardez la page web entière sous le nom index.php.htm. Certains wikis peuvent avoir plus de pages que ce qu'un écran de Special:AllPages peut afficher ; il est nécessaire dans ce cas de sauvegarder chacune de ces pages.
 * 3) Lancez export_all_helper.py dans le même répertoire que le fichier sauvegardé. Vous pourriez souhaiter rediriger la sortie vers un fichier ; par exemple   pour l'envoyer vers un fichier nommé main.
 * 4) Sauvegardez les noms de pages données en sortie par le script.



Réaliser l'export

 * Aller à Special:Export et copiez tous vos titres dans le champ de texte, en vous assurant de ne laisser aucune ligne vide.
 * Cliquez sur 'Exporter'
 * Sauvegardez le fichier XML résultant à l'aide de votre navigateur.

et finalement...


 * Ouvrez le fichier XML dans un éditeur de texte. Descendez dans le fichier à la recherche des messages d'erreur.

Vous pouvez maintenant utiliser ce fichier XML pour réaliser un import.



Exporter l'historique complet
Exporting the revision history may be desirable to retain authorship information and attribution. Une case à cocher dans l'interface de Special:Export permet de sélectionner l'historique complet (toutes les versions d'un article) ou la version la plus récente des articles. Un maximum de 100 versions est renvoyé ; les autres révisions peuvent être demandées comme précisé dans.



Format d'exportation
Le format du fichier XML que vous recevez est tout à fait le même. Il est codifié en schéma XML à https://www.mediawiki.org/xml/export-0.10.xsd Le format n'est pas destiné à être vu dans un navigateur web. Certains navigateurs vous montrent du XML proprement présenté avec des liens "+" ou "-" pour voir ou cacher les parties sélectionnées. Alternativement la source XML peut être vue avec la fonctionnalité Voir la source de votre navigateur, ou après avoir sauvegardé le fichier XML localement, avec le programme de votre choix. Si vous lisez directement la source XML ce ne sera pas difficile de trouver le wikicode présent. Si vous n'utilisez pas d'éditeur XML "<" et ">" apparaitront comme &amp;lt; et &amp;gt;, afin d'éviter des conflits avec des balises XML ; pour éviter l'ambiguïté, "&amp;" est codé comme "&amp;amp;".

Dans la version actuelle le format d'exportation ne comprend pas le remplacement en XML des balises wiki (voir la DTD Wikipedia pour une ancienne proposition). Vous obtenez le wikicode tel qu'il apparaît lors de la modification de l'article.

DTD
Voici une version non officielle du format et brève de la Définition du type de document. Si vous ne savez pas ce qu'est une DTD, ignorez-la simplement.



Exploiter l'export XML
Un grand nombre d'outils peuvent traiter le XML exporté. Si vous traitez un grand nombre de pages (par exemple un vidage complet) il est probalbe que vous ne pourrez pas faire tenir le document en mémmoire principale et vous aurez donc besoin d'un analyseur basé sur SAX ou sur d'autre méthodes activées par événement.

Vous pouvez aussi utiliser des expressions régulières pour traiter directement des parties du code XML. Ceci peut être plus rapide que les autres méthodes mais n'est pas recommandé car difficile à maintenir.

Veuillez lister ici les méthodes et les outils qui traitent les exports XML :


 * Parse MediaWiki Dump (crates.io) bibliothèque ou exécutable (crate) du paquet Rust permettant d'analyser les vidages XML.
 * Parse Wiki Text (crates.io) crate du paquet Rust pour analyser le wikicode en un arbre d'éléments.
 * Parse::MediaWikiDump est un module Perl pour traiter le fichier de vidage XML.
 * m:Processing MediaWiki XML with STX - transformation XML basée sur les flux
 * m:IBM History flow project peut le lire après avoir passé un petit programme Python, export-historyflow-expand.py.



Détails et conseils pratiques

 * Pour déterminer l'espace de noms d'une page vous devez identifier son titre avec les préfixes définis dans
 * Les restrictions possibles sont
 * - pages protégées



Pourquoi exporter ?
Pourquoi ne pas utiliser simplement un téléchargement dynamique de la base de données ?

Supposons que vous construisiez une fonction logicielle qui permette d'afficher des informations venant de Wikipedia. Si vous voulez que votre programme affiche l'information d'une manière différente de celle vue dans la version active, il vous faudra certainement le wikicode nécessaire pour le traduire, au lieu du html final.

De même, si vous souhaitez obtenir l'ensemble des données vous voudrez probablement les transférer de la manière la plus efficace possible. Les serveurs Wikimedia doivent réaliser une partie du travail de conversion du wikicode en html. Cela requiert du temps d'exécution, à la fois pour vous mais aussi pour les serveurs Wikimedia, et donc distribuer simplement toutes les pages n'est pas une manière de procéder.

Pour accéder à chaque article en XML, l'un après l'autre, pointez vers :

Special:Export/Titre_de_l'article



Voir aussi

 * Data portability on English Wikipedia
 * Data portability on English Wikipedia
 * Data portability on English Wikipedia
 * Data portability on English Wikipedia