Ορισμός περιεχομένου εισαγωγικού τμήματος
Τώρα μπορούμε να επικεντρωθούμε στο ίδιο το περιεχόμενο. Το περιεχόμενο περιγράφεται σε σελίδες. Όλες οι σελίδες έχουν ένα γνώρισμα id.
Πρόκειται για την ταυτότητα που χρησιμοποιείται όταν ορίζεται η αρχική και η εναλλακτική σελίδα, καθώς και άλλες θέσεις όπου υπάρχει παραπομπή σε μια σελίδα. Σε διαφορετική περίπτωση, τα σχετικά γνωρίσματα θα εξαρτώνται από το είδος της σελίδας που ορίζεται.
Υπάρχουν δύο βασικά είδη σελίδων:
- Οι στατικές σελίδες είναι απλά αρχεία HTML. Οι σελίδες αυτές χρησιμοποιούν τους κανονικούς μηχανισμούς HTML για τη διασύνδεση με άλλες σελίδες. Οι στατικές σελίδες δεν χρειάζεται να οριστούν στο αρχείο περιεχομένου ρυθμίσεων, εκτός κι αν πρόκειται για την αρχική σελίδα. Καθώς η αρχική σελίδα προσδιορίζεται από μια ταυτότητα (home-page-id) στο στοιχείο presentation, πρέπει να υπάρχει ένας ορισμός σελίδας που θα χρησιμοποιεί την ταυτότητα αυτή στο αρχείο περιεχομένου. Για τη σελίδα αυτή απαιτείται μόνο ο ορισμός ενός url. Όλα τα άλλα υποστοιχεία θα παραβλέπονται, καθώς η ίδια η σελίδα HTML θα περιγράφει το περιεχόμενο σελίδας. Όλες οι άλλες εισαγωγικές σελίδες HTML οι οποίες συνεισφέρονται από την πρόσθετη λειτουργία, πρέπει να συμπεριλαμβάνονται σε αυτή, αλλά δεν χρειάζεται να προσδιορίζονται στο αρχείο περιεχομένου. Μπορεί να γίνεται επίσης παραπομπή σε αρχεία HTML που βρίσκονται σε άλλες πρόσθετες λειτουργίες ή στο διαδίκτυο.
- Οι δυναμικές σελίδες περιγράφονται στο αρχείο περιεχομένου XML, με τη χρήση υποστοιχείων τα οποία περιγράφουν το περιεχόμενο της σελίδας. Τα υποστοιχεία είναι αντικείμενα του περιβάλλοντος χρήστη που συχνά απαντώνται σε σελίδες της μορφής HTML. Ανάλογα με την υλοποίηση, οι σελίδες αυτές είτε θα μεταφράζονται δυναμικά σε HTML (όταν το γνώρισμα kind του στοιχείου implementation είναι html) είτε θα δημιουργούνται δυναμικά ως πρόσθετη λειτουργία "Φόρμες γραφικού περιβάλλοντος χρήστη" που βασίζεται σε SWT (όταν το γνώρισμα kind του στοιχείου implementation είναι swt). Σε μια σελίδα μπορούν να οριστούν τα παρακάτω υποστοιχεία:
- Το group χρησιμοποιείται για την ομαδοποίηση άλλων υποστοιχείων και ορίζει ένα σταθερό στυλ για όλη την ομάδα.
- Το link ορίζει μια διασύνδεση η οποία μπορεί να εμφανιστεί με τη χρήση εικόνας και κειμένου. Η διασύνδεση μπορεί να δίνει τη δυνατότητα πλοήγησης σε άλλη σελίδα και προαιρετικά να εκτελεί μια ενέργεια εισαγωγής. Οι ενέργειες προσδιορίζονται ως εντολές στο URL.
- Τα στοιχεία text και img εμφανίζουν το περιεχόμενο κειμένου και εικόνας.
- Το στοιχείο include συμπεριλαμβάνει ένα υποστοιχείο το οποίο έχει οριστεί προηγουμένως. Η παραπομπή στο στοιχείο γίνεται με τη χρήση της ταυτότητάς του.
- Το στοιχείο head ορίζει ένα πρόσθετο HTML που θα συμπεριλαμβάνεται στην ενότητα κεφαλίδας της σελίδας, όταν χρησιμοποιείται η υλοποίηση html.
- Το στοιχείο html ορίζει ένα πρόσθετο HTML που θα συμπεριλαμβάνεται στο κύριο σώμα της σελίδας, όταν χρησιμοποιείται η υλοποίηση html.
Μπορεί επίσης να ορίζεται ένα στοιχείο title για μια σελίδα. Μια σελίδα μπορεί επίσης να προσδιορίζει ότι το περιεχόμενό της ορίζεται σε ένα ξεχωριστό αρχείο content. Ο διαχωρισμός των σελίδων σε ξεχωριστά αρχεία μπορεί να χρησιμοποιηθεί όταν το ζητούμενο είναι η απόδοση, καθώς δεν αποδίδονται αρχικές τιμές στα περιεχόμενα μιας σελίδας εισαγωγής, εάν δεν χρειάζεται.
Ο καλύτερος τρόπος για να κατανοήσετε τη μορφή ορισμού περιεχομένου είναι να
αναζητήσετε τις υλοποιήσεις στο SDK του Eclipse. Ως παράδειγμα, ακολουθεί το
εξής τμήμα κώδικα:
<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>
...
Τα στοιχεία μιας σελίδας μπορούν να ληφθούν επίσης από μια συγκεκριμένη υλοποίηση με filteredFrom. Αυτό δίνει τη δυνατότητα στους σχεδιαστές της σελίδας να σχεδιάζουν έχοντας υπόψη συγκεκριμένες πλατφόρμες. Υπάρχουν πολλά ακόμη ισχυρά γνωρίσματα που μπορούν να χρησιμοποιηθούν για την περιγραφή μιας σελίδας και των περιεχομένων της. Ανατρέξτε στην τεκμηρίωση του σημείου επέκτασης org.eclipse.ui.intro.config και στη σχετική προδιαγραφή μορφής του αρχείου περιεχομένου εισαγωγικού τμήματος όπου αναφέρονται όλα τα έγκυρα στοιχεία, υποστοιχεία και γνωρίσματα αυτών.