Berichtenbundels (Message bundles) bevatten strings in sleutel-waarde JSON-formaat die een berichtengroep vertegenwoordigen die vertaald kan worden. Elke sleutel vertegenwoordigt een vertalingseenheid en de waarde is de vertaalseenheidbron die kan worden vertaald.

In tegenstelling tot vertaalbare pagina's hebben berichtenbundels geen vertaalpagina's.

Integratie van berichtenbundels inschakelen

Standaard is de integratie van de berichtenbundel uitgeschakeld. Om deze in te schakelen, moet u uw LocalSettings.php bijwerken:

$wgTranslateEnableMessageBundleIntegration = true;

Om de brontaal van de berichtenbundels anders te kunnen instellen dan de standaard wikitaal, met $wgPageLanguageUseDB:

$wgPageLanguageUseDB = true;

We raden ook aan om vertaalbeheerders de mogelijkheid te geven om het inhoudsmodel van pagina's te wijzigen (editcontentmodel rechts).

See Manual:$wgPageLanguageUseDB for more details.

Een berichtenbundel maken

Om een berichtenbundel te maken:

1. Begin met het maken van een wiki-pagina.
2. Voeg de JSON-inhoud toe waar de sleutel en de waarde beide strings zijn. De sleutel is de ID van de vertalingseenheid en de waarde is de vertaaleenheid bron.
3. Sla de pagina op.
4. Ga naar Pagina-informatie voor de nieuw aangemaakte pagina.
5. Wijzig het pagina-inhoudsmodel in Vertaalbare berichtenbundel. Dit is op Special:ChangeContentModel gedaan.

Voorbeeld van een berichtenbundel:

{
  "@metadata": {
    "sourceLanguage": "fr",
    "priorityLanguages": [
      "es",
      "en"
    ],
    "label": "Example message bundle",
    "description": "This is an example message bundle description."
  },
  "greetings": "hello",
  "body": "This is the body of the bundle.",
  "salutations": "Good bye",
  "signed": "Abijeet Patro"
}

De inhoud onder @metadata is niet vertaalbaar.

{
  "@metadata": {
	  "sourceLanguage": "fr"
  }
}

{
  "@metadata": {
	  "priorityLanguages": [ "es", "it", "hi", "or" ]
  }
}

{
  "@metadata": {
	  "label": "My message bundle title"
  }
}

{
  "@metadata": {
	  "description": "This is a sample description for the message bundle"
  }
}

Structuur van een berichtenbundel

Stel dat een berichtenbundel MB-2024 wordt gemaakt met de volgende structuur:

{ 
  "@metadata": {
	  "sourceLanguage": "fr"
  },
  "key-a": "hello",
  "key-b": "This is the body of the bundle.",
  "key-c": "Good bye"
}

De bovenstaande berichtenbundel heeft de brontaal fr.

Wanneer de berichtenbundel wordt gecreëerd worden automatisch de volgende pagina's aangemaakt:

• Translations:MB-2024/key-a/fr
• Translations:MB-2024/key-b/fr
• Translations:MB-2024/key-c/fr

Als key-a in het Engels wordt vertaald, wordt met de vertaling de pagina Translations:MB-2024/key-a/en gemaakt.

Berichtenbundels hebben geen vertaalpagina's.

Een berichtenbundel vertalen

Berichtenbundels staan niet op Special:PageTranslation. Ze kunnen worden vertaald door:

• Te kikken op ⧼⧽ bovenaan de pagina met berichtenbundel.
• Naar de pagina Special:Translate te gaan en te zoeken naar de naam van de wiki-pagina die is gemaakt in de component het groepsselector.

Een berichtenbundel verplaatsen

Dit proces is vergelijkbaar met het verplaatsen van vertaalbare pagina's. See the following documentation.

Een berichtenbundel verwijderen

Dit proces is vergelijkbaar met het verwijderen van vertaalbare pagina's. See the following documentation.

Nog op te pakken punten

1. Ervoor zorgen dat de vertaalstatistieken voor berichtenbundels werken (T360842)
2. Ervoor zorgen dat de berichtengroepstatistieken voor berichtenbundels werken
3. Implementatie fuzzy voor vertalingen die verouderd zijn
4. De optie geven om niet fuzzy vertalingen voor berichtenbundel mee te geven wanneer de bronstrings veranderen (T317736)
5. Een pagina maken waar berichtenbundels kunnen worden bekeken zoals Special:PageTranslation (mogelijk kan kern een manier bieden om alle pagina's met een bepaald inhoudsmodel te vermelden?)
6. Verander het weergaveformaat van de berichtenbundel bronpagina's om JSON op een goed geformatteerde manier te weergeven.
7. Verwijder tags van de pagina van de berichtenbundel wanneer het inhoudsmodel wordt gewijzigd naar iets anders uit de vertaalbare berichtenbundel.