Help:Extension:Translate/Group configuration/de

Es gibt viele Möglichkeiten, Nachrichtengruppen zur Erweiterung "Übersetzen" hinzuzufügen. Nachrichtengruppen sind Ansammlungen von Nachrichten. Normalerweise vergleichen sie ein Modul in einer Software und eine Datei (und normalerweise eine pro Sprache für Übersetzungen). Es ist auch möglich, Gruppen zu erstellen, die Nachrichten aus anderen Nachrichtengruppen enthalten. Beispielsweise kann es eine Gruppe geben, die alle Nachrichten in einer bestimmten Software enthält. Gruppen können auch nur Teilmengen von Nachrichten enthalten, z. B. die wichtigsten Nachrichten von MediaWiki, die zuerst übersetzt werden sollen. Diese übergeordneten Gruppen werden nicht direkt Dateien in einem bestimmten Format zugeordnet, sondern können wie alle Gruppen zur Verwendung in anderen Übersetzungstools im Gettext-Format exportiert werden.

Nachrichtengruppen sind die übergeordneten Blöcke, mit denen Übersetzer interagieren: Um eine zu bearbeitende Nachricht auszuwählen, müssen sie zuerst eine Gruppe auswählen, es sei denn, sie verwenden die Übersetzungssuche. Für jede Gruppe können wir Statistiken sammeln und jede Gruppe hat eine eindeutige Kennung. Nachrichten sind natürlich die kleinsten Textblöcke, die Übersetzer einzeln übersetzen. Jede Nachricht hat auch eine Kennung, die normalerweise als "Schlüssel" bezeichnet wird. Der Schlüssel muss nicht für alle Nachrichtengruppen eindeutig sein.



Standard-Gruppenkonfigurationsformat
Es ist einfach, Nachrichtengruppen im YAML-Format hinzuzufügen. Du musst lediglich einen Namensraum definieren und eine Konfigurationsdatei zu  hinzufügen. Weitere Informationen findest Du auf der Konfigurationsseite. Beispiel:

Die Datei selbst verwendet die YAML-Syntax. Die Syntax selbst wird hier nicht beschrieben, ist jedoch leicht zu erlernen, und alle vorgefertigten Gruppen können als Beispiele verwendet werden. Denke daran, Leerzeichen anstelle von Tabulatoren zum Einrücken zu verwenden. Jede Datei kann mehrere Nachrichtengruppen definieren. Jede Gruppendefinition wird durch eine Linie mit drei Bindestrichen getrennt. Dies ist das Standard-Dokumententrennzeichen in YAML.

Die Definitionen sind in einige Elemente der obersten Ebene unterteilt: BASICFILESMANGLERVALIDATORSINSERTABLESTAGSAUTOLOADLANGUAGES und Spezial VORLAGE. Einige benutzerdefinierte Gruppen können weitere Elemente der obersten Ebene hinzufügen. Nicht alle Gruppen müssen alle definieren.

GRUND-INFORMATION
Dieser Abschnitt enthält grundlegende Informationen zur Gruppe, z. B. eine eindeutige ID und einen eindeutigen Namen. Liste der möglichen Schlüssel (Pflichtschlüssel sind mit * gekennzeichnet):

Beispiel:

DATEIEN
In diesem Abschnitt werden das Dateisystemlayout und das Format von Nachrichtendateien für Gruppen des Typs FileBasedMessageGroup beschrieben. Liste der möglichen Schlüssel (Pflichtschlüssel sind mit * gekennzeichnet):

Die Pfadvariablen sind:

Beispiel:

MANGLER
Mangler ist eine Möglichkeit, Nachrichtenschlüssel zu mischen, um Konflikte durch Nachrichtenschlüssel in mehreren Gruppen zu verhindern:

Beispiel:

VALIDATOREN
Dieser Abschnitt erlaubt die Definition vordefinierter oder benutzerdefinierter Validatoren.

EINSETZELEMENTE
Dieser Abschnitt erlaubt die Definition einer Klasse, die Einsetzelemente vorschlägt oder vordefinierte Einsetzelemente nutzt. Diese Klassen können wie im Abschnitt AUTOLOAD beschrieben automatisch geladen werden.

TAGS
Es ist möglich, Nachrichten Tags zuzuweisen. Jeder Tag übernimmt (nach dem Mangling) eine Liste von Nachrichtenschlüsseln. "*" kann als Platzhalter verwendet werden. Die folgenden Tags werden unterstützt:

Beispiel:

AUTOLADEN
Dieses Objekt listet Klassennamen mit Dateinamen als Werten auf. Auf diese Weise können benutzerdefinierte Klassen einfach mit benutzerdefinierten Nachrichtengruppen gebündelt werden. Der Pfad sollte relativ zum Ort der Gruppenkonfigurationsdatei selbst liegen.

Beispiel:

VORLAGE
Es gibt eine einfache Abkürzung, wenn du mehrere ähnliche Nachrichtengruppen definierst. Beginne die erste Definition mit diesem Schlüssel, um Wiederholungen zu vermeiden. Du kannst alle anderen übergeordneten Schlüssel als Unterschlüssel für dieses Objekt verwenden. Alle anderen Gruppen werden diese Definitionen als Standardwerte nutzen. Natürlich kann jede Gruppe den Standardwert aus der Vorlage überschreiben.

Beispiel: 

GRUPPEN (für AggregateMessageGroup-Klasse)
Dieser Schlüssel listet nur Gruppen-IDs auf, aus denen diese Nachrichtengruppe besteht.

Beispiel:

Platzhalter werden unterstützt. In diesem Fall wird die aggregierte Gruppe selbst nicht rekursiv eingebunden, selbst wenn sie mit dem Muster übereinstimmt. Beispiel:

Platzhalter können problematisch sein, wenn du verschachtelte aggregierte Gruppen hast, da einige Gruppen mehrfach eingebunden sein können: sowohl direkt als auch über die eingebundenen aggregierten Gruppen.

SPRACHEN
Dieser Schlüssel erlaubt das Whitelisten und Blacklisten von Sprachen für die Gruppe. Blacklisten einer Sprache führt dazu, dass es nicht erlaubt ist, in diese Sprache zu übersetzen.

Erlaubte ("include") Werte überschreiben jeden Wert in der Ausgeschlossenen ("exclude") Liste. Wenn der Erlaub-Wert  ist, bedeutet das, dass alle Sprachen erlaubt sind. Die Erlaub-Liste ist ebenfalls optional.



Nachrichtengruppen für spezifische Benutzeroberflächennachrichten deines Wikis
Beispiel einer Nachrichtengruppe für benutzerdefinierte Benutzeroberflächen eines Wikis, beispielsweise für eine lokalisierte Seitenleiste. Füge den folgenden Code in deine  ein und ersetze wikiname durch etwas bedeutenderes.



Abkürzung für MediaWiki-Erweiterungen
Siehe Einheitengruppe für MediaWiki.