Λειτουργία επεξεργασίας συμφραστικής βοήθειας

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

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

Η σελίδα Πρωτογενής κώδικας της λειτουργίας επεξεργασίας παρέχει μια προβολή κειμένου του αρχείου xml. Το αρχείο xml μπορεί να τροποποιηθεί απευθείας και οι αλλαγές, αν είναι έγκυρες, αντικατοπτρίζονται στη σελίδα γραφικών Ορισμός.

Προσθήκη νέου περιβάλλοντος βοήθειας

Λειτουργία επεξεργασίας περιβάλλοντος βοήθειας με συμπληρωμένα πεδία

Για την προσθήκη νέου περιβάλλοντος, πατήστε το κουμπί Προσθήκη περιβάλλοντος. Με αυτόν τον τρόπο θα προστεθεί μια νέα καταχώρηση περιβάλλοντος στο αρχείο xml και θα εμφανίζεται στη διακλάδωση στη σελίδα Ορισμός. Θα γίνει η επιλογή του νέου περιβάλλοντος, ανοίγοντας μια ενότητα λεπτομερειών στη δεξιά στήλη της λειτουργίας επεξεργασίας. Σε αυτήν την ενότητα λεπτομερειών, μπορείτε να παράσχετε αναλυτικές πληροφορίες σχετικά με το περιβάλλον περιλαμβάνοντας:

Προσθήκη θεμάτων και εντολών βοήθειας

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

Λειτουργία επεξεργασίας περιβάλλοντος βοήθειας με συμπληρωμένα πεδία λεπτομερειών

Πατώντας το κουμπί Προσθήκη θέματος, μπορείτε να προσθέσετε μια νέα καταχώρηση θέματος στο αρχείο xml σε ένα από τα περιβάλλοντα βοήθειας. Ένα θέμα θα εμφανίζεται στο χρήστη ως διασύνδεση. Μόλις δημιουργηθεί ένα νέο θέμα, μπορείτε να το επιλέξετε για να ανοίξετε την ενότητα Λεπτομέρειες θέματος στη δεξιά στήλη της σελίδας Ορισμός. Στην ενότητα λεπτομερειών μπορείτε να αλλάξετε την ετικέτα που θα εμφανίζεται στο χρήστη και τη θέση του αρχείου με το οποίο θα διασυνδέεται. Στις περισσότερες περιπτώσεις, το διασυνδεδεμένο αρχείο θα είναι μια σελίδα html στο σύστημα βοήθειας. Μπορείτε να χρησιμοποιήσετε το κουμπί Αναζήτηση... για να αναζητήσετε ένα αρχείο προς διασύνδεση.

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

Εντολή προσθήκης λειτουργίας επεξεργασίας περιβάλλοντος βοήθειας

Με το πάτημα του κουμπιού Προσθήκη εντολής, προστίθεται μια νέα εντολή. Μπορείτε να τροποποιήσετε τις λεπτομέρειες των εντολών με τον ίδιο τρόπο που τροποποιείτε θέματα.

Εντολές αφαίρεσης, πάνω, κάτω

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

Περιβάλλον βοήθειας με κουμπιά χειρισμού

Τα εν λόγω κουμπιά είναι:

Καταχώρηση του αρχείου συμφραστικής βοήθειας

Προκειμένου το Eclipse να αναγνωρίσει το αρχείο xml συμφραστικής βοήθειας ως προέλευση για το δυναμικό σύστημα αρχείων, πρέπει να καταχωρηθεί μέσω του σημείου επέκτασης org.eclipse.help.contexts. Η λειτουργία επεξεργασίας παρέχει έναν τρόπο αυτόματης καταχώρησης του αρχείου συμφραστικής βοήθειας. Στην πάνω δεξιά γωνία της λειτουργίας επεξεργασίας, υπάρχει μια διασύνδεση με το όνομα "Καταχωρήστε αυτό το αρχείο συμφραστικής βοήθειας". Αν επιλέξετε αυτή τη διασύνδεση θα προστεθεί η σωστή καταχώρηση στο αρχείο plugin.xml.