Toevoegen van help-pagina's

Indien u een help-pagina voor uw plugin wilt schrijven, is de meest directe manier het toevoegen van de betreffende instructies aan de definities van de bijbehorende XML-elementen:

variables <- rk.XML.varselector(
  id.name="vars",
  help="Selecteer het te analyseren gegevensobject.",
  component="Data"
)
    

De tekst in de help-parameter kan dan worden opgehaald door rk.rkh.scan() en worden geschreven naar de help-pagina van deze plugin-component. Maar om dit technisch te laten werken moet rk.rkh.scan() weten welke R-objecten tot één plugin-component behoren. Daarom moet u ook de component-parameter opgeven, en er voor zorgen dat die hetzelfde is voor alle bij elkaar behorende objecten.

Omdat u gewoonlijk vele objecten in een dialoog zult willen combineren, en misschien ook objecten zult willen hergebruiken, zoals de <varslot> in meerdere componenten van uw plugins, is het mogelijk globaal een component te definiëren met de rk.set.comp(). Indien ingesteld, wordt aangenomen dat alle volgende objecten in uw script tot die component behoren, totdat rk.set.comp() opnieuw wordt aangeroepen met een andere componentnaam. Daarna kunt u de component parameter weglaten:

rk.set.comp("Data")
variables <- rk.XML.varselector(
  id.name="vars",
  help="Selecteer het te analyseren gegevensobject."
)
    

U kunt globale secties zoals <summary> (opsomming) of <usage> (gebruik) aan de help-pagina toevoegen met functies zoals rk.rkh.summary() of rk.rkh.usage(). De resultaten daarvan worden dan gebruikt voor het instellen van de list elements zoals summary of usage in de rkh-parameter van rk.plugin.component()/rk.plugin.skeleton().