Help:Extension:Translate/Insertables/de

Zu übersetzende Zeichenfolgen enthalten häufig Markups, die in der Übersetzung unverändert beibehalten werden sollen. Das Eingeben dieses Markups kann zeitaufwändig und schwierig sein, da häufig Sonderzeichen vorkommen. Einfügbar ist eine Markierung, die dem Übersetzer als Schaltfläche oder anderes Oberflächenelement angezeigt wird. Durch Klicken auf die Schaltfläche wird ein Markup-Befehl in die Übersetzung an der aktuellen Cursorposition eingefügt.

Jede Nachrichtengruppe kann einen  (Übersetzungsvorschlag) enthalten. Diese Klasse ist für das Generieren einer Liste von s verantwortlich. Jeder  besteht aus drei Teilen:


 * 1) Was dem Benutzer angezeigt werden soll
 * 2) Was wird vor der Cursorposition in der Übersetzung eingefügt?
 * 3) Was wird nach der Cursorposition in der Übersetzung eingefügt?

Die Übersetzungs-Erweiterung ist in  integriert. Vorschläge für andere Arten von Inhalten findest Du im translatewiki.net git repository.

Konfiguration
Hier ein Beispiel für eine Konfigurationsänderung in einer YAML-Datei,

Vorgefertigte / gebündelte Einfügungen
Nachfolgend findest du eine Liste der gebündelten Einfügungen.

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. Mandatory.
 * display - What to show to the user. Not mandatory, defaults to matched value.
 * pre - What to insert before selection. 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.

Im Folgenden findest Du ein Beispiel für das Hinzufügen einer Einfügungs-Unterstützung für eine vorhandene dateibasierte Nachrichtengruppen: FreeCol. Die YAML-Datei wurde der Kürze halber gekürzt. Die neu hinzugefügten Zeilen werden hervorgehoben.

FreeCol.yaml:

Suggester.php:

Die Parameter für Einfügungen sind: