Zobrazení zdroje stránky WebToDate/Referenční/Jazykové verze

[[Category:WebToDate Referenční]]
[[Category:Referenční]]
== Přehled možností vytváření jazykových mutací webu ==
Systém WebToDate vychází vstříc i rozsáhlým webům, které udržují informace v&nbsp;několika jazycích.  

Snadno můžete pořizovat navzájem provázané články v&nbsp;různých jazycích a umisťovat je do šablon, odpovídajících příslušné jazykové verzi. Možnost volby jazykové verze se v&nbsp;systému WebToDate objevuje na několika místech.

<div class="note">'''Poznámka:''' Pokud je v&nbsp;systému definován jen jeden jazyk, nenabízí se nikde žádné jazykové volby jako například přiřazení zpráv k&nbsp;jazyku, jazykové verze zpráv či stránek a podobně. Interně se pak vše automaticky váže na daný výchozí jazyk.</div>

Podpora jazykových mutací webů ve WebToDate spočívá zejména v&nbsp;následujících funkcích:

* Strom kategorií podporuje jazykově závislé vlastnosti, výsledkem je zejména generování korektních navigačních nabídek v&nbsp;závislosti na jazyce.
* Každá zpráva má vlastnost ''jazyk''. V&nbsp;databázi se udržuje spojení definující jazykové ekvivalenty - stejné zprávy v&nbsp;jiných jazycích.
* Každá stránka má vlastnost ''jazyk''. V&nbsp;databázi se udržuje spojení definující jazykové ekvivalenty - stejné stránky v&nbsp;jiných jazycích.
* Existuje funkce umožňující sestavit stránku na základě vzoru - stejné stránky v&nbsp;jiném jazyce
* Existují klíčová slova WebToDate pro snadné vytváření odkazů mezi různými jazykovými verzemi zpráv a stránek.

== Definice jazyků ==
Seznam jazyků, které jsou v rámci funkcí systému nabízeny, se spravuje pomocí funkce '''Administrace''' - '''Jazyky'''. Pro každý jazyk zde administrátor definuje

* '''Název jazyka''' - libovolně zvolený název, který se pak nabízí ve formulářích redakčního rozhraní
* '''Locale''' - dvoupísmenná zkratka jazyka, která se pak používá v klíčový slovech pro propojení jazykových verzí nebo v URL stránek jako hodnota parametru pro výběr jazykové verze stránky (zejména v modulech WebToDate).

[[Image:referencniprirucka-jazyky-def.gif|center]]

Jazyky lze libovolně přidávat ve variantě [[../Úvod#Jazykové verze|Enterprise]], ve variantě [[../Úvod#Jazykové verze|Standard]] lze definovat pouze dva jazyky.

== Jazykové verze a strom kategorií ==
Možnosti jsou popsány v&nbsp;kapitole [[../Strom kategorií#Strom kategorií a jazykové verze|Strom kategorií a jazykové verze]].

== Jazykové verze zpráv ==
V&nbsp;dialogovém okně '''Úprava zprávy''' (resp. '''Přidání zprávy''') stiskněte tlačítko '''Jazykové verze'''.

[[Image:referencniprirucka-jazykoveverze-img167.png|center]]

Zobrazí se dialogové okno, které zobrazuje seznam navzájem souvisejících článků v&nbsp;různých jazykových mutacích. Jde o články, které obsahují stejnou informaci vyjádřenou v&nbsp;různém jazyce. Abychom s&nbsp;nimi mohli pracovat, musíme je propojit – označit, že patří k&nbsp;sobě.

To jde uskutečnit dvěma způsoby:

* Pokud již článek v&nbsp;jiné jazykové verzi existuje, napíšeme jeho číslo do okénka '''Zprávu číslo''' a v&nbsp;rozevírací nabídce v&nbsp;jazykové verzi vybereme jeho jazyk. Po stisknutí tlačítka '''Propojit s&nbsp;ostatními''' se článek objeví v&nbsp;seznamu '''Jazykově přiřazené zprávy'''. 
* Pokud zpráva v&nbsp;nové jazykové verzi ještě neexistuje a je potřeba ji vytvořit, stiskněte tlačítko '''Založit zprávu a propojit'''. Objeví se standardní okno přidávání nové zprávy. Po jejím uložení je zpráva propojena s&nbsp;jazykovými verzemi původní zprávy.

== Jazykové verze stránek ==
=== Definice jazykových verzí ===

Také stránkám můžete přiřadit informaci, v&nbsp;jaké jsou jazykové verzi.

V&nbsp;záložce '''Stránky''' vyberte příslušnou stránku a zvolte tlačítko '''Vlastnosti'''. V&nbsp;horní části dialogového okna klepněte na tlačítko '''Jazykové verze'''.

[[Image:referencniprirucka-jazykoveverze-img168.png|center]]

Zobrazí se dialogové okno, které zobrazuje seznam navzájem souvisejících stránek v&nbsp;různých jazykových mutacích. Jde o stránky, které budou pravděpodobně obsahovat stejné oblasti se stejnými články v&nbsp;různých jazykových podobách. Abychom s&nbsp;nimi mohli pracovat, musíme je propojit – označit, že patří k&nbsp;sobě.

Také toto lze uskutečnit dvěma způsoby:

* pokud již stránka v&nbsp;jiné jazykové verzi existuje, napíšeme její číslo do pole '''Stranu číslo''' a v&nbsp;rozevírací nabídce v&nbsp;jazykové verzi vybereme její jazyk. Po stisknutí tlačítka '''Propojit s&nbsp;ostatními''' se článek objeví v&nbsp;seznamu '''Jazykově přiřazené stránky'''. 
* Pokud stránka v&nbsp;nové jazykové verzi ještě neexistuje a je potřeba ji vytvořit, stiskněte tlačítko '''Založit stránku a propojit'''. Objeví se standardní okno přidávání nové stránky. Po uložení je stránka propojena s&nbsp;jazykovými verzemi původní stránky.

<div class="note">'''Poznámka''': V&nbsp;seznamech souvisejících zpráv a stránek se vyskytuje vždy pouze jedna položka od každé jazykové verze. Pokud byste přidávali položku s&nbsp;již existující jazykovou verzí, budete upozorněni.</div>



== Klíčová slova WebToDate pro podporu jazykových mutací ==
Pro podporu vícejazyčných verzí jsou implementována klíčová slova, která lze používat v&nbsp;šablonách stránek a předlohách. Jejich kompletní výčet je uveden v&nbsp;kapitole [[../Klíčová slova WebToDate|Klíčová slova WebToDate]].

Tato klíčová slova slouží k&nbsp;tomu, aby bylo možné umístit automaticky na stránku či do zobrazení celého textu zprávy odkaz na jinou jazykovou verzi stránky resp. zprávy. Např. klíčové slovo <nowiki><!--WTD_ART_LANG(*,CS)--></nowiki> použité v&nbsp;předloze pro zprávy vloží do stránky URL jazykové verze zprávy v&nbsp;jazyce se zkratkou CS (při výchozí instalaci čeština). Je možné zajistit i vložení odkazu jen v&nbsp;případě, že jazyková verze existuje:

<code>
 <nowiki><!--WTD_IF(ART_LANGNOTNULL, *, CS,"<a href="<!--WTD_ART_LANG(*,CS)-->">Česká verze této zprávy</a>")--></nowiki>
</code>

Tento výraz znamená, že pokud existuje česká verze právě zobrazované zprávy, vloží se do zobrazení zprávy odkaz na tuto českou verzi.

== Doporučení pro vytváření webů s&nbsp;více jazykovými mutacemi ==
Při vytváření webů s&nbsp;více jazykovými mutacemi doporučujeme vzít v&nbsp;úvahu následující skutečnosti:

* Jaká lokalizovaná verze navigací se použije na dané stránce, funguje zcela transparentně – podle jazyka stránky nebo zprávy se rozhodne o této jazykové verzi a taková se tam vloží. Využití jazykově závislých vlastností kategorií ovšem klade zvýšené nároky na pečlivou správu stromu kategorií. Příznak "patří do navigace" se definuje pro každý jazyk zvlášť, kategorie se tedy v navigacích pro jeden jazyk objevovat může, v navigacích pro jiný jazyk naopak nemusí.
* Pro výchozí předlohy pro zprávy platí, že na úrovni kategorií se jazyk pro výchozí předlohy rozlišuje (tj. pro každý jazyk lze pro danou kategorii nastavit jinou výchozí předlohu), u publikací toto neplatí. V&nbsp;případě vícejazyčných webů je tedy vhodnější nastavovat výchozí předlohy pro zprávy na úrovni stromu kategorií.
* Jazykové verze stránek je třeba z&nbsp;principu propojovat v&nbsp;případě, že požadavky na implementaci předpokládají vkládání odkazů na jazykové ekvivalenty stránek, tj. na stránce reprezentující určitou sekci webu např. v&nbsp;češtině má být odkaz na stránku reprezentující stejnou sekci např. v&nbsp;angličtině. Pokud toto není požadováno, není propojení jazykových verzí stránek nutné, i když samozřejmě poněkud zpřehlední strukturu implementace.
* Jazykové verze zpráv je třeba z&nbsp;principu vytvářet v&nbsp;případě, že požadavky na implementaci předpokládají vkládání odkazů na jazykové ekvivalenty zpráv, tj. zobrazení zprávy v&nbsp;češtině má obsahovat odkaz na stejnou zprávu v&nbsp;angličtině. Pokud toto není požadováno, není propojování jazykových verzí nutné, nicméně v&nbsp;tomto případě je poměrně vhodné toto provádět – díky této funkci lze pak jednoduše při úpravách zprávy přecházet z&nbsp;jedné jazykové verze do druhé.
* Propojení jazykových verzí zpráv či stránek je vždy nutné provádět ručně tak, jak je popsáno v&nbsp;předchozích kapitolách. K&nbsp;automatickému propojení stránek či zpráv nikdy nedojde; i když jsou třeba dvě stránky ve stejné kategorii ve stromu kategorií, každá má nastavený jiný jazyk a obě jsou nastaveny jako výchozí, WebToDate je automaticky nepovažuje za vzájemné jazykové verze.
* Při přípravě designu webu je vhodné minimalizovat počet WebToDate stylů obsahujících nějaké texty zobrazované na stránkách. Pokud styl obsahuje texty, musí se pro každý jazyk vytvořit jeho duplikát. To zároveň znamená, že chceme-li minimalizovat možnost aplikace nevhodného stylu v&nbsp;dané oblasti na stránce, je třeba pro každý jazyk vytvořit i oblast s&nbsp;jiným názvem (aby bylo možné omezit přípustné styly pro oblast). Čím více definic stylů a oblastí, tím náročnější je samozřejmě správa celé webové prezentace z&nbsp;hlediska úprav či změn grafického designu apod.