Multijazyčné odkazy na stránky
Z thewoodcraft.org
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:
- jméno cílové stránky, kterou může být i podstránka konkrétního jazyka
- jméno kotvy na cílové stránce
- 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
vkneexistuje, použila{{ll}}v odkazu stránku ve výchozím jazyceNá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}}
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|}}|#|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.
- 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}}
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:
|
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ů. |
