Šablona:ll

Dokumentace

Tato dokumentace je sem přenesena z podstránky Šablona:ll/doc. (historie/editace)

Tato šablona používá velmi složitou syntaxi nebo funkce parseru. Nepokoušejte se kód měnit, nejste-li si naprosto jisti, co děláte; pokud editace způsobí nečekané následky, urychleně ji vraťte. Veškeré experimenty byste měli provádět na pískovišti nebo ve svém uživatelském prostoru a nikoli zde.

Psaní odkazů na stránkách si lze u této multijazyčné wiki významně ulehčit využitím šablony {{ll}}, která ověřuje existenci překladu pro aktuálně zvolený jazyk rozhraní a na základě výsledku generuje lokalizované odkazy.

Parametry

Tato šablona může mít až tři poziční parametry:

1. jméno cílové stránky, kterou může být i podstránka konkrétního jazyka
2. jméno kotvy na cílové stránce
3. prázdný poziční parametr, který způsobí že se místo aktivního odkazu vygenerovuje textový řetězec použitelný k dalšímu zpracování. Využívá toho např. šablona {{lldoc}}

Použít lze také jeden volitelný parametr

alt

Přes tento parametr lze nastavit odkazu jiný než výchozí text, kterým je u stránek s přeloženým názvem jejich název. Tento text může být překládán přes rozšíření Translate

Použití

Programowa deklaracja LLM w polskiej versji z roku 1990

Link na stránku která se nepřekládá

{{ll|Programowa deklaracja LLM w polskiej versji z roku 1990}}

Programowa deklaracja LLM w polskiej versji z roku 1990#kotva

Link na stránku co se nepřekládá, s přidanou kotvou

{{ll|Programowa deklaracja LLM w polskiej versji z roku 1990|kotva}}

Programová deklarace LLM v polštině, z r. 1990

Link na stránku co se nepřekládá, s přidanou kotvou a alternativním popisem

{{ll|Programowa deklaracja LLM w polskiej versji z roku 1990|alt=Programová deklarace LLM v polštině, z r. 1990|kotva}}

Neexistující stránka

Link, na neexistující stránku

{{ll|Neexistující stránka}}

Neexistující stránka#kotva

Link na budoucí stránku s připravenou kotvou

{{ll|Neexistující stránka|kotva}}

Link na kotvu budoucí stránku

Link odkazující na budoucí stránku s připravenou kotvou, ale s alternativním textem

{{ll|Neexistující stránka|alt=Link na kotvu budoucí stránku|kotva}}

Nápověda:Jazykové mutace stránek

Link, který využívá v popisu přeložený název stránky.

{{ll|Nápověda:Jazykové mutace stránek}}

Nápověda:Jazykové mutace stránek

Link s přeloženým názvem stránky, který odkazuje na kotvu co je sdílená mezi všemi jazykovými verzemi stránky.

{{ll|Nápověda:Jazykové mutace stránek|kotva}}

Alternativní text

U všech odkazů, existujících, neexistujících i přímých na konkrétní jazykové verze, lze využívat alternativní popis odkazu, který může být překládán přes rozšíření Translate

{{ll|Nápověda:Jazykové mutace stránek|alt=Alternativní text}}

Alternativní text

I v tomto případě lze kombinovat alternativní text s kotvou

{{ll|Nápověda:Jazykové mutace stránek|alt=Alternativní text|kotva}}

Nápověda:Jazykové mutace stránek

Parametr alt= je nepovinný, takže ho můžeme klidně vynechat

{{ll|Nápověda:Jazykové mutace stránek|kotva}}

Použití kotvy, která je součástí pouze jedné konkrétní jazykové verze

Nápověda:Jazykové mutace stránek/pl

Odkazuje-li cíl na konkrétní jazykovou verzi překládaného textu, použije se jako cíl právě a vždy jen tato verze.

{{ll|Nápověda:Jazykové mutace stránek/pl}}

Nápověda:Jazykové mutace stránek/pl#kotva

Takovým způsobem může být adresována kotva, která je součástí právě a jen této jedné konkrétní jazykové verze

{{ll|Nápověda:Jazykové mutace stránek/pl|kotva}}

Nápověda:Jazykové mutace stránek

V případě, že je odkazováno na neexistující jazykovu verzi, bude automaticky cílem výchozí jazyková verze stránky. Použije se při tom jak kotva, tak výchozí název stránky. Viz tento příklad:

{{ll|Nápověda:Jazykové mutace stránek/vk|kotva}}

Protože překlad pro jazykový kód vk neexistuje, použila {{ll}} v odkazu stránku ve výchozím jazyce Nápověda:Jazykové mutace stránek/cs#kotva|Nápověda:Jazykové mutace stránek

Šablona nepoužije název výchozí stránky jen v případě, že je v šabloně uveden parametr alt= s náhradním textem odkazu, který může být překládán přímo na stránce přes rozšíření Translate

{{ll|Nápověda:Jazykové mutace stránek/vk|kotva|alt=Náhradní text}}

Tento kód vygeneruje řetězec: Nápověda:Jazykové mutace stránek/cs#kotva|Náhradní text který se na stránce zobrazí jako odkaz na Náhradní text.

Podmíněné vložení překladu stránky

Výstup ze šablony {{ll}} tak můžeme využít i pro vkládání obsahu na základě jejího výstupu. Následující ukázkový kód demonstruje, jak lze využít řetězce odkazujícího na kotvu při extrakci odkazu pro vložení stránky:

{{ll|Nápověda:Jazykové mutace stránek/{{int:languagecode}}|none|}}

Šablona vrátí řetězec s kotvou, který může vypadat třeba takto: Nápověda:Jazykové mutace stránek/cs#none|Nápověda:Jazykové mutace stránek, a ten lze předhodit ke zpracování funkci {{#explode:}}, která z něj vytáhne link odkazující na překlad který pak můžeme vložit do stránky. Viz ukázkový příklad:

{{:{{#explode:{{ll|Nápověda:Jazykové mutace stránek/{{int:languagecode}}|none|}}|&#35|0}}}}

Jde-li o stránku, která ještě nebyla připravena k překladu, lze vložení podmínit testem na existenci stránky wiki TheWoodcraft.org to však není nezbytně nutné, protože to umí vyřešit šablona {{lldoc}}

Zobrazení řetězce, který do kódu generuje šablona

Zajistí prázdný třetí poziční parametr, bez přiřazené hodnoty. Viz příklad:

: {{ll|Neexistující stránka|alt=Link na kotvu budoucí stránky|kotva|}}

Neexistující stránka#kotva|Link na kotvu budoucí stránky

Pokud použijete neprázdný třetí poziční parametr, bude výsledkem aktivní link.

{{ll|Neexistující stránka|alt=Link na kotvu budoucí stránky|kotva|y}}

Link na kotvu budoucí stránky

Stejným způsobem to funguje i pro odkazy na existující, překládané stránky. Viz příklad:

{{ll|Nápověda:Jazykové mutace stránek|alt=Alternativní text|kotva|}}

Nápověda:Jazykové mutace stránek/cs#kotva|Alternativní text

{{ll|Nápověda:Jazykové mutace stránek|alt=Alternativní text|kotva|y}}

Alternativní text

Vložení přeloženého názvu cílové stránky, jako textového řetězce

Pokud chceme načíst pouze textový řetězec s přeloženým názvem cílové stránky (pokud existuje), vynechejte kotvu. Viz příklad:

{{ll|Nápověda:Jazykové mutace stránek||}}

Nápověda:Jazykové mutace stránek

Pamatujte na to, že třetí parametr musí být prázdný. Přiřazená hodnota způsobí, že bude vygenerován aktivní link. Viz příklad:

{{ll|Nápověda:Jazykové mutace stránek||y}}

Nápověda:Jazykové mutace stránek

Pamatujte, že pokud použijete tento řetězec např. jako text odrážku, jako záhlaví odstavce či nadpisu, může dojít k nežádoucí interpretaci některých znaků.