Bearbeiten von Vorlagen - Suchen und Ersetzen (Skript)

Komplexe Textdokumente müssen möglicherweise etwas geändert werden, bevor sie in ein memoQ-Projekt importiert werden können. Diese Änderung oder Konvertierung wird als Vorverarbeitung bezeichnet und vor dem Importieren des Dokuments ausgeführt.

Wenn ein Dokument vor dem Import vorverarbeitet wird, muss es nach dem Export wieder geändert werden. Wenn Sie also vor dem Importieren eines Dokuments die Vorverarbeitung ausführen, müssen Sie nach dessen Export eine Nachbearbeitung vornehmen.

In den meisten Fällen müssen Sie nur einige Aktionen vom Typ "Suchen und Ersetzen" im Dokument ausführen. Manchmal müssen Sie dafür reguläre Ausdrücke verwenden. Sie können mit diesen experimentieren und die Änderungen in einem Texteditor für Entwickler (z. B. Notepad++ oder UltraEdit) anpassen.

Verwenden Sie für all dies das Skript "Suchen und Ersetzen", das in memoQ 8.1 und neueren Versionen enthalten ist. Mit dem Skript "Suchen und Ersetzen" können Sie eine Reihe von Aktionen vom Typ "Suchen und Ersetzen" in Dokumenten ausführen. In der Regel muss nichts programmiert werden. Sie müssen Ihre Aktionen vom Typ "Suchen und Ersetzen" mithilfe von regulären Ausdrücken in einer Konfigurationsdatei aufführen. Sie müssen nicht viel lernen – Sie müssen sich nicht mit C# oder PowerShell oder Python auskennen, "nur" mit regulären Ausdrücken.

Reine Textdokumente (Nur-Text): Das Skript "Suchen und Ersetzen" kann für von Menschen lesbare Dokumente verwendet werden: Nur-Text-Dokumente, tabellarische Textdateien (z. B. CSV), getaggte Dokumente (z. B. XML oder HTML) oder Quellcodedokumente (JSON, .properties etc.)

In diesem Thema wird Folgendes beschrieben:

  • Einrichten des Skripts "Suchen und Ersetzen" in memoQ oder memoQ-Server
  • Formulieren der Vorgänge zum Suchen und Ersetzen
  • Verwenden des Skripts "Suchen und Ersetzen" in einer Projektvorlage – für drei Anwendungsfälle: Vorverarbeitung (vor dem Importieren), Nachbearbeitung (nach dem Exportieren) und während eines Projekts (z. B. nach dem Importieren)

Vorbereiten von memoQ: Einrichten des Skripts "Suchen und Ersetzen" auf dem Computer

Das Skript "Suchen und Ersetzen" ist auf Ihrem Computer im Ordner C:\Program Files (x86)\Kilgray\FindReplace Tool installiert.

Der Ordner enthält das Programm FindAndReplace.exe sowie eine XML-Datei mit den Regeln für das Suchen und Ersetzen:

find-and-replace-local-folder

Auf Ihrem Computer ist das Skript "Suchen und Ersetzen" für die Verwendung bereit, wenn memoQ 8.1 oder höher installiert ist. Merken Sie sich den Ordnerpfad, da Sie ihn später verwenden müssen.

Möglicherweise benötigen Sie Administratorzugriff: Wenn Sie Änderungen an diesem Ordner vornehmen möchten (z. B. zum Bearbeiten der Regeln zum Suchen und Ersetzen), müssen Sie möglicherweise den Benutzernamen und das Kennwort eines Administrators eingeben. Wenn Sie nicht über den entsprechenden Zugriff verfügen, werden Sie vom Dienst User Account Control in Windows gewarnt.

Vorbereiten des memoQ-Servers: Einrichten des Skripts "Suchen und Ersetzen" auf dem Server-Computer

Administratorzugriff erforderlich: Dazu müssen Sie über Remote Desktop auf den memoQ-Server-Computer zugreifen und ein Administrator sein. Wenn Sie keine Administratorberechtigungen für den memoQ-Server-Computer besitzen, wenden Sie sich an den Systembetreiber Ihrer Organisation, und verweisen Sie ihn auf dieses Thema.

Einrichten von Dokumentkonvertierungen: Formulieren der Aktionen vom Typ "Suchen und Ersetzen" in Konfigurationsdateien

Das Tool "Suchen und Ersetzen" benötigt eine Konfigurationsdatei, damit es weiß, was zu suchen ist und wie der gefundene Text ersetzt werden soll.

Die Konfigurationsdatei muss sich im selben Ordner wie das Tool befinden. Damit Sie also die tatsächlichen Aktionen vom Typ "Suchen und Ersetzen" einrichten können, müssen Sie eine Konfigurationsdatei auf den Server-Computer kopieren oder die dort vorhandene Konfigurationsdatei bearbeiten.

Die Konfigurationsdatei ist nicht hartcodiert. Sie können eine Konfigurationsdatei auswählen, wenn Sie das Tool "Suchen und Ersetzen" aufrufen. Unabhängig davon, welche Konfigurationsdatei Sie auswählen, muss sich diese jedoch im Ordner auf dem Server-Computer befinden.

Sie können eine separate Konfigurationsdatei für jedes Dokumentformat verwenden, mit dem Sie arbeiten müssen. Oder Sie können eine einzige Konfigurationsdatei verwenden und einen separaten Abschnitt für jedes Format und jede Konvertierung schreiben.

Wenn Sie die automatisierte Aktion in der Projektvorlage einrichten, müssen Sie das Tool "Suchen und Ersetzen" aufrufen, und dann müssen Sie eine Konfigurationsdatei und einen Abschnitt innerhalb der Konfigurationsdatei auswählen.

Eine Konfigurationsdatei für "Suchen und Ersetzen" ist eine XML-Datei, in der Aktionen vom Typ "Suchen und Ersetzen" für ein Dokumentformat aufgeführt sind. Sie enthält verschiedene Abschnitte oder Anwendungsfälle (usecase-Elemente). Jeder Abschnitt oder Anwendungsfall bezieht sich auf eine der folgenden Aktionen:

  1. Konvertierungen vor dem Importieren des Dokuments (im Beispiel: PreImport),
  2. Konvertierungen nach dem Exportieren des Dokuments (im Beispiel: PostExport) oder
  3. Konvertierungen von Dokumenten während der Arbeit in memoQ: nach dem Importieren, Vorübersetzen oder Abschließen des Dokuments (im Beispiel: PostImport).

Sie können diese Anwendungsfälle beliebig benennen. Beispielsweise können Sie eine XML-Datei mit Import-Export-Konvertierungen für JSON sowie Import-Export-Konvertierungen für PO-Dateien haben. In diesem Fall sollten die Abschnitte für die einzelnen Anwendungsfälle mit JSON-PreImport, JSON-PostExport, PO-PreImport und PO-PostExport benannt werden.

Wenn Sie beim Import konvertieren, müssen Sie beim Export zurückkonvertieren: Wenn Sie PreImport-Konvertierungen ausführen, müssen Sie nach dem Export die umgekehrten Konvertierungen ausführen (PostExport).

Wie können Sie "Suchen und Ersetzen" für Dokumente ausführen, die sich bereits in einem Projekt befinden? Wenn Sie nach dem Dokumentimport eine benutzerdefinierte Aktion einrichten, konvertiert der memoQ-Server das Dokument in eine reine (nicht komprimierte) memoQ-XLIFF-Datei, führt sie über das von Ihnen angegebene Skript aus und importiert die geänderte XLIFF-Datei erneut in das Projekt – und dies alles im Hintergrund.

Sie müssen die Konfigurationsdatei nicht komplett neu formulieren. Der Ordner Find and Replace Tool oder FindReplace Tool enthält eine Beispielkonfigurationsdatei. Erstellen Sie zum Einrichten Ihrer eigenen Konvertierungen eine Kopie der Datei "example_config.xml". Ersetzen Sie die Konvertierungen in der Datei durch Ihre eigenen.

find-and-replace-script-one-use-case

Das Tool Suchen und Ersetzen unterstützt zwei Arten von Aktionen vom Typ "Suchen und Ersetzen": Sie können Nur-Text ersetzen, oder Sie können Text mithilfe von regulären Ausdrücken und Platzhaltern ersetzen.

Für jeden Anwendungsfall können Sie unterschiedliche Regeln zum Suchen und Ersetzen formulieren. Jede Regel wird in ein searchItem-Element geschrieben. Der Typ des searchItem-Elements ("text" oder "regex") definiert, ob Sie Nur-Text ersetzen oder reguläre Ausdrücke verwenden.

Jedes searchItem-Element enthält ein searchExpression- und ein replaceExpression-Element. Das searchExpression-Element muss genau einen Suchbegriff oder regulären Ausdruck für "Nur-Text" enthalten. Das replaceExpression-Element muss genau einen Nur-Text-Absatz oder eine Ersetzungsregel enthalten, die Platzhalter aus dem regulären Ausdruck im searchExpression-Element enthält.

Einrichten der Projektvorlage für die Verwendung des Tools "Suchen und Ersetzen"

Abschließende Schritte

So testen Sie das Skript Suchen und Ersetzen: Erstellen Sie ein Online-Projekt aus der Vorlage, die Sie gerade eingerichtet haben, und importieren Sie ein Dokument, das verarbeitet werden soll. Wenn das Dokument erfolgreich importiert wurde, checken Sie das Projekt aus, und öffnen Sie das Dokument für die Bearbeitung, um festzustellen, ob die Transformationen richtig waren.

Oder wenn Sie eine lokale Projektvorlage verwenden: Erstellen Sie ein lokales Projekt aus der Vorlage, die Sie gerade eingerichtet haben, und importieren Sie ein Dokument, das verarbeitet werden soll. Wenn das Dokument erfolgreich importiert wurde, öffnen Sie das Dokument für die Bearbeitung, um festzustellen, ob die Transformationen richtig waren.

So ändern Sie die Aktionen vom Typ "Suchen und Ersetzen": Bearbeiten Sie die XML-Datei, die Sie mit der Projektvorlage verwenden. (Wenn Sie eine Online-Vorlage verwenden, melden Sie sich über Remote Desktop beim memoQ-Server-Computer an.) Fügen Sie bei Bedarf Aktionen vom Typ "Suchen und Ersetzen" hinzu, oder ändern Sie sie. Sie müssen die Projektvorlage nicht ändern. Außerdem können Sie auch ein vorhandenen Projekt öffnen, das diese Vorlage verwendet, und neue Dateien importieren. Selbst dann werden von memoQ oder memoQ-Server die aktualisierten Aktionen vom Typ "Suchen und Ersetzen" verwendet.

Weitere Informationen zu Aktionen vom Typ "Suchen und Ersetzen" finden Sie im Abschnitt Einrichten von Konvertierungen weiter oben in diesem Thema.