Hilfe:AutoWikiBrowser

Dieses Tutorial führt dich durch den Prozess der Verwendung des AutoWikiBrowser Programms, um halbautomatische Bearbeitungen am Beispiel der Änderung eines Wortes auf Seiten des Fandubbing-Wikis vorzunehmen. Obwohl es sich nicht um einen Bot handelt, wird der Prozess als solcher bezeichnet.

Ein ausführlicheres Bedienungshandbuch ist auf Wikipedia verfügbar.

Schritt 1: Erstelle ein Bot-Benutzerkonto

Hinweis: Wenn du bereits ein Bot-Benutzerkonto hast, überspringe diesen Schritt.

Du kannst AWB zwar über dein Hauptkonto laufen lassen, aber wenn du große Mengen an Änderungen vornimmst, lohnt es sich, ein separates Bot-Benutzerkonto zu erstellen, um automatisierte Änderungen getrennt zu halten.

Tipps für dein Bot-Benutzerkonto:

• Die meisten Bot-Namen enthalten das Wort „Bot“, um anzuzeigen, dass es sich um einen Bot handelt.
• Auf der Benutzerseite des Bot-Kontos solltest du angeben, wem das Konto gehört, und erwähnen, dass es ein Bot ist. Siehe hier für weitere Details.
• Wenn du vorhast, viele Änderungen vorzunehmen oder sehr schnell zu bearbeiten, solltest du mit deiner Community besprechen, ob das Benutzerkonto als Bot gekennzeichnet werden soll. Dadurch werden die Bearbeitungen des Kontos standardmäßig in den Letzten Änderungen ausgeblendet. Du kannst deinen Bot hier von einem Ansprechpartner als solchen markieren lassen.

Schritt 2: Das Programm erhalten

Lade den AutoWikiBrowser hier herunter. Die grundlegende Bedienung der Software ist wie folgt:

1. AutoWikiBrowser starten
2. Logge dich in den Bot-Account mit AutoWikiBrowser ein.
3. Festlegen, welche Seiten der Bot bearbeiten soll
4. Festlegen, was der Bot tun soll

Beachte, dass AutoWikiBrowser entweder im vollautomatischen oder im halbautomatischen Modus betrieben werden kann. Im halbautomatischen Modus musst du jede Bearbeitung überprüfen und manuell speichern. Dies nimmt einen großen Teil des Risikos, wenn du versuchst, viele Seiten zu bearbeiten.

Schritt 3: Lerne, wie du das Programm nutzt

In diesem Beispiel werden wir unseren Bot einrichten und ihn dann verwenden, um einen falsch geschriebenen Künstlernamen auf vielen Seiten unseres Wikis zu korrigieren.

Eine Community auswählen

1. Starte AutoWikiBrowser.
2. Gehe zu Options → Preferences → Site
3. Au dem Drop-down-Menü, wähle „custom“ als dein Projekt
   • Du kannst außerdem auch „Fandom“ aus der Drop-down-Liste auswählen und dann den ersten Teil aus der URL deiner Community (z. B. „fandubbing“) eingeben, das funktioniert aber nur für englische Wikis.
4. Wähle „https://“ anstelle von „http://“
   • Selbst wenn du HTTP auswählst, wird dies automatisch zu HTTPS im nächsten Schritt korrigiert, aber diese Autokorrektur könnte in anderen Versionen dieser Software nicht funktionieren.
5. Gib die Domain des Wikis (z. B. help.fandom.com) in das Textfeld ein (lasse den „https://“-Teil aus, weil du das bereits im Schritt davor ausgewählt hast)
6. Wenn du fertig bist, speichere deine Änderungen, indem du auf „OK“ klickst

Das Programm könnte für wenige Sekunden einfrieren. Danach siehst du in der unteren Leiste, dass das Programm mit deiner Community synchronisiert ist:

Anmelden

Nachdem du dein Wiki ausgewählt hast, musst du dich in dein Bot-Benutzerkonto anmelden.

1. Gehe zu File → Log in/Profiles....
2. Gib den Benutzername und das Passwort des Bots ein.
   • Du musst dich mit einem speziellen Namen und Passwort anmelden, der durch Spezial:BotPasswords generiert wurde. Siehe Hilfe:Bots#Spezial:BotPasswords benutzen für weitere Informationen in diesem Prozess. Der Benutzername sollte in etwa BenutzerkontoName@BotPasswortName sein, z.B. wenn dein Benutzername Benutzer-Bot ist und dein Passwort AWB lautet, müsstest du Benutzer-Bot@AWB eingeben.
     

Du musst dich mit einem speziellen Namen und einem Passwort, generiert durch Spezial:BotPasswords anmelden. Siehe Hilfe:Bots#Wie_erhalte_ich_Login-Daten_für_den_Bot? für weitere Informationen in diesem Prozess. Der Benutzername sollte BenutzerkontoName@BotPasswortName sein, z. B. ist dein Benutzername Benutzername-Bot und dein Passwort AWB, müsstest du Benutzername-Bot@AWB eingeben. Wenn du dich auf einem sicheren Computer befindest, solltest du das Feld „Save Password“ markieren. Sobald du dein Benutzerkonto konfiguriert hast, melde dich an, indem du auf das Konto, mit dem du dich anmelden möchtest, doppelklickst.

1. Klicke auf „Login“.

Die untere Zeile wird jetzt anzeigen, dass du angemeldet bist:

Jetzt ist der Bot bereit und die Arbeit kann losgehen!

Hinweis: Einige Wikis werden eine sogenannte Checkpage haben, welche das Programm auf ausgewählte Benutzer limitiert, die automatische Bearbeitungen durchführen können.

Bearbeitungsoption auswählen

Dieses Beispiel wird falschgeschriebene Artikelnamen korrigieren.

Als erstes müssen wir eine Liste der zu bearbeitenden Seiten erstellen. AutoWikiBrowser hat viele verschiedene Listengeneratoren zur Verfügung. Im Bereich „Make list“ wählt man aus dem Drop-down-Menü „Source“ eine geeignete Option aus. Wenn alle Seiten, an denen du interessiert bist, in der gleichen Kategorie sind, verwende die Option „Category“. Wenn du dich eher für Seiten interessierst, die eine bestimmte Vorlage verwenden, wähle die Option „What transcludes page (all NS)“.

Tipp: Um eine Liste aller Seiten im Hauptnamensraum zu erstellen, wähle im Feld „Make List“ als Quelle „Special Page“. Wenn du auf „Make List“ drückst, sollte ein zusätzliches Fenster erscheinen. Wähle „All Page“, wähle den Namensraum „Main:“ und drücke „OK“.

Nun, da wir unsere Liste der zu prüfenden Seiten haben, müssen wir dem Bot mitteilen, was wir tun wollen. Neben dem Feld „Make list“ befindet sich der Hauptbereich für die Bearbeitungsoptionen. Um dem Bot mitzuteilen, dass er den Namen des Künstlers ändern soll, verwenden wir die Option „Find and replace“. Markiere das Kontrollkästchen, um es zu aktivieren, und klicke dann auf „Normal settings“. Gib den falsch geschriebenen Namen in das Feld „Find“ und die richtige Schreibweise in das Feld „Replace with“ ein. Für dieses Beispiel kannst du die anderen Optionen beibehalten, aber du kannst gerne mit den Einstellungen experimentieren. Mit Klick auf „OK“ schließt sich das Feld und die Einstellungen werden übernommen.

Tipp: Wenn du dir nicht sicher bist, was eine bestimmte Einstellung oder ein Schalter bewirkt, sieh im Benutzerhandbuch nach.

Beginn der Bearbeitungen

Wenn du bereit bist zu beginnen, gehe auf die Registerkarte „Start“ im mittleren Bereich.

1. Gib die „Default Summary“ ein. Dies ist die Basis für jede Bearbeitungszusammenfassung. Je nach den gewählten Optionen kann sie ergänzt werden.
2. Drücke „Start“.

Das Programm beginnt, die Liste der Seiten zu durchsuchen. Wenn es die gesuchte Phrase findet, übernimmt es die entsprechenden Änderungen und zeigt sie im Hauptfeld an.

Wenn die Änderungen nicht ganz deinen Vorstellungen entsprechen, kannst du die Seite immer noch über das Bearbeitungsfeld unten rechts bearbeiten.

Wenn du fertig bist, drücke auf „Save“, um die Änderungen zu speichern. Wenn die Seite nicht bearbeitet werden muss, drücke „Skip“, um die Seite unverändert zu lassen.

Tipp: Auf der Reiter „Skip“, markiere die Option „Skip if no changes are made“. Dies bewirkt, dass AutoWikiBrowser automatisch Seiten überspringt, an denen keine Änderungen vorgenommen werden.

Vollautomatischer Bot

Das obige Beispiel zeigt, wie du halbautomatisch bearbeiten kannst. Es ist recht schnell und sicher, da du jede Änderung kontrollieren kannst. Wenn du möchtest, kannst du aber auch auf den Reiter „Bots“ gehen und die Option „Auto save“ aktivieren.

AutoWikiBrowser speichert nun jede Änderung automatisch, ohne dass du sie bestätigen musst. Verwende diese Option mit Bedacht. Es wird dringend empfohlen, ein paar halbautomatische Testbearbeitungen durchzuführen, bevor du die automatische Speicherung aktivierst, um zu testen, ob der Bot richtig funktioniert.

Suchen-und-Ersetzen

Hier sehen wir Schritt für Schritt die einfachste AWB-Bearbeitung: ein Wort/Satz finden und durch ein anderes Wort/Satz ersetzen.

1. Zunächst musst du eine Liste der Seiten erstellen, die dir am wichtigsten sind. Dies kann eine Kategorie sein, oder „What links here“ (dieselbe Funktionalität wie Spezial:Linkliste), oder wirklich jede der Optionen.
   • Es ist möglich, Unterschiede zwischen zwei Listen über die „List comparer“ Oberfläche zu finden, die über den Reiter „Tools“ aufgerufen werden kann.
2. Sobald du die Liste der Seiten hast, klicke auf den Reiter „Options“ auf der rechten Seite und dann auf „Find and replace“.
3. Markiere das Kästchen links neben dem Text und klicke dann auf „Advanced settings“. Wenn du nur eine einfache Tippfehlerkorrektur vornehmen willst, kannst du den genauen zu suchenden Text in das obere Feld und den Ersetzungstext darunter eingeben.
   • Es ist auch möglich, mit regulären Ausdrücken erweiterte Befehle zum Suchen und Ersetzen auszuführen. Reguläre Ausdrücke sind dann angebracht, wenn du ähnliche, aber nicht exakt identische Textmuster abgleichen willst. Im nächsten Abschnitt findest du einige Ressourcen, um zu lernen, wie man das macht.

Beachte, dass find-replace VOR append stattfindet. Wenn du also eine Kategorie anfügen willst, aber auf einigen Seiten diese Kategorie bereits vorhanden ist, setze eine Regel für „find-replace“ und entferne die Kategorie und diese wird vor dem Anfügen ausgeführt.

Leere Bearbeitung in AWB

AWB ist besonders nützlich, um „Null-Edits“ zu automatisieren, d.h. Bearbeiten und Speichern ohne Änderungen, um Caches für das Wiki oder verwandte Datentabellen zu aktualisieren, wenn dein Wiki Erweiterungen wie Cargo verwendet. Glücklicherweise ist dies leicht zu bewerkstelligen: Gehe einfach zu Optionen → Apply changes automatically, und deaktiviere diese Option.

Fehlerbehebung

Probleme bei der Installation

• AWB wird geöffnet, indem du zu dem Ordner navigierst, in den du es heruntergeladen hast, und dann die .exe-Datei direkt öffnest; sie wird nicht in deinem Startmenü angezeigt.
• AWB ist nur für Windows geeignet.
• Möglicherweise musst du mit der rechten Maustaste klicken und als Administrator ausführen.

Probleme beim Anmelden

• Hat dein Bot das Wiki, bei dem du dich anzumelden versuchst, bereits über einen Browser besucht? Wenn nicht, wird er noch nicht als registrierter Benutzer aufgeführt.
• Verwendest du die unter Spezial:BotPasswords generierten Anmeldedaten? Dies ist erforderlich für die Anmeldung bei Drittanbieter-Werkzeuge, einschließlich AutoWikiBrowser.
• Hast du deinen Benutzernamen richtig formatiert, d. h. DeinBenutzername@BotPasswortName?
• Verwendest du HTTPS anstelle von HTTP? (Du brauchst HTTPS.)
• Versuchst du, dich in das richtige Wiki anzumelden?
• Hast du zuvor eine falsche Anmeldung verwendet und versuchst nun versehentlich, dich mit denselben Anmeldedaten anzumelden? Wenn du die „quick Login“ anstelle von „add...“ verwendest, stelle sicher, dass du auf die Schaltfläche rechts neben den Feldern klickst und nicht darüber; stelle außerdem sicher, dass du falsche Anmeldedaten löschst.

Probleme bei der Seitenauswahl

• Hast du die Version „all namespaces“ des Feldes ausgewählt, das du zu verwenden versuchst? Wenn nicht, wird AWB nur im Hauptnamensraum suchen.

Probleme beim Speichern von Seiten

• Ist die Option „Apply Changes Automatically“ unter Optionen aktiviert? Wenn nicht, versucht dein Bot, die Seiten nicht zu speichern, sondern zu bearbeiten.
• Bist du im richtigen Wiki für die Seiten angemeldet, die du zu bearbeiten versuchst?
• Wenn du eine Ersetzungssuche durchführst, sind deine Regeln aktiviert (Kontrollkästchen rechts neben dem Namen)?
• Hast du „followed redirects“ unter „Options“ aktiviert, wenn du es nicht willst? (Oder andersherum)
• Sind die Seiten, die du zu bearbeiten versuchst, geschützt? Wenn ja, verfügt dein Bot über die erforderlichen Berechtigungen in Spezial:BotPasswords? Beachte, dass der kaskadierende Schutz eine andere Berechtigung ist als der reguläre Schutz; möglicherweise musst du den kaskadierenden Schutz auf der Startseite vorübergehend deaktivieren.

Probleme mit regulären Ausdrücken

• Hast du daran gedacht, „Regular expression“ zu überprüfen?
• Benutzt du Einzeiler (. entspricht dem Zeilenumbruch, falls aktiviert) und Mehrzeiler (^ und $ den Anfang und das Ende von Zeilen anstelle von Seiten abgleichen) richtig?
• Hast du überprüft, ob deine Regex tatsächlich funktioniert? Die Verwendung des Dialogs „Test...“ kann dabei helfen.
• Hast du eine Wenn-Bedingung in der Regel angegeben, obwohl du das nicht willst? (Der Reiter hinter deiner Regel)
• Hast du daran gedacht, alle notwendigen Satzzeichen zu umgehen? (|, ?, {}, etc.)

Probleme auf Fandom

• Ist dein Bot bei Project:AutoWikiBrowser/CheckPage gelistet?
• Verwendest du ein VPN? Versuche vielleicht, die Verbindung zu ändern.

Siehe auch

• Benutzerhandbuch auf Wikipedia
• Fortgeschrittenere Such- und Ersetzungsoperationen können mit Hilfe von regulären Ausdrücke durchgeführt werden:
  • https://regexr.com/ - Teste deine Regex und nutze die Ressourcen, einschließlich eines Spickzettels in der Seitenleiste, während du das tust.
  • https://regex101.com/ - ähnlich wie obiges.
  • https://www.regular-expressions.info/ - Diese Seite ist relativ technisch, bietet aber eine gründliche Einführung in Regex. Wenn du Schwierigkeiten hast, den Erklärungen zu folgen, mach dir keine Sorgen - sie ist auf hohem Niveau geschrieben und wird am besten verwendet, wenn sie durch andere Ressourcen ergänzt wird.

Mehr Hilfe

• Ein Stichwortverzeichnis zu verschiedensten Hilfeseiten findest du auf Hilfe:Index.
• Einen geordneten Einstieg zur Hilfe gibt es auf der Seite Hilfe:Übersicht.
• Fragen an andere Benutzer kannst du in den Diskussionen des Community-Wikis stellen.
• Anmerkungen zu dieser Hilfeseite kannst du auf der dazugehörigen Diskussionsseite hinterlassen.
• Um Fehler zu melden, kontaktiere bitte einen Ansprechpartner oder nutze das entsprechende Kontaktformular.