Help:Extension:Translate/Insertables/nl

Vertaalbare teksten bevatten vaak opmaak die niet vertaald moeten worden, maar zo moet blijven staan. Het invoeren van die opmaak kan lastig zijn door de gebruikte tekens en de complexe opbouw. Insertable is een deel van de opmaak die voor de vertalers als een knop of een andere element beschikbaar is. Door het klikken op die knop wordt een stukje opmaak toegevoegd in de vertaling op de plek waar de cursor dan staat.

Elke vertaalgroep kan een  hebben. Deze class zorgt voor het genereren van een lijst van. Een  bestaat uit drie gedeelten.


 * 1) Het gedeelte wat de gebruiker ziet
 * 2) het gedeelte wat voor de cursor wordt toegevoegd in de vertaling of wat de geselecteerde inhoud vervangt.
 * 3) Het gedeelte wat na de cursor wordt toegevoegd.

De Translate extensie komt ingebouwd met. Andere mogelijke inhoudstypes staan in de translatewiki.net git repository.



Configuratie
Een voorbeeld met een configuratie wijziging in een YAML-bestand,



Gebundelde / aangeboden insertables
Een lijst met gebundelde insertables.

HtmlTagInsertablesSuggester
Deze insertable zal een suggestie tonen voor elke HTML-tag in de brontekst.

Bijvoorbeeld:


 * Bericht: This linklink takes you to the home page.
 * Suggester zal tonen:

MediaWikiInsertablesSuggester
Deze insertable zal suggesties voor MediaWiki gerelateerde wikitext tonen. Dit ook voor:


 * Parameters zoals  die voorkomen in de API Help-teksten.
 * Suggesties voor HTML-tags.
 * Suggesties voor HTML-tags.

NumericalParameterInsertablesSuggester
Deze insertable zal suggesties voor numerieke parameters tonen zoals,   en

RegexInsertablesSuggester
Deze insertable is een algemene insertable die gebruikt kan worden voor het tonen van suggesties gebaseerd op een reguliere expressie.

Voorbeeld:

Parameter beschrijving


 * regex - De voor het identificeren van insertables te gebruiken regex. Verplicht.
 * display - Wat te tonen aan de gebruiker. Niet verplicht, de overeenkomende waarde wordt de standaard.
 * pre - What to insert before selection, or replace selection if  remains empty Not mandatory, defaults to matched value.
 * post - What to insert after selection. Not mandatory, defaults to matched value.

TranslatablePageInsertablesSuggester
Used primarily on translatable pages to provide suggester for variables like.

Adding a custom insertable
In case existing insertables are not sufficient to meet your requirements, it is possible to add custom insertables.

Here is an example about adding insertables support for existing file based message group: FreeCol. The YAML file has been trimmed for brevity. The newly added lines are highlighted.

FreeCol.yaml:

Suggester.php:

The parameters to Insertable are: