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: GRUND-INFORMATION, DATEIEN, MANGLER, CHECKER, ERWEITERUNGEN, TAGS, AUTOLOAD, SPRACHEN 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:

PRÜFER
PRÜFER überprüft die übersetzten Nachrichten. Wenn er Probleme findet, werden diese für Übersetzer markiert.

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 AUTOLADEN 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:

AUTOLOAD
This item takes list of class names with filenames as values. This way custom classes can be bundled easily with your custom message groups. The path should be relative to the location of the group configuration file itself.

Beispiel:

TEMPLATE
There is a handy shortcut if you are defining multiple similar message groups. To avoid repetition, have the first definition start with this key. You can use any other top-level keys as subkeys for this item. All other groups will use these definitions as default values. Each group can of course override the default value from the template.

Beispiel:

GROUPS (for AggregateMessageGroup class)
This key only takes list of group ids this message group consists of.

Beispiel:

Wildcards are supported. In this case the aggregate group will not recursively include itself even if it matches a pattern. Example:

Wildcards can be problematic if you have nested aggregate groups, because some groups can be included multiple times: both directly and via the included aggregate groups.

LANGUAGES
This key allows white listing and black listing of languages for the group. Blacklisted languages will not be allowed for translation.

Whitelist overrides any values in the blacklist. If whitelist value is  that means all languages are allowed. Whitelist is also optional.

Message groups for interface messages specific to your wiki
Example of message group for custom user interface of the wiki, for example for localized sidebar. Add the following code into your  and replace wikiname with something meaningful.

Shortcut for MediaWiki extensions
See units group for MediaWiki.