Definér introduktionsindhold
Nu kan vi se på selve indholdet. Indholdet er beskrevet på sider. Alle sider har en id-attribut.
Det er den id, der bruges ved definition af hjemme- og standby-siderne og andre steder, hvor der er en reference til en side. Ellers er de relevante attributter afhængige af den definerede sidetype.
Der er to typer basissider:
- Statiske sider er almindelige HTML-filer. Disse sider bruger de normale HTML-mekanismer til at oprette link til andre sider. Statiske sider behøver ikke være defineret i konfigurationsindholdsfilen, undtagen hjemmesiden. Da hjemmesiden angives ved en id (home-page-id) i presentation-elementet, skal der være en sidedefinition, der bruger den id i den aktuelle fil. Denne side behøver kun at definere en url. Alle andre underelementer ignoreres, da selve HTML-siden beskriver sideindholdet. Alle andre HTML-introduktionssider, som plugin'en leverer, skal være inkluderet med plugin'en, men de behøver ikke at være angivet i indholdsfilen. Der kan også refereres til HTML-filer, der er placeret i andre
plugins eller på webben.
- Dynamiske sider er beskrevet i XML-indholdsfilen vha. underordnede elementer, der beskriver indholdet af siden. Underordnede elementer er UI-elementer, som findes på HTML-lignende sider. Afhængigt af implementeringen oversættes disse sider dynamisk til HTML (når implementeringstypen (kind) er html eller også oprettes de dynamisk som SWT-baserede UI-formular (når implementeringstypen (kind) er swt). Følgende underordnede elementer kan defineres på en side:
- En gruppe bruges til at gruppere andre underordnede elementer og til at definere en konsistent typografi på tværs af gruppen.
- Et link definerer et link, der kan vises vha. et billede og en tekst. Linket kan navigere til en anden side og udføre en introduktionsfunktion. Funktioner angives som kommandoer i URL'en.
- text-og img-elementerne viser tekst- og billedindhold.
- Elementet include inkluderer et tidligere defineret underordnet element. Elementets id refererer til elementet.
- Elementet head definerer yderligere HTML, der skal inkluderes i hovedafsnittet af siden, når html-implementeringen benyttes.
- Elementet html definerer yderligere HTML, der skal inkluderes i sidens indhold, når html-implementeringen benyttes.
Der kan også defineres en titel til en side. En side kan også angive, at dens indhold er defineret i en separat indholdsfil. Opbrydning af sider i separate filer kan være nyttig, hvis der er ydeevneproblemer, da indholdet af en introduktionside kun initialiseres, hvis der er behov for det.
Den bedste måde at få en fornemmelse af indholdsdefinitionsformatet på er at gennemgå implementeringerne i Eclipses SDK. Stykket nedenfor viser et eksempel på dette:
<introContent>
<page alt-style="css/root_swt.properties" style="css/root.css" id="root" style-id="page">
<title style-id="intro-header">Velkommen til Eclipse-platform</title>
<group id="links-background">
<group id="page-links">
<link label="Oversigt" url="http://org.eclipse.ui.intro/showPage?id=overview" id="overview" style-id="left">
<text>Hvad er Eclipse?</text>
</link>
<link label="Øvelser" url="http://org.eclipse.ui.intro/showPage?id=tutorials" id="tutorials" style-id="left">
<text>Lad os føre dig gennem Eclipse-øvelserne fra start til slut</text>
</link>
<link label="Eksempler" url="http://org.eclipse.ui.intro/showPage?id=samples" id="samples" style-id="right">
<text>Undersøg Eclipse-udvikling vha. kodeeksempler</text>
</link>
<link label="Nye funktioner" url="http://org.eclipse.ui.intro/showPage?id=news" id="news" style-id="right">
<text>Nye funktioner i denne release</text>
</link>
</group>
</group>
...
Elementerne på en side kan også være filteredFrom en bestemt implementering. Derved kan sideudviklere designe ud fra en bestemt platform. Der er mange flere kraftige attributter, der kan bruges ved beskrivelse af en side og dens indhold. I dokumentationen til udvidelsespunktet org.eclipse.ui.intro.config
og dets tilknyttet angivelse af filformat for introduktionsindhold finder du en komplet oversigt over gyldige elementer, underordnede elementer og deres attributter.