Definiowanie treści wprowadzenia
Teraz można zająć się samą treścią. Treść jest opisywana w
odniesieniu do stron. Wszystkie strony mają atrybut id.
Jest to identyfikator używany podczas definiowania strony głównej i stron
gotowości oraz w miejscach, w których występują odwołania do strony.
W przeciwnym razie odpowiednie atrybuty zależą od rodzaju
definiowanej strony.
Wyróżnia się dwa podstawowe rodzaje stron:
- Strony statyczne to zwykłe pliki HTML. Te strony wykorzystują
normalne mechanizmy HTML do połączeń z innymi stronami. Strony statyczne
nie muszą być definiowane w pliku treści konfiguracji, oprócz strony
głównej. Ponieważ strona główna jest określona za pomocą identyfikatora
(home-page-id) w elemencie presentation, w pliku treści musi
istnieć definicja strony z tym identyfikatorem. Ta strona musi definiować
tylko adres url. Wszystkie inne podelementy będą ignorowane, ponieważ
treść strony jest opisywana przez samą stronę HTML. Wszystkie inne strony
wprowadzenia w formacie HTML wnoszone przez moduł dodatkowy muszą być
dołączone do tego modułu, ale nie muszą być określone w pliku treści. Ponadto
można używać odwołań do plików HTML znajdujących się w innych modułach
dodatkowych oraz w sieci WWW.
- Strony dynamiczne są opisywane w pliku treści XML przy użyciu
podelementów, które określają treść strony. Podelementy to elementy
interfejsu użytkownika często stosowane na stronach podobnych do HTML. Zależnie
od implementacji strony te będą dynamicznie tłumaczone na HTML
(gdy atrybut kind implementacji ma wartość html) albo dynamicznie
tworzone w postaci formularzy interfejsu użytkownika opartych na pakiecie SWT
(gdy atrybut kind ma wartość swt). Na stronie można zdefiniować
następujące podelementy:
- Element group służy do grupowania innych podelementów i definiowania
wspólnego stylu dla grupy.
- Element link definiuje odsyłacz, który może być wyświetlany
przy użyciu obrazu i tekstu. Odsyłacz może prowadzić do innej strony lub
opcjonalnie uruchamiać akcję wprowadzenia. Akcje są określane jako komendy
w adresie URL.
- Elementy text i img służą do wyświetlania treści tekstowej i
graficznej.
- Element include obejmuje zdefiniowany wcześniej podelement. W
odwołaniach do elementu używa się identyfikatora tego elementu.
- Element head definiuje dodatkowy kod HTML, który zostanie dołączony
w sekcji nagłówka strony, gdy używana będzie implementacja HTML.
- Element html definiuje dodatkowy kod HTML dołączany do treści
strony po wybraniu implementacji HTML.
Dla każdej strony można także zdefiniować element title.
Ponadto można określić, że treść strony została zdefiniowana w osobnym pliku
określonym atrybutem content. Podział strony na osobne pliki może być przydatny z
punktu widzenia wydajności, ponieważ treść stron wprowadzenia nie
będzie wtedy inicjowana, dopóki nie będzie to konieczne.
Najlepszym sposobem poznania formatu definicji treści jest przejrzenie
implementacji z pakietu SDK. Poniższy fragment kodu przedstawia pierwszą część
treści dla strony głównej pakietu SDK, która jest pierwszą wyświetlaną
stroną wprowadzenia.
<introContent>
<page alt-style="css/root_swt.properties" style="css/root.css" id="root" style-id="page">
<title style-id="intro-header">Witamy na platformie Eclipse 3.0</title>
<group id="links-background">
<group id="page-links">
<link label="Przegląd" url="http://org.eclipse.ui.intro/showPage?id=overview" id="overview" style-id="left">
<text>Poznaj produkt Eclipse</text>
</link>
<link label="Kursy" url="http://org.eclipse.ui.intro/showPage?id=tutorials" id="tutorials" style-id="left">
<text>Weź udział w kompleksowych kursach na temat produktu Eclipse</text>
</link>
<link label="Przykłady" url="http://org.eclipse.ui.intro/showPage?id=samples" id="samples" style-id="right">
<text>Poznaj sposób programowania w produkcie Eclipse dzięki przykładom kodu</text>
</link>
<link label="Co nowego" url="http://org.eclipse.ui.intro/showPage?id=news" id="news" style-id="right">
<text>Poznaj nowe funkcje tej wersji</text>
</link>
</group>
</group>
Elementy na stronie mogą zostać także odfiltrowane (filteredFrom) z
konkretnej implementacji. Pozwala to projektantom stron tworzyć je dla
konkretnych platform. Podczas opisywania strony i jej treści można użyć
wielu przydatnych atrybutów. Kompletny opis poprawnych elementów,
podelementów i ich atrybutów można znaleźć w dokumentacji punktu rozszerzenia
org.eclipse.ui.intro.config
i powiązanej z nim
specyfikacji
formatu pliku treści wprowadzenia.