Παραγωγή περιεχομένου βοήθειας

org.eclipse.help.contentProducer

3.0

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

<!ELEMENT extension (contentProducer | binding)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT contentProducer (producer)>

<!ATTLIST contentProducer

producer CDATA #IMPLIED>


<!ELEMENT producer (parameter*)>

<!ATTLIST producer

class CDATA #REQUIRED>


<!ELEMENT parameter EMPTY>

<!ATTLIST parameter

name  CDATA #REQUIRED

value CDATA #REQUIRED>


<!ELEMENT binding EMPTY>

<!ATTLIST binding

producerId CDATA #REQUIRED>


Παρακάτω δίνεται ένα παράδειγμα χρήσης του σημείου επέκτασης λειτουργίας επεξεργασίας παραγωγής:

  

<extension point=

"org.eclipse.help.contentProducer"

id=

"org.eclipse.myPlugin.myDynamicHelpProducer"

name=

"My Dynamic Help Content"

>

<contentProducer producer=

"org.eclipse.myPlugin.myPackage.Myproducer"

/>

</extension>

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

Καμία. Αν μια πρόσθετη λειτουργία τεκμηρίωσης δεν παρέχει παραγωγή περιεχομένου βοήθειας ή αν μια κλήση προς αυτή δεν έχει αποτέλεσμα, τότε το σύστημα βοήθειας αναζητά doc.zip και το σύστημα αρχείων στη θέση εγκατάστασης της πρόσθετης λειτουργίας για ένα στατικό έγγραφο και εμφανίζει το περιεχόμενό του.