! Technická dokumentace

!! Třídy
[=OpenCMS=] využívá výhod JSP, ale je možné přidat servlety a další třídy, které lze v aplikaci použít. Ty lze přidat jako samostatné třídy, nebo celý [@.jar@] soubor a naimportovat ho do projektu.

I když je táto možnost velice dobrá, v [=OpenCMS=] je jenom mizerně podporovaná. Nelze napsat třídu v prostředí [=OpenCMS=] a přeložit (napsat jo - bez podpory zvýraznění syntaxe a dalších možností IDE, přeložit ne) ji. Stejně tak nelze vytvořit [@.jar@]. Vše je potřeba [[udělat externě -> Tridy]], naimportovat do [=OpenCMS=] a restartnovat server.

!! i18n - Internacionalizácia (internationalization)
_aneb jak na jazyky_ '_(v tomto textu se nevěnujeme siblings - tedy různým jazykovým mutacím článků v jedné [[definici XML -> WebFav.XsdDefiniceProXmlVOpenCms ]] pro článek)_'

[=OpenCMS=] je možné vyšperkovat a pro jednotlivé jazykové mutace připravit konkrétní jazykovou verzy. Logika vycházy z Javy a tak máme k dispozici [@*.properties@] soubory, které použijeme pro i18n a přístup přes Bundle.

Připravili sme několik [[příkladů -> WebFav.I18n ]] jak použít i18n v modulech a ve vaších stánkach. Případně se můžete kouknout do [[dokumentace -> http://opencms.roundpeg.com/opencms622/opencms/alkacon-documentation/examples_jstl/ ]] [=OpenCMS=].

!! Definice nových textů
_aneb XML schémata v [=OpenCMS=]_

Chceme-li si [[definovat -> WebFav.XsdDefiniceProXmlVOpenCms ]] vlastní článek, text nebo jinou funkční část, kterou budeme pak editovat a pro výstup [[formátovat -> WebFav.TemplatesProOpenCms ]] máme k dispozici XSD definici XML souborů.

Předvedeme si jak [[vytvořit -> WebFav.XsdDefiniceProXmlVOpenCms ]] nějaké XML, jak přidat validaci elementů, defaultních hodnot a různe použití Widgets pro [=OpenCMS=].

Už nedílnou součástí bude malá revize toho, co nefunguje, resp. není podporováno.

!! Tuning [=OpenCMS=] workspace pro naše potřeby
_aneb hraní si s [[ konfiguračními XML -> WebFav.KonfikuracniXML]]_

Víme jak vytvořit nový [[obsahový prvek -> WebFav.XsdDefiniceProXmlVOpenCms]] a vlastní adresáře, ale bylo by dobré si upravit i [[kontextovou nabídku -> WebFav.KonfikuracniXML]] pro každý námi vytvořený prvek (kdo se chce šprtat v [=OpenCMS=], tak samozřejmě i jiné prvky).

!! Templates (návrhové vzory)
_aneb [=OpenCMS=] puzzle, pro zobrazení srtánky_

[[Template -> WebFav.TemplatesProOpenCms ]] je způsob jak si poskládat a naformátovat po částech stránku. Z [[definovaných -> WebFav.XsdDefiniceProXmlVOpenCms ]] XML dostat požadované data, rozmístnit si jich podle libosti případně použít pro další práci, testovaní.

Více: http://www.opencms.org/

!!Obsluha chyb
_aneb chybička se vloudila_

[=OpenCMS=] má ve svém [@ web.xml @] definovanou obsluhu 404 a 500, které se nachází v [@ /system/handler/ @] jako [@ handler404.jsp @] a [@ handler500.jsp @]. K tomu pak ještě existuje příslučná template pro chybové stránky.

Lze si je [[přizpůsobit->ObsluhaChyb]] a to několika způsoby.

!!Práce se soubory a adresáři
_aneb není soubor jako soubor_

Java pro práci se soubory používa balík [@java.io.file@]. Podobný přístup byl zvolen i pro [=OpenCMS=]. Byl [[rozšířen -> WebFav.SouboryAAdresare]] a [[upraven -> WebFav.SouboryAAdresare]] o jisté vlastnosti specifické pro [=OpenCMS=]. [[Něco -> WebFav.SouboryAAdresare]] málo ale ušlo a není vše tam kde má být.