Šablona:ll

Z thewoodcraft.org

[editovat]

Template-info.svg Dokumentace


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
PoznámkaŠ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:

Příklad
{{:{{#explode:{{ll|Nápověda:Jazykové mutace stránek/{{int:languagecode}}|none|}}|&#35|0}}}}
PoznámkaJde-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:
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.
Příklad
{{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:
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:
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:
Příklad
{{ll|Nápověda:Jazykové mutace stránek||y}}
Nápověda:Jazykové mutace stránek
Upozornění 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ů.