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
This insertable will display suggestion for any HTML tags found inside the source string.

For example:


 * Message: This linklink takes you to the home page.
 * Suggester displayed:

MediaWikiInsertablesSuggester
This insertable will display various suggestion for MediaWiki related wikitext messages. These include suggestion for,


 * Parameters like  which are present in API Help messages.
 * Suggestions for HTML tags.

NumericalParameterInsertablesSuggester
This insertable will display suggestions for numerical parameters such as,  , or

RegexInsertablesSuggester
This insertable is a general purpose insertable that can be used to display suggestions based on a custom regular expression.

Example:

Parameter description,


 * regex - The regex to use for identifying insertables. Verplicht.
 * display - What to show to the user. Not mandatory, defaults to matched value.
 * 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: