Sakura-Editor-Makros: aufzeichnen, speichern, registrieren und mit JS erweitern

Kurzantwort: Makrotyp nach Aufgabe wählen

Ein Sakura-Editor-Makro kann eine Aufzeichnung oder ein Skript sein. Nutze .mac für feste Schritte, .js für Textlogik und reguläre Ausdrücke, .vbs nur bei vorhandener VBScript-Praxis.

Aufzeichnen, speichern, ausführen

Beginne mit einer kleinen Datei und typischen Grenzfällen. So erkennst du Abhängigkeiten von Cursor, Auswahl und Zeilenende.

Halte die Aufzeichnung kurz und teste sie auf zwei Beispielen.

1. Beispiel vorbereitenNormale und kritische Zeilen einfügen.
2. Minimal aufzeichnenMausabhängige Schritte vermeiden.
3. WiederholenAuf zweitem Beispiel testen.
4. Speichern und registrierenNur stabile Makros registrieren.

Suche und Ersetzung prüfen

Automatische Ersetzung kann viele Zeilen ändern. Prüfe Muster, Ersatztext, Umfang, Groß-/Kleinschreibung und Zeilenenden vorher.

Wenn nur die Auswahl betroffen ist, muss das im Skript klar stehen.

// Example idea only: test the pattern before running it on real files
var text = Editor.GetSelectedString(0);
if (text !== "") {
  Editor.InsText(text.replace(/old/g, "new"));
}

Fehler eingrenzen

Prüfe Pfad, Erweiterung, Encoding, Auswahl und WSH-Regeln.

Reduziere das Skript auf eine Texteingabe und füge Funktionen schrittweise hinzu.

Makros warten und teilen

Wenn ein Makro wöchentlich genutzt wird, sollte es wie eine kleine Codedatei behandelt werden. Bewahre eine stabile Kopie auf, beschreibe den Zweck und mische nicht zu viele Aufgaben in einer Datei. Ein Makro, das Leerzeichen bereinigt, Tabs umwandelt und Überschriften einfügt, ist schwer zu prüfen.

Beim Teilen gehören Eingabe- und Ausgabebeispiel dazu. Damit lässt sich testen, ob Sakura Editor, Encoding und Zeilenenden auf einem anderen Rechner gleich arbeiten. Weicht die Ausgabe ab, liegt die Ursache häufig in der Umgebung statt im Makrogedanken.

Prüfe registrierte Makros regelmäßig. Dateien aus alten Projekten sollten aus dem Menü verschwinden oder in einen Archivordner wandern. Ein kurzes Menü reduziert falsche Tastenkürzel und macht die passende Automatisierung schneller auffindbar.

Für sensible Dateien empfiehlt sich ein klarer Freigabeprozess: erst Kopie, dann Testlauf, dann Sichtprüfung der Änderung. Diese Routine klingt langsam, verhindert aber die typischen Fehler bei Massenänderungen in Konfigurationen, Übersetzungen oder CSV-Daten.

Ergänze außerdem ein Prüfdatum im Kommentar des Makros. So ist sichtbar, ob Datei, Tastenkürzel, Sakura-Editor-Version und Namensregeln noch zur aktuellen Arbeitsweise passen.

Wenn Makros in einem Team verteilt werden, sollte jede Änderung eine kurze Versionsnotiz bekommen. Darin stehen Datum, Grund der Änderung, getestete Beispieldatei und bekannte Einschränkungen. Diese einfache Liste verhindert, dass verschiedene Personen leicht unterschiedliche Varianten derselben Automatisierung verwenden.

Bei Textdateien aus unterschiedlichen Quellen lohnt sich außerdem ein Test mit mehreren Encodings. Eine Regel, die in einer UTF-8-Datei sauber wirkt, kann in älteren Shift_JIS-Dateien anders aussehen. Deshalb sollte der Makrokommentar nennen, welche Codierung und welche Zeilenenden beim letzten Test verwendet wurden.

F?r riskante Massen?nderungen ist ein zweiter Kontrollschritt sinnvoll. ?ffne nach dem Test eine Kopie im Diff-Werkzeug, vergleiche alte und neue Datei und pr?fe besonders leere Zeilen, Tabs, f?hrende Leerzeichen und letzte Zeilen ohne Umbruch. Erst wenn diese Kontrolle passt, sollte das Makro auf den eigentlichen Arbeitsbestand angewendet werden.

Diese letzte Sichtpr?fung sch?tzt besonders vor unbeabsichtigten ?nderungen in gemeinsam genutzten Projektdateien. Dokumentation.