Definere introduksjonsinnhold
Vi skal nå se nærmere på selve innholdet. Innhold beskrives i form av sider. Alle sider har et id-attributt.
Denne IDen brukes til å definere start- og ventemodussidene og andre steder der det refereres til en side.
Hvis ikke, avhenger de aktuelle attributtene av hva slags side som defineres.
Det finnes to grunnleggende sidetyper:
- Statiske sider er rene HTML-filer. Disse sidene bruker vanlige HTML-mekanismer til å opprette linker til andre sider.
Det er ikke nødvendig å definere statiske sider i konfigurasjonsinnholdsfiler, bortsett fra startsiden. Ettersom startsiden
er angitt av en ID (home-page-id) i presentation-elementet, må siden være definert med
den IDen i innholdsfilen. Denne siden trenger ikke definere noe annet enn en URL. Alle andre delelementer vil bli ignorert
fordi HTML-siden selv beskriver innholdet på siden. Øvrige HTML-introduksjonsfiler fra plugin-modulen
må inkluderes sammen med plugin-modulen, men trenger ikke oppgis i innholdsfilen. Det kan også
refereres til HTML-filer i andre plugin-moduler eller på nettet.
- Dynamiske sider beskrives i XML-innholdsfilen ved hjelp av underelementer som beskriver innholdet på siden.
Underelementene er brukergrensesnittelementer som ofte finnes i HTML-liknende sider.
Avhengig av implementeringen oversettes disse sidene enten dynamisk til HTML (når
implementeringstypen (kind) er "html") eller opprettes dynamisk som SWT-baserte brukergrensesnittskjemaer
(når implementeringstypen (kind) er "swt"). Underelementene nedenfor kan opprettes på en
side:
- Group brukes til å gruppere andre underelementer og definere en konsistent stil på tvers av gruppen.
- Link definerer en link som kan vises ved hjelp av et bilde og tekst. Linken kan navigere til en annen side
og eventuelt kjøre en introduksjonshandling. Handlinger angis som kommandoer i URLen.
- Elementene text og img viser innhold i tekst og bilder.
- Elementet include inneholder et underelement som allerede er definert. Det
refereres til elementet gjennom IDen.
- Elementet head definerer ekstra HTML som skal inkluderes i toppteksten på
siden når det brukes html-implementering.
- Elementet html definerer ekstra HTML som skal inkluderes i hoveddelen på
siden når det brukes html-implementering.
Det kan også defineres tittel (title) for en side. En side kan også angi at innholdet er definert i en separat innholdsfil
(content). Ved å dele sidene inn i separate filer, unngår du problemer med ytelsen fordi
innholdet på en introduksjonsside ikke blir initialisert før det er behov for det.
Den beste måten å bli kjent med innholdsdefinisjonsformatet på er ved å se på implementeringene i Eclipse
SDK. Snutten 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">Welcome to Eclipse Platform</title>
<group id="links-background">
<group id="page-links">
<link label="Overview" url="http://org.eclipse.ui.intro/showPage?id=overview" id="overview" style-id="left">
<text>Find out what Eclipse is all about</text>
</link>
<link label="Tutorials" url="http://org.eclipse.ui.intro/showPage?id=tutorials" id="tutorials" style-id="left">
<text>Let us guide you through Eclipse end-to-end tutorials</text>
</link>
<link label="Samples" url="http://org.eclipse.ui.intro/showPage?id=samples" id="samples" style-id="right">
<text>Explore Eclipse development through code samples</text>
</link>
<link label="Whats New" url="http://org.eclipse.ui.intro/showPage?id=news" id="news" style-id="right">
<text>Find out what is new in this release</text>
</link>
</group>
</group>
...
Elementer på en side kan også være filtrert fra (filteredFrom) en bestemt implementering. Dette betyr at sidene
kan utformes med bestemte plattformer i tankene. Det er mange attributter som kan brukes til å
beskrive en side og sideinnholdet. Hvis du vil ha en komplett referanse til gyldige
elementer, underelementer og attributter, finner du dette i dokumentasjonen for
utvidelsespunktet
org.eclipse.ui.intro.config
og tilhørende
filformatspesifikasjon
for introduksjonsinnhold.