Aide:Extension:FileImporter

Note : si vous modifiez cette page, vous acceptez de placer votre contribution sous licence CC0. Plus d’informations sont disponibles sur le projet Aide dans le domaine public.

Les extensions FileImporter et FileExporter ont pour but de déplacer plus facilement des fichiers d'un wiki local vers Wikimedia Commons. La nouvelle fonctionnalité permet de déplacer ces fichiers avec toutes leurs données originelles intactes, et en documentant le déplacement dans l'historique de la version.

FileExporter fournit un lien vers Wikimedia Commons du wiki local et attribue une URL à l'extension FileImporter. FileImporter est une extension de Wikimedia Commons qui importe le fichier avec toutes les données lorsque toutes les conditions préalables sont remplies. Techniquement, les fichiers ne sont pas déplacés mais copiés.

FileImporter a été déployé sur Wikimedia Commons en juin 2018. FileExporter est déployé et activé comme fonctionnalité par défaut sur tous les wikis Wikimedia depuis août 2020.

Contexte

FileImporter et FileExporter permettent de remplir une demande à partir de la liste de souhaits techniques de la communauté germanophone et sont développés par l'équipe technique de la WMDE (WikiMedia Deutschland). Vous trouverez plus d'informations sur la page principale du projet sur Meta.

Utilisation

Pour commencer

1) Pour utiliser FileExporter sur un wiki local (par exemple sur la Wikipedia anglophone), vous devez être connecté et avoir le droit de téléverser des fichiers.

2) Vous devez disposer d'un fichier de configuration pour votre wiki (par exemple c'est le cas de la Wikipedia anglophone). Beaucoup de fichiers existent déjà, basés sur les fichiers de l'outil CommonsHelper2. Nous demandons aux utilisateurs de les examiner et de les mettre à jour ou de les créer si nécessaire pour s'assurer que les importations sont effectuées correctement.

Pour plus d'information, lire la documentation sur la manière dont fonctionnent les fichiers de configuration et à quoi ils servent.

Pas à pas

Vous devez être connecté pour utiliser la fonctionnalité.

• 
  1 : sur la page d'un fichier local, cliquer sur l'onglet "Exporter vers Wikimedia Commons" (au-dessus de l'image).
• 
  2 : FileImporter vérifie si le fichier peut être importé et s'il y a des substitutions à faire pendant l'import. Cette étape est basée sur le fichier de configuration du wiki. Autres informations.
• 
  3 : une page d'aperçu sur Commons vous montre ce qui sera importé. Vous pouvez modifier le titre du fichier et les informations de la page, et demander au FileImporter de nettoyer le wiki source à votre nom, en ajoutant un modèle comme NowCommons au fichier source, ou en supprimant le fichier source si vous avez les droits administrateur. En cliquant sur "Importation de fichier", le fichier est copié dans Commons.
• 
  4 : le fichier est importé, avec le nom du téléverseur original et le nom de l'importateur, l'ancien historique du fichier et la page du fichier ainsi que toutes les modifications apportés à l'import.

Comment trouver les fichiers importés

• Dans l'historique des révisions d'un fichier, l'import apparaît comme une modification vide (c'est à dire une entée dans la liste des versions qui ne modifie pas la page actuelle). Si des modifications ont été apportées pendant l'import, un texte supplémentaire créé est ajouté.
• les nouvellles version créées par l'import sont marquées avec Modified with FileImporter. Ce cette manière il peut être filtré sur la page des modifications récentes.
• A la fois une entrée dans le journal des téléversements et une entrée dans le journal des imports sont créées et associées à la version vide et avec l'utilisateur qui a importé, et horodaté avec la date de l'import. Avoir les deux entrées de journaux est la norme par défaut pour les téléversements, bien que cela puisse entraîner des entrées en double dans les modifications récentes et les listes de suivi, voir ce fichier d'exemple et ses entrées de journal.
• Pour les (anciennes) versions importées du fichier, téléversez les entrées du journal sont créées avec la date et l'utilisateur du téléversement originel pour que toutes les versions du fichier apparaissent dans le journal des téléversements dans Commons. Ces versions sont également marquées de Imported with FileImporter.
• les fichiers importés sont marquées d'un commentaire invisible qui dit "This file was moved here using FileImporter from" et qui mentionne l'URL complète du fichier source. La fonctionnalité insource: de CirrusSearch peut être utilisée pour trouver des fichiers avec ce commentaire, par exemple : insource:"This file was moved here using FileImporter from //en.wikipedia". Remarquez que cela trouve également les fichiers ultérieurs dérivés des fichiers importés, mais pas les fichiers où le commentaire a été supprimé.

Comment ajouter de nouvelles catégories

Le message fileimporter-post-import-revision-annotation (qui est vide par défaut) peut être utilisé pour ajouter du wikicode supplémentaire à chaque fichier importé. Le message accepte deux paramètres :

• $1 - URL complète du fichier source.
• $2 - L'heure de l'import est au format ISO 8601, c'est à dire 2004-02-12T15:19:21+00:00.

Par exemple, pour catégoriser en fonction du wiki source, un administrateur d'interface peut définir le message sur {{#invoke:Imported with FileImporter|main|url=$1|time=$2}}, où le module Lua invoqué ("Module:Imported with FileImporter" dans ce exemple) ressemble à ceci :

local exports = {}
function exports.main( frame )
    return "[[Category:Files moved to Commons from " .. mw.uri.new( frame.args.url ).host:gsub( ".org", "" ) .. "]]"
end
return exports

Plan du déploiement

• 2018-06-12: Export vers test.wikipedia.org
  • FileExporter en tant que fonctionnalité bêta sur mediawiki.org et test2.wikipedia.org.  OK (pour tester l'export, vous devez aussi être un utilisateur auto-confirmé sur ces wikis.)
  • FileImporter sur test.wikipedia.org  OK
• 2018-06-25: Exporter vers Wikimedia Commons
  • FileExporter en tant que fonctionnalité bêta sur de.WP, fa.WP, ar.WP  OK
  • exporter de mediawiki.org maintenant vers Wikimedia Commons  OK
  • FileImporter sur Wikimedia Commons  OK
• 2018-07-11:
  • FileExporter en tant que fonctionnalité bêta sur wikisource  OK
• 2019-01-16:
  • Déploiement d ela fonctionnalité bêta FileExporter sur tous les autres wikis  OK
• 2019-09-24:
  • Déploiement en tant que fonctionnalité par défaut sur de.WP, fa.WP, ko.WP, mr.WP et wikisource (wikisource.org)  OK
• 2020-08-05:
  • Déploiement en tant que fonctionnalité par défaut sur tous les Wikis restants  OK

Liens

• Page d'accueil du projet sur Meta
• FileImporter - manuel de l'extension
• Extension:FileImporter/Liste des wikis configurés - Configurations de FileImporter
• FileExporter - manuel de l'extension
• phab:tag/move-files-to-commons/ - projet Phabricator
• Aperçu : Comment l'extension FileImporter retrouve-t-elle les modèles