Definování obsahu části Intro
Nyní se věnujme samotnému obsahu. Obsah se definuje pro jednotlivé stránky. Všechny stránky mají atribut id.
Jde o ID, které se používá při definování domovské a pohotovostní stránky a ostatních míst výskytu odkazu na stránku. V ostatních případech příslušné atributy závisejí na typu definované stránky.
Existují dva základní typy stránek:
- Statické stránky jsou soubory obsahující data prostého formátu HTML. Tyto stránky používají běžné mechanizmy standardu HTML k odkazování na další stránky. Statické stránky nemusejí být definovány v souboru konfigurace obsahu. Výjimkou je zde domovská stránka. Protože domovská stránka je určena jednoznačným identifikátorem (home-page-id) v prvku presentation, musí v souboru s obsahem existovat definice stránky, která používá tento jednoznačný identifikátor. Tato stránka vyžaduje pouze definování adresy url. Všechny ostatní dílčí prvky budou ignorovány, protože obsah stránky definuje samotná stránka HTML. Všechny ostatní stránky Intro HTML poskytnuté modulem plug-in musejí být obsaženy v modulu plug-in, nicméně není zapotřebí je definovat v souboru s obsahem. Rovněž mohou být uvedeny odkazy na stránky HTML umístěné v jiných modulem plug-in nebo na webu.
- Dynamické stránky jsou definovány v souboru s obsahem XML s použitím dílčích prvků, které popisují obsah stránky. Dílčí prvky představují prvky uživatelského rozhraní běžně používané na stránkách, které napodobují vzhled stránek HTML. V závislosti na použité implementaci se tyto stránky buď dynamicky překládají do HTML (je-li typ implementace html) nebo se dynamicky vytvářejí v podobě formulářů SWT (je-li typem implementace swt). Na stránce lze definovat tyto dílčí prvky:
- Prvek group se používá k seskupení jiných dílčích prvků a k definování konzistentního stylu v rámci takovýchto skupin.
- Prvek link definuje odkaz, který lze zobrazit s použitím obrázku a textu. Odkaz může navigovat na jinou stránku a volitelně spustit určitou akci. Akce se zadávají jako příkazy v adrese URL.
- Prvky text a img zobrazují textový a obrazový obsah.
- Prvek include zahrnuje dříve definovaný dílčí prvek. Na tento prvek se odkazuje s použitím jeho vlastního jedinečného identifikátoru.
- Prvek head definuje přídavný kód HTML, který bude vkládán do hlavičky stránky při použití implementace typu html.
- Prvek html definuje přídavný kód HTML, který bude vkládán do těla stránky při použití implementace typu html.
Rovněž lze definovat prvek title, který uvádí název stránky. Stránka může rovněž obsahovat informaci o skutečnosti, že její obsah je definován v samostatném souboru obsahu. Rozdělení stránek do samostatných souborů může být užitečným způsobem zabezpečení požadovaného výkonu, protože obsahy stránek Intro vyžadují inicializaci až v momentu svého použití.
Nejpříhodnějším způsobem důkladného obeznámení se s formátem definice obsahu je prostudování implementací v SDK. Následující úsek uvádí pouze první část obsahu kořenové stránky SDK, která je první zobrazenou stránka Intro.
<introContent>
<page alt-style="css/root_swt.properties" style="css/root.css" id="root" style-id="page">
<title style-id="intro-header">Vítejte na platformě Eclipse 3.0</title>
<group id="links-background">
<group id="page-links">
<link label="Přehled" url="http://org.eclipse.ui.intro/showPage?id=overview" id="overview" style-id="left">
<text>Obecné informace o Eclipse</text>
</link>
<link label="Výukové programy" url="http://org.eclipse.ui.intro/showPage?id=tutorials" id="tutorials" style-id="left">
<text>Doprovázejte nás komplexními výukovými programy platformy Eclipse</text>
</link>
<link label="Ukázky" url="http://org.eclipse.ui.intro/showPage?id=samples" id="samples" style-id="right">
<text>Prozkoumejte vývojové prostředí Eclipse s použitím ukázek kódu</text>
</link>
<link label="Novinky" url="http://org.eclipse.ui.intro/showPage?id=news" id="news" style-id="right">
<text>Co je nového v této verzi</text>
</link>
</group>
</group>
Prvky na stránce lze rovněž odfiltrovat (filteredFrom) z určité implementace. Návrháři stránek tak mohou navrhovat s důrazem na určitou platformu. K dispozici je mnohem více účinných atributů, které lze použít k popisování stránky a jejího obsahu. Kompletní informace o platných prvcích, dílčích prvcích a jejich atributech viz dokumentace bodu rozšíření org.eclipse.ui.intro.config
a jemu přiřazené specifikace formátu souboru s obsahem části Intro.