Help:Extension:Translate/Group configuration/nl

Er zijn veel manieren om berichtgroepen toe te voegen aan de extensie Translate. Berichtengroepen zijn verzamelingen berichten. Meestal vergelijken ze zich met één module in een software en één bestand (en meestal één per taal voor vertalingen). Het is ook mogelijk om groepen te maken die berichten van andere berichtgroepen bevatten. Er kan bijvoorbeeld een groep zijn die alle berichten in een bepaalde software bevat. Groepen kunnen ook alleen subsets van berichten bevatten, zoals de belangrijkste berichten van de MediaWiki die het eerst moeten worden vertaald. Deze groepen op een hoger niveau worden niet rechtstreeks toegewezen aan bestanden in een bepaald formaat, maar zoals alle groepen kunnen ze worden geëxporteerd in Gettext-indeling voor gebruik in andere vertaalhulpmiddelen.

Berichtgroepen zijn de blokken op hoog niveau waarmee vertalers communiceren: om een bericht te kiezen om aan te werken, moeten ze eerst een groep selecteren, tenzij ze vertaalzoeken gebruiken. Voor elke groep kunnen we statistieken verzamelen en elke groep heeft een unieke identifier. Natuurlijk zijn berichten de kleinste blokken tekst die vertalers één voor één vertalen. Elk bericht heeft ook een id, die meestal een key wordt genoemd. De key hoeft niet uniek te zijn voor alle berichtgroepen.



Standaard groepsconfiguratie
Het is eenvoudig om met behulp van het YAML-formaat berichtgroepen toe te voegen. Het enige dat u hoeft te doen, is een namespace te definiëren en een configuratiebestand toevoegen aan ; Zie de Configuratiie pagina voor meer details. Voorbeeld:

Het bestand zelf gebruikt de YAML-syntaxis. De syntaxis zelf wordt hier niet beschreven, maar het is gemakkelijk te leren en alle vooraf gemaakte groepen kunnen als voorbeelden worden gebruikt. Vergeet niet om spaties te gebruiken in plaats van tabs voor inspringing. Elk bestand kan meerdere berichtgroepen definiëren. Elke groepsdefinitie wordt gescheiden door een regel met drie streepjes, wat het standaard documentscheidingsteken is in YAML.

Definities zijn onderverdeeld in enkele items op het hoogste niveau: BASICFILESMANGLERVALIDATORSINSERTABLESTAGSAUTOLOADLANGUAGES en speciaal TEMPLATE. Sommige aangepaste groepen kunnen meer items op het hoogste niveau toevoegen. Niet alle groepen hoeven ze allemaal te definiëren.

Basis
Deze sectie bevat basisinformatie over de groep, zoals unieke id en naam. Lijst met mogelijke keys (verplichte keys zijn gemarkeerd met *):

Example:

FILES
This section describes the filesystem layout and format of message files for groups of type FileBasedMessageGroup. List of possible keys (mandatory keys are marked with *):

The path variables are:

Example:

MANGLER
Mangler is a way to mungle message keys to avoid conflicting message keys in multiple groups:

Example:

VALIDATORS
This section allows to define pre-defined or custom validators.

INSERTABLES
This section allows to define a class which suggests insertables or use pre-defined insertables. The classes can be autoloaded as described in the AUTOLOAD section.

TAGS
It is possible to assign tags to messages. Each tag takes list of message keys (after mangling). "*" can be used as wildcard. The following tags are supported:

Example:

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.

Example:

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.

Example:

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

Example:

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 makes it possible to allow and disallow translation into specific languages for the group. Translation into disallowed languages will be blocked.

Allowed ("include") entries override any values in the disallowed ("exclude") list. If an allowed entry is  that means all languages are allowed. The allowed list 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.