Help:Extension:Translate/Insertables/cs

Překládané řetězce často obsahují značky, které chceme u překladu zachovat tak jak jsou. Zápis takových značek do překladu může být pro překladatele problematický, obzvláště, pokud se při něm pracuje se speciálními znaky, co nejsou moc běžné, a to pak pochopitelně práci překladatele zpomaluje. A zástupné elementy, to usnadňují, protože se překladateli zobrazují u překládané zprávy jako tlačítka, která do překládané zprávy vloží kód, který pak na stránce nahrazuje kódem, který zastupují. 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.

Nastavení
Toto je jednoduchý příklad nastavení našeptávací třídy v YAML syntaxi.

Přednastaveno / Předpřipravené zástupné elementy
Toto je přehled předpřipravených zástupných elementů.

HtmlTagInsertablesSuggester
Tento zástupný element zobrazí příslušná tlačítka místo HTML tagů, nalezených v překládaném řetězci.

Konkrétně:


 * U překládané zprávy: This linklink takes you to the home page.
 * Našeptávač zobrazí:

MediaWikiInsertablesSuggester
V tomto případě se zobrazí zástupný element v případě, že kód ve wikitextu MediaWiki odpovídá následujícím zprávám. Zahrnuje našeptávání pro


 * Parametr jako např.  volá přes API stránku nápovědy ke zprávě.
 * Našeptávání u HTML značek.
 * Našeptávání u HTML značek.

NumericalParameterInsertablesSuggester
Tento zástupný element bude zobrazovat našeptávače pro numerické parametry, jako např. ,, nebo

RegexInsertablesSuggester
V tomto případě se zástupné elementy generují na základě řetězců vyhovujících regulárním výrazům.

Konkrétní příklad použití:

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: