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řednastavené / 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.

Jak přidat vlastní zástupné elementy
V případě, že žádný ze zástupných elementů které jsou k dispozici nevyhovuje vašim potřebám, si můžete vytvořit svůj vlastní zástupný element.

Toto je příklad, jak přidat zástupný element, pro zprávy, které jsou ve skupině: FreeCol. Příslušný soubor v YAML syntaxi vypadá následovně pro zjednodušení je zde uvedena pouze část, která se týká příkladu. The newly added lines are highlighted.

FreeCol.yaml:

Suggester.php:

Parametry zástupného elementu jsou pak tyto: