Quelltext der Seite Wikipedia:Importwünsche/importUtility

{{SeitenordnungWP.de
| PageID = 92419
| Obereinordnung1 = ∆MW-Inhalt
}}
<div style="float:right; width:auto; margin-right:0; font-size: 80%;">
''Für Lady Whistler''
</div>
'''importUtility''' ist ein JavaScript-Gadget, um Routineaufgaben beim Import zu automatisieren.

Ohne Rechte als Administrator oder Importeur ist die Benutzung sinnlos.

== Aktivierung ==
Administratoren können in ihren [[Hilfe:Einstellungen|Benutzer-Einstellungen]] (Registerkarte „[[Spezial:Einstellungen#mw-prefsection-gadgets|{{int:prefs-gadgets}}]]“; ganz unten) das Hilfsmittel einfach aktivieren und deaktivieren.

Zu anderen Möglichkeiten siehe [[Wikipedia:Technik/Skin/Gadgets/importUtility|WP:HW/IU]].

== Benutzung ==
[[Datei:Screenshot eines Importes mit importUtility.png|thumb|Screenshot eines Importes mit importUtility]]
Ausgangspunkt ist die Bearbeitung von Abschnitten der Wunschliste [[Wikipedia:Importwünsche|WP:IMP]].

=== Doppelarbeit vermeiden ===
Auf der Wunschliste wird bei frischen Wünschen ein Knopf {{Taste|in Arbeit}} angeboten, über den dieser per API dahingehend markiert wird, dass eine parallele Bearbeitung durch andere Importeure vermieden wird.

Bearbeitungskonflikte werden erkannt.

Wer den Baustein gesetzt hatte, sieht ihn selbst bei der Bearbeitung ausgegraut; bleibt er auffallend, dürfte eine Kollision vorliegen.

=== Standardfälle ===
* Bei Transwiki wird immer davon ausgegangen, dass die Quellseite im Artikelnamensraum des Quellprojekts liegt.
* Neuimporte sollen als Benutzer-Unterseite erfolgen.
* Als Zwischenstation kann auch der virtuelle [[Benutzer:Versionen]] genutzt werden, und wird automatisch für die Zwischenlagerung bei unterschiedlichen Namen verwendet.
Komplexere Sonderfälle (andere Namensräume) sind manuell auf der klassischen Spezialseite abzuwickeln.

=== Wunschliste ===
* Anklicken von &#91;Bearbeiten] öffnet den Abschnitt in einem neuen Browser-Fenster/-Tab zur Bearbeitung.
Grundsätzlich sind einzelne Seiten pro Antrag vorgesehen, und lediglich Standardfälle. Ausnahmsweise Serienbearbeitungen und exotische Namensräume werden ggf. nicht oder nur teilweise unterstützt.

==== Auftragsserie ====
Sollen auf WP:IMP mehrere Transwiki-Anträge desselben Benutzers abgearbeitet werden, empfiehlt sich folgendes Vorgehen:
* Erst heimlich, still und leise alle Anträge abarbeiten; Abschnitte noch nicht löschen.
* Bei der letzten Seite Benutzernachricht auslösen; im optionalen Zusatztext manuell ergänzen, dass der Rest auch vorhanden sei; ggf. die noch nicht gelöschten Anträge als Gedächtnisstütze.
* WP:IMP als Gesamt-Seite bearbeiten und die Serie en bloc löschen.

=== Abschnittsbearbeitung ===
Das Bearbeitungsfeld dient als Notizzettel, und die ausgefüllten Antragsfelder sind die Datenbasis. Jede einzelne Aktion hinterlässt einen Logbuch-Eintrag. Zum Schluss lässt sich, wenn alles in einem Rutsch innerhalb einiger Minuten abgearbeitet werden konnte, auch der gesamte Text wieder löschen. Dauert es länger oder kommt plötzlich etwas dazwischen, kann man den Zwischenstand speichern, und auch die Kollegen wissen Bescheid. Wenn mehrere Importe simultan abgearbeitet werden und man vom Multitasking überfordert ist, kann der Fortschritt der einzelnen Seiten sicher abgelesen werden.

==== Knöpfe ====
Der Abschnitt mit dem einzelnen Importwunsch wird mit den folgenden Buttons ausgestattet:

{{Taste|Import starten}}
: Starte Import direkt per API.
{{Taste|✓}}
: Protokolliere die links davon stehende Aktion.
{{Taste|Importierte Seite verschieben}}
: Workaround (per API)
: Verschiebe die soeben unter dem Lemma im fremden Projekt auf eine gleich betitelte Benutzer-Unterseite importierte Seite auf den angegebenen deutschsprachigen Titel (im BNR).
: Vorläufige Behelfslösung, bis es irgendwann einmal möglich ist, auf der Spezialseite als Zielseite direkt den endgültigen Seitennamen anzugeben.
{{Taste|Seitentext anpassen}}
: ''Noch nicht freigegeben.''
: Nicht beim Nachimport; nur Benutzer-Unterseiten.
: Vorlage voranstellen, Syntaxelemente anpassen, Kategorien deaktivieren (per API).
{{Taste|Benutzer informieren}}
: [[#Benutzer-Benachrichtigung|Standardnachricht]] (per API); optionale Variation möglich.
{{Taste|Löschen}}
: Das Bearbeitungsfeld wird gelöscht und kann gespeichert werden.

==== Bearbeitungskommentar ====
* Jede einzelne Aktion setzt die Zusammenfassung auf die Nennung der zuletzt ausgeführten Aktion zurück.
* Soll vor dem Speichern ein individueller Freitext angegeben werden, kann dies erst nach dem letzten Knopfdruck geschehen.

==== Datenkorrektur ====
Zu berichtigen bei unpassenden Angaben wäre ggf. der Seitenname bei der history-action. Die Überschrift ist hingegen völlig unbedeutend und wird nicht gelesen.

==== Benutzer-Benachrichtigung ====
Die [[Wikipedia:Importwünsche/Benutzernachricht|Standardnachricht]] lässt sich um einen optionalen Wikitext ergänzen.
* Dieser tritt an die Stelle der Grußformel.
* Es handelt sich um den Parameterwert für eine Vorlage; ''lose Pipe-Symbole&nbsp;| sind deshalb zurzeit noch nicht möglich, wohl aber innerhalb von Wikilinks oder Vorlagen''.
* Gedacht ist die Textergänzung für eine Variation der Grußformel oder eine Kurzinfo.
* Es gibt keine Vorschau.
* Hinter diesem Wikitext schreibt das Skript immer die vier Tilden. Der Text sollte also mit einer Grußformel abschließen; danach sollte in der Standardnachricht ein abschließender Zeilenumbruch stehen.
* Wird das Textfeld nicht ausgefüllt, wird die Standardnachricht geschrieben.
* Der Benutzername, auf dessen Diskussionsseite geschrieben wird, steht links oben.
Benutzer können auf eine [[Wikipedia:Importwünsche/Robinson|Robinsonliste]] gesetzt werden; dann gibt es einen Hinweis, jedoch keine Funktionseinschränkung.

=== Spezialseiten ===
* Nur wenn die Spezialseite unmittelbar zuvor mit einem der vorstehend beschriebenen Knöpfe geöffnet wurde, wird sie auf die damit zusammenhängende Aktion eingeschränkt.
* Die normale Spezialseite ist dann über den Link bei den [[#p-cactions|Tab-Reitern]] erreichbar.
* Die ggf. beiden Import-Formulare werden reduziert auf das für die Aktion geeignete.
* Die Formularfelder werden ausgefüllt, sofern dies aus den Antragsdaten ersichtlich ist.
* <!-- Die ausgefüllten Formularfelder werden gesperrt, um Fehlklicks zu vermeiden. --> Wenn [[#Datenkorrektur|etwas zu korrigieren wäre]], müsste dies einen Schritt zuvor in den Antragsdaten erfolgen, weil alle weiteren Aktionen ebenfalls diese verwenden und die Daten konsistent sein müssen; die Spezialseite kann erstmal geschlossen werden.

=== Wartungsseite ===
Aus dem aktuellen Bestand der [[:Kategorie:Benutzer:Importartikel]] kann eine sortierbare Tabelle aktualisiert werden mit den Spalten:
* jede BNR-Seite,
* versuchsweise das aus dem BNR-Seitennamen abgeleitete ANR-Lemma,
* Generierungsdatum der BNR-Seite (Tücke: Seitenerstellung meint Fremd-Wiki; Zeitpunkt im hiesigen BNR wäre gesucht: Verschiebung in BNR, oder erste Bearbeitung durch diesen Benutzer),
* Datum der letzten Bearbeitung der BNR-Seite; Bearbeitungen durch diesen Benutzer.
Nicht jede mit {{Vorlage|Importartikel}} als Baustelle markierte Seite ist tatsächlich ein Import. Wenn allererste Bearbeitung durch diesen Benutzer, dann ziemlich sicher nicht. Ggf. Vorlagenparameter oder alternative Vorlage anbieten.

== Konfiguration ==
* Das Skript kann in jedem Projekt eingesetzt werden; die Gegebenheiten lassen sich projektweise anpassen.
* Textbausteine werden nach Projektsprache (bleibende Einträge) und Benutzersprache (temporäre Oberfläche) unterschieden; zurzeit deutsch und englisch.

=== Projektkonfiguration ===
* Der veränderbare Benachrichtigungstext für Benutzer wird über Vorlageneinbindung eingefügt (subst); für dewiki: [[Wikipedia:Importwünsche/Benutzernachricht]] (sysop ratsam).
* Für die projektspezifische Adaption ist ansonsten die Änderung des JavaScript erforderlich; Komponente <code>.cnf.</code>''ProjektDB'' nach  Vorbild ausfüllen.

==== Benutzernachricht ====
Die Nachricht an den anfragenden Benutzer kann frei formatiert werden. Dabei stehen zusätzlich folgende Parameter zur Verfügung:
* <code><nowiki>{{{g}}}</nowiki></code> – Grußformel; auch Ergänzungstext
* <code><nowiki>{{{l}}}</nowiki></code> – abweichende Sprache des Quellprojekts; etwa <code>en</code>
* <code><nowiki>{{{n}}}</nowiki></code> – Namensraum-Nummer der Zielseite; etwa <code>0</code> (ANR) oder <code>2</code> (BNR)
* <code><nowiki>{{{s}}}</nowiki></code> – Quellseite; einschließlich Sprachkürzel; etwa <code>en:Main Page</code>
* <code><nowiki>{{{t}}}</nowiki></code> – Zielseite; etwa <code>Benutzer:X/Hauptseite</code>
* <code><nowiki>{{{u}}}</nowiki></code> – Nick des anfragenden Benutzers

=== Benutzerkonfiguration ===
''Auf Wunsch individuelle Anpassungen programmierbar.''

== Weitere Informationen ==
* [[Wikipedia:Technik/Skin/Gadgets/importUtility]] – Software-Struktur

[[Kategorie:Wikipedia:Import]]