Φίλτρα

Εάν ορισμένες ενότητες του εγγράφου σας εμφανίζονται μόνο σε συγκεκριμένο περιβάλλον, μπορείτε να χρησιμοποιήσετε φιλτράρισμα μορφοποίησης για να ορίσετε τα κριτήρια που πρέπει να πληρούνται για να εμφανιστεί η ενότητα του εγγράφου. Εάν τα κριτήρια δεν πληρούνται, η ενότητα του εγγράφου δεν θα είναι ορατή στο χρήστη. Τα φίλτρα μπορούν να καθοριστούν σε οποιοδήποτε στοιχείο XML, εφόσον η μορφοποίηση θα είναι ακόμη έγκυρη μετά την επεξεργασία. Εάν φιλτραριστεί ένα στοιχείο, όλα τα στοιχεία και το κείμενο που περιλαμβάνονται στο αυτό θα φιλτραριστούν επίσης.

Ο πίνακας που ακολουθεί περιέχει μία ολοκληρωμένη λίστα όλων των ιδιοτήτων των φίλτρων και των πιθανών τιμών τους.

Ιδιότητα Σημασία Πιθανές τιμές
os λειτουργικό σύστημα win32, win32, linux, macosx, aix, solaris, hpux, qnx
ws σύστημα παραθύρων win32, motif, gtk, photon, carbon
arch αρχιτεκτονική του επεξεργαστή x86, x86_64, ia64, ia64_32, ppc, PA_RISC, sparc
product ταυτότητα προϊόντος eclipse Ταυτότητα οποιουδήποτε προϊόντος (π.χ., για SDK, org.eclipse.sdk.ide)
plugin παρουσία πρόσθετης λειτουργίας Ταυτότητα οποιασδήποτε πρόσθετης λειτουργίας (π.χ. org.eclipse.help)
category κατηγορία δραστηριοτήτων Ταυτότητα οποιασδήποτε κατηγορίας δραστηριοτήτων (π.χ. για κατηγορία "Συνεργασία", org.eclipse.categories.teamCategory)
activity δραστηριότητα (δυνατότητα) Ταυτότητα οποιασδήποτε δραστηριότητας (π.χ. για δραστηριότητα "Υποστήριξη CVS", org.eclipse.team.cvs)

Εάν το όνομα δε συμφωνεί με καμία από τις προκαθορισμένες ιδιότητες, το σύστημα βοήθειας θα χρησιμοποιήσει την ιδιότητα του συστήματος JVM με αυτό το όνομα. Για παράδειγμα, μπορείτε να καταχωρήσετε κατά την εκκίνηση οποιαδήποτε ιδιότητα έχει καθοριστεί από το χρήστη, όπως -Dlocation=paris,france και να φιλτράρετε σύμφωνα με αυτή.

Υπάρχουν δύο τρόποι καθορισμού φίλτρου σε ένα στοιχείο: χρήση γνωρισμάτων ή στοιχείων.

Γνώρισμα φίλτρου

Η πρώτη μορφή είναι η προσθήκη ενός γνωρίσματος filter στο στοιχείο. Η γενική μορφή είναι η εξής:

   <element filter="[name][operator][value]">
      Some text.
   </element>

Tο name είναι το όνομα της ιδιότητας, σύμφωνα με την οποία γίνεται το φιλτράρισμα, για παράδειγμα os για λειτουργικό σύστημα. Το operator είναι είτε = που σημαίνει ότι αντιστοιχεί (ακριβής αντιστοιχία, διάκριση πεζών/κεφαλαίων), είτε != που σημαίνει ότι δεν αντιστοιχεί. Tο value δηλώνει που πρέπει (ή δεν πρέπει) να αντιστοιχεί η ιδιότητα. Για παράδειγμα, για το os, μία από τις πιθανές τιμές είναι win32 (Windows). Στον πίνακα που ακολουθεί βρίσκεται μια ολοκληρωμένη λίστα των ιδιοτήτων φίλτρων και οι τιμές τους.

Το παρακάτω παράδειγμα δείχνει τον τρόπο που εμφανίζεται μια παράγραφος ενός κειμένου σε ένα έγγραφο XHTML, μόνο κατά τη λειτουργία του Linux.

   <p filter="os=linux">
      Αυτό το μήνυμα εμφανίζεται μόνο σε Linux.
   </p>

Στο δεύτερο παράδειγμα, η διασύνδεση εμφανίζεται μόνο αν δεν έχει εγκατασταθεί η πρόσθετη λειτουργία com.my.plugin:

   <a href="..." filter="plugin!=com.my.plugin">
      Πατήστε εδώ για τη μεταφόρτωση της πρόσθετης λειτουργίας com.my.plugin.
   </a>

Στοιχείο φίλτρου

Η δεύτερη μορφή χρησιμοποιεί το στοιχείο filter ως θυγατρικό του στοιχείου που θέλετε να φιλτράρετε. Αυτή η μορφή είναι ελαφρώς πιο μεγάλη από τη μορφή γνωρίσματος, είναι όμως πιο δυναμική επειδή μπορείτε να ορίσετε οποιονδήποτε αριθμό φίλτρων σε ένα στοιχείο. Η γενική μορφή είναι η εξής:

   <element attribute="value">
      <filter name="[name]" value="[modifier][value]"/>
   </element>

Tα στοιχεία name και value είναι τα ίδια όπως και στο γνώρισμα. Ωστόσο, εφόσον είναι διαχωρισμένα, πρέπει να βρεθεί άλλος τρόπος καθορισμού εάν θα υπάρχει αντιστοιχία ή όχι. Ως προεπιλογή, εάν δεν παρέχετε ένα modifier, θεωρείται ότι υπάρχει αντιστοιχία. Εάν δεν πρέπει να υπάρχει αντιστοιχία, ορίστε τον τροποποιητή σε "! "

Ακολουθεί το πρώτο παράδειγμα στη δεύτερη μορφή του:

   <p>
      <filter name="os" value="linux"/>
      Αυτό το μήνυμα εμφανίζεται μόνο σε Linux.
   </p>

Και το δεύτερο παράδειγμα:

   <a href="...">
      <filter name="plugin" value="!com.my.plugin"/>
      Πατήστε εδώ για τη μεταφόρτωση της πρόσθετης λειτουργίας com.my.plugin.
   </a>

Κέντρο πληροφοριών

Η υποστήριξη φιλτραρίσματος είναι απενεργοποιημένη όταν εκτελείται βοήθεια σε κατάσταση κέντρο πληροφοριών, με αποτέλεσμα να είναι ορατό όλο το περιεχόμενο, συμπεριλαμβανομένου του φιλτραρισμένου. Εάν σκοπεύετε να έχετε την τεκμηρίωσή σας τόσο σε κατάσταση πάγκου εργασίας όσο και σε κατάσταση κέντρου πληροφοριών, πρέπει να χρησιμοποιείτε φίλτρα ώστε να βγαίνει νόημα ακόμη και όταν το φιλτράρισμα είναι απενεργοποιημένο.

Πού μπορώ να χρησιμοποιήσω φίλτρα;

Η λειτουργία φιλτραρίσματος μπορεί να χρησιμοποιηθεί στα ακόλουθα είδη εγγράφων:

* Σημείωση: υπάρχουν ορισμένα επιπρόσθετα βήματα που απαιτούνται για την ενεργοποίηση δυναμικού περιεχομένου στα έγγραφα XHTML.

Σε καμία περίπτωση, δεν πρέπει να τοποθετείτε φίλτρα σε οποιοδήποτε στοιχείο, η αφαίρεση των οποίων θα είχε ως αποτέλεσμα ένα μη έγκυρο XML. Για παράδειγμα, δεν πρέπει να τοποθετείτε φίλτρο στο στοιχείο html σε XHTML, επειδή χωρίς αυτό το στοιχείο το XHTML δεν θα είναι πλέον έγκυρο.