Hilfe:Erweiterung:Übersetzen/Nachrichtengruppen

Nachrichtengruppen stellen eine Sammlung von Nachrichten dar. Sie besitzen eine Beschreibung und geben den Namensraum vor, in dem Nachrichten gespeichert werden, wie sie exportiert werden können (normalerweise über FFS), wie die Definitionen geladen werden (aus Wikiseiten oder über FFS) und andere Dinge.

Nachrichtengruppen-Hierarchie

Vererbungsdiagramm für Klassen von Nachrichtengruppen, die über die Übersetzungserweiterung definiert werden

MessageGroupBase (*1)

• AggregateMessageGroup
• FileBasedMessageGroup
  • SingleFileBasedMessageGroup
    • MediaWikiExtensionMessageGroup
  • MediaWikiMessageGroup

MessageGroupOld (*1)

• CoreMessageGroup
  • CoreMostUsedMessageGroup
• WikiMessageGroup
  • RecentMessageGroup
    • RecentAdditionsMessageGroup
  • SvgMessageGroup (*2)
  • WikiPageMessageGroup (*3)
  • WorkflowStatesMessageGroup

(*1) MessageGroupBase ist die neuere Basisklasse. Diese Gruppen werden normalerweise über die Yaml-Konfiguration definiert, während die auf MessageGroupOld aufbauenden auf anderen Wegen definiert werden. Core*MessageGroup ist für MediaWiki und soll nach FileBasedMessageGroup migriert werden.

(*2) In der Erweiterung TranslateSvg.

(*3) Enthält die Funktion zur Seitenübersetzung .

Hauptfunktionen

Basisinfo. Jede Nachrichtengruppe hat eine (innerhalb des Wikis) einzigartige ID, eine Bezeichnung (Kurzname) und eine Kurzbeschreibung, die wichtige Informationen wie die Lizenz und einen Link auf eine Seite mit weiteren Informationen enthält.

Namensraum. Alle Definitionen von Nachrichten und Übersetzungen befinden sich in einem von der Nachrichtengruppe festgelegten Namensraum. Die Datei-basierten Nachrichtengruppen ermöglichen es Benutzern, den Namensraum festzulegen, wohingegen die anderen Namensräume an NS_TRANSLATIONS (Seitenübersetzung) oder NS_MEDIAWIKI gebunden sind.

Prüfungen. Nachrichtengruppen können eine Reihe von Nachrichtenprüfungen umfassen, die Benutzer warnen können, wenn es in der Übersetzung Fehler gibt. Verbreitet sind Prüfungen auf fehlende oder unbekannte Variablen und ungültige HTML.

Mangler. Jede Gruppe besitzt einen Nachrichtenschlüssel-Mangler. Er ist nur wichtig für Datei-basierte Nachrichtengruppen, bei denen das Format der Nachrichtenschlüssel nicht durchgesetzt werden kann. Siehe den Abschnitt zu Manglern unten.

Nachrichten laden. Es gibt viele Möglichkeiten, um Nachrichtendefinitionen zu laden. Bei der Lade-Methode werden normalerweise die Nachrichten aus Dateien über die FFS-Klasse oder aus einer Datenbank-Tabelle ausgelesen. getDefinitions ist ein Kurzbefehl für das Laden der Nachrichten in der Ausgangssprache (siehe unten).

Ausgangssprache. Es wird erwartet, dass alle Nachrichtendefinitionen in der gleichen Sprache vorliegen. Nur dynamische Nachrichtengruppen wie RecentMessageGroup können diese Einschränkung umgehen.

Tags. Nachrichten können Tags besitzen. Die Tags ignored und optional werden häufig genutzt. Außerdem gibt es für Nachrichtensammlungen eigene, zusätzliche Tags.

Arbeitsablauf-Zustände. Nachrichtengruppen können die globalen Arbeitsablauf-Zustände überschreiben.

Sprachen. Standardmäßig werden Übersetzungen für alle bekannten Sprachen akzeptiert. Die Nachrichtengruppe kann eine Teilmenge von Sprachen vorgeben, um die Übersetzung in andere Sprachen zu deaktivieren.