Help:Extension:Translate/Groepsconfiguratie

This page is a translated version of the page Help:Extension:Translate/Group configuration and the translation is 100% complete.

Documentatie voor Extension:Translate/nl

Vertalers (Hoofdpagina help )

Vertalingenbeheerders

Systeembeheerders en ontwikkelaars

Vertaal dit sjabloon

Er zijn veel manieren om berichtengroepen toe te voegen aan de extensie Translate. Berichtengroepen zijn verzamelingen berichten. Meestal bevatten ze berichten van één module in software en één bestand (en meestal één per taal bij vertalingen). Het is ook mogelijk om groepen te maken die berichten van andere berichtengroepen 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.

Berichtengroepen 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 berichtengroepen.

Standaard groepsconfiguratie

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

wfAddNamespace( 1218, 'FUDforum' );
$wgTranslateGroupFiles[] = "$IP/messagegroups/FUDforum/FUDforum.yml";

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 berichtengroepen 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: BASIC, FILES, MANGLER, VALIDATORS, INSERTABLES, TAGS, AUTOLOAD, LANGUAGES 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 sleutels (verplichte sleutels zijn gemarkeerd met *):

Key	Beschrijving
namespace*	Namespace-id, constante of tekenreeks waar de berichten zijn opgeslagen. De namespace moet vooraf worden toegevoegd. Zie het bovenstaande voorbeeld.
icon	Pictogram voor de berichtengroep. Kan elk bestand ondersteunen dat MediaWiki aankan en dat is geüpload naar MediaWiki. Ondersteunt ook bestanden van gedeelde media repository's.
id*	Unieke id die deze berichtengroep identificeert.
label*	Voor mensen leesbare naam van de berichtengroep.
description	Beschrijving van deze berichtengroep. Er wordt een volledige wiki-syntaxis gebruikt.
class*	Het type van deze berichtengroep, meestal `FileBasedMessageGroup` of `AggregateMessageGroup`.
meta	Meerdere toepassingen. Als er identieke berichtensleutels zijn voor verschillende berichtengroepen (meestal in het geval van vertakkings- of subsetberichtengroepen), kan slechts één groep primair zijn en moeten de andere groepen `meta` hebben met een waarde van `yes`.
sourcelanguage	Taalcode van de brontaal. Standaard ingesteld op en (Engels).
codeBrowser	Alleen gebruikt in formaat Gettext. URL-patroon van een online viewer voor de repository-bestanden (en), waarbij `%FILE%` en `%LINE%` worden vervangen door het relevante bestandspad en de regel - zoals vermeld in PO-bestandsopmerkingen voor een bericht - om vertalers een informatieve link te geven binnen de vertaalhulpmiddelen voor dat bericht. Voorbeeld: `https://github.com/lonvia/waymarked-trails-site/blob/master/django/%FILE%#L%LINE%`
support	Hiermee configureert u waar de knop "Hulp vragen" de vertaler naar toe leidt. U moet `url` of `page` en optioneel `params` opgeven om de URL-parameters te configureren. In parameters kunt u `%MESSAGE%` gebruiken als tijdelijke aanduiding voor de naam van het bericht.

Voorbeeld:

BASIC:
  id: out-freecol
  label: FreeCol
  icon: wiki://Freecol.png
  description: "{{int:bw-desc-freecol}}"
  namespace: NS_FREECOL
  class: FileBasedMessageGroup
  support:
    url: 
    params:
      title: "Translation issue with message %MESSAGE%"
      body: "[**URL**](https://translatewiki.net/wiki/%MESSAGE%)"

BESTANDEN

Dit gedeelte beschrijft de lay-out van het bestandssysteem en het formaat van de berichtenbestanden voor groepen van type FileBasedMessageGroup. Lijst met mogelijke sleutels (verplichte sleutels zijn gemarkeerd met *):

Key	Beschrijving
format*	Formaat van berichtbestanden. Voorbeelden: `Yaml`, `Java`, `FlatPhp` (voor een volledige lijst, zie `FORMATS` in FileFormatFactory.php).
class	Class die het formaat van berichtbestanden definieert. Ontraden in Translate 2023.07 ten gunste van `format`.
codeMap	Lijst van taalcodes die verschillen van die die in MediaWiki worden gebruikt. Gebruik de MediaWiki-taalcode als key en de doeltaalcode as de waarde.
sourcePattern*	Plaats van de berichtenbestanden. Pad variabelen worden ondersteund.
targetPattern	Hoe de geëxporteerde bestanden worden genoemd in verhouding tot de export-map. Pad variabelen worden ondersteund.
definitionFile	Gebruik dit om de locatie van het definitiebestand (met de Engelse bronberichten) te definiëren als het niet aan het sourcePattern voldoet. Pad variabelen worden ondersteund.
`Apple`	Formaat-specifieke sleutels
header	Aangepast commentaar in de kop van het bestand.
`FlatPhp`	Formaat-specifieke sleutels
header	Aangepaste koptekst bestand. Als het niet wordt gegeven, is de standaard `<?php`
`Gettext`	Formaat-specifieke sleutels
CtxtAsKey	Speciale modus waarbij ctxt wordt gebruikt als berichtsleutel. Mag niet worden gebruikt voor normale Gettext bestanden.
header	Aangepast commentaar in de kop van het bestand.
keyAlgorithm	Toegestane waarden: 'legacy' en 'simple'. - De standaard is 'simple', dit geeft kortere berichtsleutels.
`Java`	Formaat-specifieke sleutels
header	Aangepast commentaar in de kop van het bestand.
keySeparator	Het karakter dat sleutel en waarde scheidt. De standaard is `=`. Het kan ook `:` zijn.
`Json`	Formaat-specifieke sleutels
nestingSeparator	Het karakter dat niveaus scheidt wanneer geneste objecten worden afgeplat in een sleuteltekst. De standaard afplatting wordt niet gedaan. Voorbeeld: `{ "top": { "nested": "content" } }` wordt omgezet in (verondersteld / als scheidingsteken) bericht met de sleutel `top/nested` en de waarde `content`.
includeMetadata	Of de @metadata sleutel met auteursgegevens in de geëxporteerde bestanden moet worden opgenomen. Standaard ingesteld op true.
parseCLDRPlurals	Of CLDR meervoudige zoekwoorden wordt geanalyseerd. Standaard wordt dit niet gedaan.
`Yaml`	Formaat-specifieke sleutels
codeAsRoot	Als de waarde `1` wordt ingesteld, zijn alle berichten onder een taalcode (in plaats van bij de root).
nestingSeparator	Het karakter dat niveaus scheidt wanneer geneste objecten worden afgeplat in een sleuteltekst. Dit wordt standaard niet gedaan. Voorbeeld: `.` wordt omgezet in (verondersteld `.` als scheidingsteken) bericht met de sleutel `top.nested` en de waarde `content`.
parseCLDRPlurals	Of CLDR meervoudige zoekwoorden wordt geanalyseerd. Standaard wordt dit niet gedaan.

De padvariabelen zijn:

Variabele	Beschrijving
%CODE%	Taalcode (afhankelijk van codeMap)
%MWROOT%	Pad naar de MediaWiki-installatie
%GROUPROOT%	Gedefinieerd door $wgTranslateGroupRoot.
%GROUPID%	Berichtengroep-id

Voorbeeld:

FILES:
  format: Java
  sourcePattern: %GROUPROOT%/commonist/messages_%CODE%.properties
  targetPattern: commonist/messages_%CODE%.properties

MANGLER

Mangler is een manier om berichtsleutels te omarmen om conflicterende berichtsleutels in meerdere groepen te voorkomen:

Key	Beschrijving
class*	Welke soort mangler te gebruiken. Voorbeeld: StringMatcher
StringMatcher	Class specifieke sleutels
patterns*	Lijst van patronen. "*" kan als wildcard worden gebruikt.
prefix*	Als de bovenstaande patronen overeenkomen met een bericht, wordt de berichtsleutel voorafgegaan door dit voorvoegsel.

Voorbeeld:

MANGLER:
  class: StringMatcher
  patterns:
    - "*"

VALIDATORS

In dit gedeelte wordt vooraf gedefinieerde of aangepaste validators gedefinieerd.

VALIDATORS:
  # vooraf gedefinieerde validator
  - id: InsertableRegex
    enforce: true
    insertable: true
    params: /\$[a-z0-9]+/
  # aangepaste validator
  - class: MyCustomValidator
    enforce: true

AUTOLOAD:
  MyCustomValidator: Validator.php

INSERTABLES

Dit gedeelte stelt het mogelijk om een class te definiëren die insertables voorstelt of vooraf gedefinieerde insertables te gebruiken. De classes kunnen automatisch worden geladen zoals beschreven in de sectie AUTOLOAD.

INSERTABLES:
  # vooraf gedefinieerde insertable
  - class: HtmlTagInsertablesSuggester
  # aangepaste insertable
  - class: FreeColInsertablesSuggester

AUTOLOAD:
  FreeColInsertablesSuggester: Insertable.php

AUTOLOAD

Dit item neemt de lijst van class namen met bestandsnamen als waarden. Op deze manier kunnen aangepaste classes gemakkelijk worden gebundeld met uw aangepaste berichtengroepen. Het pad moet relatief zijn tot de locatie van het groepsconfiguratiebestand zelf.

Voorbeeld:

AUTOLOAD:
  ShapadoMessageChecker: Checker.php

SJABLOON

Er is een handige snelkoppeling als u meerdere vergelijkbare berichtengroepen definieert. Om herhaling te voorkomen, moet de eerste definitie beginnen met deze sleutel. U kunt alle andere top-level sleutels gebruiken als sub-sleutels voor dit item. Alle andere groepen gebruiken deze definities als standaardwaarden. Elke groep kan uiteraard de standaardwaarde uit het sjabloon overschrijven.

Voorbeeld:

TEMPLATE:
  BASIC:
    namespace: NS_SHAPADO
    class: FileBasedMessageGroup
    description: "{{int:bw-desc-shapado}}"

  FILES:
    format: Yaml
    codeAsRoot: 1
    codeMap:
      be-tarask: be-TARASK

GROEPEN (voor klasse AggregateMessageGroup)

Deze sleutel bevat alleen de lijst van groep-ID's waar deze berichtengroep uit bestaat.

Voorbeeld:

GROUPS:
  - out-shapado-ads
  - out-shapado-announcements
  - out-shapado-answers
  - out-shapado-badges

Wildcards worden ondersteund. In dit geval zal de geaggregeerde groep zichzelf niet recursief opnemen, zelfs als deze overeenkomt met een patroon. Voorbeeld:

GROUPS:
  - out-shapado-*

Wildcards kunnen problematisch zijn als u geïntegreerde geaggregeerde groepen heeft, omdat sommige groepen meerdere keren kunnen worden opgenomen: zowel direct als via de opgenomen groepering bij het aggregeren.

TALEN

Deze key maakt het mogelijk om vertalingen in specifieke talen voor de groep toe te staan en te verbieden. Verboden vertalingen (op taal) zullen worden geblokkeerd.

LANGUAGES:
  include:
    - en
  exclude:
    - he
    - or

Waarschuwing:

MLEB 2021.10: De onderstaande configuratie wordt niet meer ondersteund

LANGUAGES:
  whitelist:
    - en
  blacklist:
    - he
    - or

Toegestane ("include") records overschrijven alle waarden in de lijst van niet toegestane ("exclude") records. Als een * een toegestaan record is, betekent dat alle talen toegestaan zijn. De toegestane lijst is ook optioneel.

Berichtengroepen voor interfaceberichten die specifiek zijn voor uw wiki

Voorbeeld van berichtengroep voor aangepaste gebruikersinterface van de wiki, bijvoorbeeld voor vertaalde zijbalk. Voeg de volgende code toe aan uw LocalSetting.php en vervang de wiki-naam door iets betekenisvols.

$wgHooks['TranslatePostInitGroups'][] = function ( &$list, &$deps, &$autoload ) {
	$id = 'wiki-custom';
	$mg = new WikiMessageGroup( $id, 'wikiname-messages' );
	$mg->setLabel( 'Wikiname User Interface Messages' );
	$mg->setDescription( 'This group contains user interface messages used on Wikiname.' );
	$list[$id] = $mg;
};

Snelkoppelingen voor MediaWiki extensies

Zie groepseenheden voor MediaWiki.

Key	Beschrijving
optional	Deze berichten worden niet standaard weergegeven en worden bij het berekenen van vertaalpercentages niet als niet vertaalde berichten gerekend.
ignored	Deze berichten worden helemaal niet getoond.