Inleidingscontent definiëren
Nu kan de content zelf worden besproken. De content wordt beschreven aan de hand van pagina's. Alle pagina's hebben het kenmerk id.
Dit is het ID dat wordt gebruikt voor het definiëren van de pagina's Home en Standby en andere plaatsen die een verwijzing naar een pagina bevatten. Voor het overige zijn de relevante kenmerken afhankelijk van het type pagina dat is gedefinieerd.
Er zijn twee basistypen pagina's:
- Statische pagina's zijn normale HTML-bestanden. Deze pagina's gebruiken de normale HTML-mechanismen voor een link naar andere pagina's. Statische pagina's hoeven niet te worden gedefinieerd in het config-contentbestand, behalve de homepage. Omdat de homepage wordt opgegeven aan de hand van het ID (homepage-id) in het element presentatie, moet er een paginadefinitie zijn waarin dit ID in het contentbestand wordt gebruikt. Deze pagina moet alleen een url definiëren. Alle andere subelementen worden genegeerd, omdat de HTML-pagina zelf de paginacontent beschrijft. Alle andere HTML-inleidingspagina's die door de plugin worden verstrekt, moeten bij de plugin zijn gevoegd, maar hoeven niet te zijn opgegeven in het contentbestand. Ook kan worden verwezen naar HTML-bestanden die zich in andere plugins of op het web bevinden.
- Dynamische pagina's worden in het XML-contentbestand beschreven met behulp van subelementen die de inhoud van de pagina beschrijven. De subelementen zijn gebruikersinterface-items die vaak worden aangetroffen op HTML-achtige pagina's. Afhankelijk van de implementatie worden deze pagina's of dynamisch vertaald naar HTML (wanneer de implementatie-soort html is) of dynamisch gemaakt als SWT-gebaseerde UI-formulieren (wanneer de implementatie-soort swt is). De volgende subelementen kunnen worden gedefinieerd in een pagina:
- Het element group groepeert andere subelementen en biedt een consistente stijl voor de gehele groep.
- Het element link definieert de link die kan worden weergegeven met behulp van een afbeelding en tekst. De link kan naar een andere pagina navigeren en optioneel een inleidingsactie uitvoeren. Acties worden opgegeven als opdrachten in de URL.
- De elementen text en img tonen tekst- en afbeeldingscontent.
- Het element include bevat een eerder gedefinieerd subelement. Naar dit element wordt verwezen met behulp van het ID.
- Het element head definieert extra HTML die moet worden opgenomen in de kopsectie van de pagina als de HTML-implementatie wordt gebruikt.
- Het element html definieert extra HTML die moet worden opgenomen in de tekst van de pagina als de HTML-implementatie wordt gebruikt.
Het element title kan ook worden gedefinieerd om een titel voor de pagina in te stellen. Voor een pagina kan ook worden opgegeven dat de content is gedefinieerd in een apart contentbestand. Het opsplitsen van de pagina's in verschillende bestanden kan handig zijn wanneer de prestaties van belang zijn, omdat de content van een inleidingspagina pas wordt geïnitialiseerd als deze nodig is.
De beste manier om vertrouwd te raken met de indeling van contentdefinities is het doorbladeren van de implementaties in de SDK van Eclipse. Gebruik de onderstaande snippet als voorbeeld:
<introContent>
<page alt-style="css/root_swt.properties" style="css/root.css" id="root" style-id="page">
<title style-id="intro-header">Welkom bij het Eclipse-platform</title>
<group id="links-background">
<group id="page-links">
<link label="Overzicht" url="http://org.eclipse.ui.intro/showPage?id=overview" id="overview" style-id="left">
<text>Alles over Eclipse</text>
</link>
<link label="Zelfstudieprogramma's" url="http://org.eclipse.ui.intro/showPage?id=tutorials" id="tutorials" style-id="left">
<text>Hulp bij het stapsgewijs doorlopen van Eclipse-zelfstudieprogramma's</text>
</link>
<link label="Voorbeelden" url="http://org.eclipse.ui.intro/showPage?id=samples" id="samples" style-id="right">
<text>Ontwikkeling in Eclipse verkennen met behulp van codevoorbeelden</text>
</link>
<link label="Wat is er nieuw?" url="http://org.eclipse.ui.intro/showPage?id=news" id="news" style-id="right">
<text>Nieuwe functionaliteit in deze release</text>
</link>
</group>
</group>
...
Elementen op een pagina kunnen ook worden filteredFrom (gefilterd uit) een bepaalde implementatie. Dit maakt het mogelijk voor paginaontwerpers om een ontwerp te maken op basis van bepaalde platforms. Er zijn nog veel meer krachtige kenmerken die kunnen worden gebruikt voor het beschrijven van een pagina en de inhoud. Zie de extensiepuntdocumentatie over org.eclipse.ui.intro.config
en de bijbehorende indelingsgegevens voor inleidingscontentbestanden voor volledig naslagmateriaal over geldige elementen, subelementen en hun kenmerken.