Šablona:svitek/doc

Toto je dokumentační podstránka šablony Šablona:svitek.

Vedle návodu k použití obsahuje kategorie, odkazy interwiki a další obsah, který není součástí kódu šablony.

Šablona {{svitek}} se používá ke vkládání textových řetězců do stránek v rámci činů a mistrovství zdejší elektronické verze Svitku. Podobně funguje také šablona {{kategorie}}.

Parametrem šablony je řetězec, ze kterého se generuje jméno překládané stránky, a pokud existuje její překlad do aktuálně zvoleného jazyka rozhraní, zajistí vložení přeloženého textu do místa, kde je použita. Tento řetězec vždy začíná vždy kódem, za kterým následuje pomlčka a číslo překládané zprávy. Může to být libovolný řetezec. Nejenom kód konkrétního činu 1A1, skupiny činů 1A, či kodifikovaný název mistrovství.

Prostřednictvím této šablony lze vkládat i obecnější texty, používané v rámci svitku, které se na různých místech opakují. Kupříkladu kód „{{svitek|timesec}}” bude nahrazen textem: „Čas je uveden v sekundách.”

Pokud místo přeloženého textu uvidíte žlutě podbarvený originální řetězec, je to signál, že zpráva ještě není do cílového jazyka přeložena. Totéž se zobrazí i v případě nastavení výchozího jazyka stránky, pokud volaná stránka existuje, ale obsah ještě nebyl označen k překladu. Na tuto operaci mají práva pouze členové skupiny translator.

Stránka kterou šablona {{svitek}} hledá, vždy začíná prefixem svitek- za kterým následuje parametr předaný šabloně. Jde o normální stránku a překládaná zpráva de facto, kterou šablona hledá, je podstránka pojmenovaná kódem aktuálně používaného jazyka rozhraní, překládané TU (translation unit – překládaná jednotka). Použijeme-li tedy kód:

{{svitek|1A1-1}}

Vloží šablona odpovídající podstránku s překladem stránky svitek-1A1-1. Ovšem jen pokud bude existovat. Bude-li rozhraní v češtině, použije stránku svitek-1A1-1/cs, pro polštinu svitek-1A1-1/pl, atp.

Šablona {{svitek}} je uzamčena, protože s ní pracuje šablona {{kategorie}}, co generuje výstupy pro tisk a vstupní data pro šablonu {{TBC}}.

Dávejte si také pozor, abyste u stránek volaných přes šablonu {{svitek}} nezapomínali správně používat element <noinclude>…</noinclude>, aby nedocházelo k nežádoucí interpretaci použitého kódu.

Pokud nebudete mít takto ošetřen element <noinclude><languages /></noinclude> může se při použití této šablony na jiné překládané stránce s textovým obsahem vložit i panel pro přepínání jazykových verzí!

Pokud byste použili šablonu {{svitek}} i na stránce, jejíž kódový název začíná prefixem svitek-, došlo by při zpracování šablony k zacyklení. A místo přeloženého textu, nebo výzvy k přeložení, by se zobrazilo pouze oznámení o chybě. Proto se na těchto stránkách používá kopie šablony {{svitek}}, šablona {{skok}}.

Na ilustračním obrázku můžete vidět, jak taková chyba vypadá.

Abychom zjistili, odkud se bere, musíme se podívat do kódu.

Vzhledem k tomu, že, se v tomto případě se šablona {{svitek}} volá pouze jednou, je jasné kde je potřeba chybu hledat. Vyskytovala se na stránce svitek-con0, ale jak sami vidíte, vše se na první pohled jevilo v pořádku. Takže kód šablony {{svitek}} byl interpretován správně. Ale jak můžete vidět i na screenshotech, byla to stránka s prefixem svitek-.

Stačilo tedy zaměnit jméno šablony {{svitek}} za {{skok}} a problém byl vyřešen.