Help:Extension:Translate/Insertables/cs

Překládané řetězce často obsahují značky, které bychom chtěl u překladu zachovat tak jak jsou. Zápis značek do překladu může být pro překladatele problematický, obzvláště, pokud jsou použity nějaké speciální znaky, co nejsou moc běžné, a tím pádem zpomaluje jejich práci. A zástupné elementy, které se překladateli zobrazují jako tlačítka u překládané zprávy, psaní zjednodušují, protože zastupují kusy kódu. Do překladu je lze buď rovnou napsat, nebo na příslušné místo kde se zrovna nalézá kurzor, vložit kliknutím na zobrazené tlačítko.

Pro každou skupinu zpráv existuje instance třídy. Tato třída obsahuje seznam zástupných elementů (třídy ). A každá třída  má tři části:


 * 1) To co ze zobrazí uživateli
 * 2) To co se vloží do překladu na pozici kurzoru
 * 3) A to co se vloží do překladu za pozici kurzoru

Rozšíření Translate má integrovanou třídu. Další "našeptávací" třídy (suggesters) můžete najít v git repozitáři translatewiki.net.

Configuration
Here's a sample configuration change in a YAML file,

Pre-provided / Bundled insertables
Following is a list of bundled 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. 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.

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: