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 diffusion/GTWN/browse/groups 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 tříd pro výchozí zástupné elementy.

HtmlTagInsertablesSuggester
Tato třída našeptává zástupné elementy místo HTML tagů nalezených v překládaném řetězci.

Například:


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

MediaWikiInsertablesSuggester
Tato třída zas bude zobrazovat zástupné elementy v případě, že pokud ve wikitextu předkládané zprávy najde řetězce s nimiž pracuje MediaWiki. Takže našeptá


 * Parametr, který se používá při volání stránky nápovědy přes API, pokud na něj narazí.
 * A rovněž našeptá i HTML značky.
 * A rovněž našeptá i HTML značky.

NumericalParameterInsertablesSuggester
Tahle třída zajišťuje našeptání numerických zástupných elementů, jako např. ,, či

RegexInsertablesSuggester
Tahle třída generuje zástupné elementy z řetězců co vyhoví nastavenému regulárnímu výrazu.

Například:

Popis parametrů,


 * regex - Regulární výraz, kterým se budou rozpoznávat zástupné elementy. Mandatory.
 * display - To co ze zobrazí uživateli. Not mandatory, defaults to matched value.
 * pre - To, co se vloží před vybraný řetězec. Not mandatory, defaults to matched value.
 * post - To co se vloží až za vybraný řetězec. Not mandatory, defaults to matched value.

TranslatablePageInsertablesSuggester
Používá se hlavně u překládaných stránek kde má našeptávač zobrazovat proměnné, jako např. .

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. Nově přidané řádky jsou zvýrazněny.

FreeCol.yaml:

Suggester.php:

Parametry zástupného elementu jsou pak tyto: