Verschillende componenten van de Help-informatie voor gebruikers bieden mogelijkheden voor dynamische content. Dynamisch wil zeggen dat de content kan verschillen, afhankelijk van de omgeving of context waarin de gebruiker zich op dat moment bevindt. U kunt bijvoorbeeld instellen dat een bepaald gedeelte van uw Help-document of welkomstpagina alleen wordt weergegeven als de gebruiker een bepaalde voorziening heeft ingeschakeld.
Er zijn twee basismethoden om dynamische content te maken. De ene is tags en kenmerken (annotaties) aan uw XML-markup toe te voegen met instructies om bepaalde gedeelten of documenten uit het systeem te filteren of secties uit andere documenten in te voegen. U kunt ook ankers opgeven waardoor de documentatie kan worden uitgebreid met behulp van andere componenten.
De andere methode is uw eigen contentproducent te schrijven door Java-code in te voegen waarmee de content vanaf het begin wordt geschreven of waarmee bestaande documenten direct worden verwerkt. Hieronder worden beide methoden beschreven.
Voor meer informatie over elk aspect van de markup, klikt u op de links hierboven of raadpleegt u de onderwerpen in de inhoudsopgave.
Dit wordt gedemonstreerd in het onderstaande XHTML-fragment:
<p> Dit is een statische alinea. </p> <!-- Deze tag wordt vervangen door de volgende verwijzingstag --> <include path="my.plugin.id/path/my_other_document.xhtml/element_id"/> <ul> <li> Dit is een statisch lijstitem. </li> <li filter="os=win32"> Dit wordt alleen weergegeven in Windows. </li> <li filter="plugin!=org.eclipse.help"> Dit wordt alleen weergegeven als plugin org.eclipse.help NIET is geïnstalleerd. </li> </ul> <!-- Een punt waar andere componenten content kunnen invoegen --> <anchor id="my.anchor.id"/>
Een contentproducent is een mechanisme voor het invoegen van Java-code om de documentcontent direct in te voegen. Contentproducenten bieden meer mogelijkheden dan XML-annotaties, maar het gebruik ervan is iets ingewikkelder.
Contentproducenten worden ondersteund in de volgende Help-informatie voor gebruikers: