Hilfe:Erweiterung:FileImporter

Hinweis: Wenn Du diese Seite bearbeitest, stimmst Du zu, dass Dein Beitrag unter der [CC0] veröffentlicht wird. Mehr Informationen findest du auf der Public Domain Hilfeseite.

Die Erweiterungen FileImporter und FileExporter haben zum Ziel, das Verschieben von Dateien aus einem lokalen Wiki nach Wikimedia Commons zu vereinfachen. Die neue Funktionalität erlaubt es, Dateien zu verschieben und dabei die Originaldaten zu erhalten und die Verschiebung in der Versionsgeschichte zu dokumentieren.

FileExporter ergänzt im lokalen Wiki einen Link auf Wikimedia Commons und gibt eine URL an die Erweiterung FileImporter weiter. FileImporter ist eine Erweiterung auf Wikimedia Commons, die die Datei inklusive all ihrer Daten importiert, wenn alle Voraussetzungen erfüllt sind. Technisch betrachtet werden die Dateien nicht „verschoben“, sondern „kopiert“.

FileImporter steht seit Juni 2018 auf Wikimedia Commons zur Verfügung. FileExporter ist seit August 2020 auf allen Wikimedias standardmäßig aktiviert.

Hintergrund

FileImporter und FileExporter haben zum Ziel, eine Anfrage aus dem Technische Wunschliste der deutschsprachigen Community zu erfüllen, die vom WMDE-Technikteam (WikiMedia Deutschland) entwickelt wurde. Weitere Informationen findest Du auf der Hauptprojektseite in Meta.

Verwendung

Erste Schritte

1) Um den FileExporter auf dem lokalen Wiki zu aktivieren, muss man eingeloggt sein und in den eigenen Einstellungen ein Häkchen bei der Beta-Funktion FileExporter setzen.

2) Es muss eine Konfigurationsdatei für Dein Wiki geben. Viele Dateien gibt es schon auf Basis des Helferleins CommonsHelper2. Wir bitten unsere Benutzer, sie zu prüfen und dann zu aktualisieren oder anzulegen, wenn nötig, damit die Importe korrekt ausgeführt werden.

Lies die Dokumentation für weitere Infos dazu, wie Konfigurationsdateien funktionieren und wofür sie gebraucht werden.

Schritt für Schritt

Du musst eingeloggt sein, um dieses Feature benutzen zu können.

• 
  1: Klicke auf einer lokalen Dateiseite auf den Tab "Nach Wikimedia Commons exportieren" (über dem Bild).
• 
  2: FileImporter prüft, ob die Datei importiert werden kann und ob während des Imports eine Übersetzunge gemacht werden muss. Dieser Schritt basiert auf der Konfigurationsdatei der Wiki. Weiter Informationen.
• 
  3: Auf Commons zeigt eine Voransicht, was importiert werden wird. Du kannst den Dateinamen und die Seiteninformationen bearbeiten und FileImporter anweisen, im Ursprungswiki in Deinem Namen aufzuräumen, oder die Quelldatei direkt zu löschen, wenn Du Admin-Rechte hast. Ein Klick auf “Importieren” kopiert die Datei nach Commons.
• 
  4: Diese Datei wurde in Wikimedia Commons importiert, einschließlich des Namens der originalen Hochladers und des Namens des Importeurs, der vorherigen Dateiversionen, der vorherigen Dateiseite und allen Änderungen, die während des Imports vorgenommen wurden.

Wie importierte Dateien gefunden werden können

• In der Versionsgeschichte einer Datei wird der Import als Null-Revision angezeigt (das ist ein Eintrag in der Versionsliste, bei dem die Seite nicht verändert wurde). Wenn während des Imports Änderungen vorgenommen wurden, dann wird eine zusätzliche Text-Revision angelegt.
• Neue Versionen, die während des Imports angelegt werden, werden mit Verändert durch den Dateiimporteur getagged . So kann es auf der Seite Letzte Änderungen herausgefiltert werden.
• Sowohl ein Uploadlogeintrag als auch ein Importlogeintrag werden angelegt und mit der Null-Revision und dem importierenden Benutzer verbunden und mit dem Importdatum versehen. Beide Logbucheinträge zu erstellen, ist Standardeinstellun g für Uploads, auch wenn es zu doppelten Einträgen in den Letzten Änderungen und in der Beobachtungsliste führt. Siehe diese Beispieldatei und ihre Logbucheinträge.
• Für (alte) importierte Dateiversionen werden Uploadlogeinträge mit dem Datum und dem Benutzer des originalen Uploads versehen, um alle Dateirevisionen in Commons Uploadlog anzeigen zu können. Diese Revisionen werden zudem mit Importiert mit FileImporter getaggt.
• Importierte Dateien sind mit dem unsichtbaren Kommentar vereshen, welcher beinhaltet: 'Diese Datei wurde mit dem FileImporter importiert' (englisch: This file was moved here using FileImporter from) und es wird eine Quell-URL angehängt. CirrusSearch's insource: feature kann benutzt werden, um um Dateien mit diesem Kommentar zu finden, beispielsweise: insource:"This file was moved here using FileImporter from //en.wikipedia". Dadurch können auch spätere Abwandlungen des importierten Werkes gefunden werden, dies klappt nicht, wenn der Kommentar entfernt wurde.

Kategorien verwenden

Die Nachricht fileimporter-post-import-revision-annotation (standardmäßig leer) kann verwendet werden, um weiteren Wikitext zu jeder importierten Datei hinzuzufügen. Zwei Parameter sind dabei möglich:

• $1 - vollständige URL der Quelldatei
• $2 - Zeitstempel des Imports im ISO 8601-Format, beispielsweise 2004-02-12T15:19:21+00:00

For example, to categorize by source wiki, an interface administrator can set the message to {{#invoke:Imported with FileImporter|main|url=$1|time=$2}}, where the invoked Lua module ("Module:Imported with FileImporter" in this example) looks like this:

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

Deployment-Roadmap

• 12. Juni 2018: Export nach test.wikipedia.org
  • FileExporter als Beta-Funktion auf mediawiki.org und test2.wikipedia.org. (Zum Testen muss man auch hier automatisch bestätigte Benutzerin oder Benutzer sein.)
  • FileImporter auf test.wikipedia.org
• 2018-06-25: "In Wikimedia Commons exportieren"
  • FileExporter als Beta-Funktion auf de.WP, fa.WP, ar.WP  OK
  • Export von mediawiki.org nach Wikimedia Commons  OK
  • FileImporter auf Wikimedia Commons  OK
• 2018-07-11:
  • FileExporter als Beta-Funktion auf wikisource  OK
• 16.01.2019:
  • Bereitstellung der FileExporter Beta-Funktion für alle anderen Wikis  OK
• 2019-09-24:
  • Veröffentlichung als ein Standardfeature auf de.WP, fa.WP, ko.WP, mr.WP und sourceswiki (wikisource.org)  OK
• 2020-08-05:
  • Veröffentlichung als ein Standardfeature auf allen übrigen Wikis  OK

Links

• Hauptprojektseite auf Meta
• FileImporter - Erweiterungshandbuch
• Extension:FileImporter/Liste der konfigurierten Wikis - FileImporter-Konfigurationen
• FileExporter - Erweiterungshandbuch
• phab:tag/move-files-to-commons/ - Phabricator Projekt
• Übersicht: Wie Vorlagen in der FileImporter-Erweiterung zugeordnet werden