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 - Wat voor de selectie toe te voegen of het de selectie vervangen als  leeg blijft Niet verplicht, de overeenkomende waarde wordt de standaard.
 * post - Wat na de selectie toe te voegen. Niet verplicht, de overeenkomende waarde wordt de standaard.

TranslatablePageInsertablesSuggester
Voornamelijk gebruikt op vertaalbare pagina's voor het aan de suggester geven van variabelen als.

UrlInsertablesSuggester
Deze insertable vindt URL's (die meestal bij vertaling niet gewijzigd worden) en stelt een wijziging voor, zodat constanten niet per ongeluk vertaald worden.



Een eigen insertable toevoegen
Als de beschikbare insertables niet aan uw behoeften voldoen dan kunt u er ook een of meer toevoegen.

Een voorbeeld met het toevoegen van een voor het ondersteunen van een bestaande berichtengroep gebaseerd op bestanden: FreeCol. Het YAML-bestand wordt wat verkort weergeven, het is bedoeld als voorbeeld. De toegevoegde regels zijn gemarkeerd.

FreeCol.yaml:

Suggester.php:

De parameters voor Insertable zijn: