Definiera introduktionsinnehåll
Nu kan vi titta på själva innehållet. Innehåll kan beskrivas som sidor. Alla sidor har ett id-attribut.
Detta är det ID som används när hem- och reservsidorna definieras, samt andra platser där det finns en referens till en sida. Annars är relevanta attribut beroende av den typ av sida som definieras.
Det finns två grundläggande typer av sidor:
- Statiska sidor är enkla HTML-filer. Dessa sidor använder normala HTML-mekanismer för att länka till andra sidor. Statiska sidor behöver inte definieras i konfigurationsinnehållsfilen, förutom hemsidan. Eftersom hemsidan anges med IDt (home-page-id) i presentationselementet måste det finnas en siddefinition som använder det IDt i innehållsfilen. Denna sida behöver bara definiera en url-adress. Alla andra underordnade element ignoreras, eftersom HTML-sidan själv beskriver sidinnehållet. Alla andra HTML-introduktionssidor, som läggs till av
insticksprogrammet, måste inkluderas med insticksprogrammet, men behöver inte anges i innehållsfilen. HTML-filer som finns i andra insticksprogram eller på webben kan också refereras.
- Dynamiska sidor beskrivs i XML-innehållsfilen med hjälp av delelement som beskriver innehållet på sidan. Delelementen är användargränssnittsobjekt som ofta återfinns på HTML-liknande sidor. Beroende på implementation översätts dessa sidor antingen dynamiskt till HTML (när implementationstypen är html) eller skapas dynamiskt som
SWT-baserade användargränssnittsformulär (när implementationstypen är swt). Följande underordnade element kan definieras på en sida:
- En group används för att gruppera andra underordnade element och definiera en konsekvent stil över gruppen.
- En link definierar en länk som kan visas med hjälp av en bild och text. Länken kan navigera till en annan sida och valfritt köra en introduktionsåtgärd. Åtgärder anges som kommandon i URL-adressen.
- Elementen text och img visar text- och bildinnehåll.
- Elementet include inkluderar ett tidigare definierat underordnat element. Elementet refereras till med sitt ID.
- Elementet head definierar ytterligare HTML som ska tas med i rubrikavsnittet på sidan när
html-implementationen används.
- Elementet html definierar ytterligare HTML som ska tas med i sidans brödtext när
html-implementation används.
En title kan också definieras för en sida. En sida kan också ange att innehållet definieras i en separat
content-fil. Att dela upp sidor i separata filer kan vara bra när prestanda är viktigt eftersom innehållet på en introduktionssida inte initieras förrän den behövs.
Det bästa sättet att få en uppfattning av innehållsdefinitionsformatet är att bläddra igenom implementationerna i Eclipse SDK. I kodstycket nedan visas ett exempel på det:
<introContent>
<page alt-style="css/root_swt.properties" style="css/root.css" id="root" style-id="page">
<title style-id="intro-header">Välkommen till Eclipse-plattformen</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>Ta reda på vad Eclipse handlar om</text>
</link>
<link label="Självstudier" url="http://org.eclipse.ui.intro/showPage?id=tutorials" id="tutorials" style-id="left">
<text>Låt oss vägleda dig genom de heltäckande Eclipse-kurserna</text>
</link>
<link label="Exempel" url="http://org.eclipse.ui.intro/showPage?id=samples" id="samples" style-id="right">
<text>Utforska Eclipse-utveckling med hjälp av kodexempel</text>
</link>
<link label="Nyheter" url="http://org.eclipse.ui.intro/showPage?id=news" id="news" style-id="right">
<text>Visa vad som är nytt i den här releasen</text>
</link>
</group>
</group>
...
Element på en sida kan också filteredFrom en viss implementation. Med hjälp av detta kan de som designar sidor designa för en viss plattform. Det finns många fler kraftfulla attribut som kan användas vid beskrivning av en sida och dess innehåll. I dokumentationen för utökningspunkten
org.eclipse.ui.intro.config
med associerad formatspecifikation
för introduktionsinnehållsfiler finns en fullständig referens över giltiga element, underordnade element och deras attribut.