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 nebo co nahradí vybraný obsah.
 * 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é třídy pro zástupné elementy
Toto je přehled tříd pro výběr zástupných elementů, které jsou součástí MediaWiki.

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.
 * Nápověda 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 napoví


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

NumericalParameterInsertablesSuggester
Tahle třída zajišťuje nápovědu 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ý se použije při identifikaci řetězce pro zástupný element. Musí být vždy uveden.
 * display - To co ze zobrazí uživateli. Pokud parametr není uveden, zobrazí se to, co bylo nalezeno.
 * pre - Zástupný element vkládající se před vybraný řetězec nebo nahrazuje výběr, pokud  zůstane prázdný. Pokud není uveden, použije se to co bylo nalezeno.
 * post - Zástupný element vkládající se až za vybraný řetězec. Pokud není uveden, použije se to co bylo nalezeno.

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

UrlInsertablesSuggester
Vyhledá URL adresy (které se obvykle nepřekládají) a doporučí je ke vložení.



Vytvoření vlastní třídy pro 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 třídu, která bude vyhledávat a nabízet vaše vlastní zástupné elementy.

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: