Merkinnän ohjeen lisäys

Seuraavassa perehdytään readme-työkalun merkintöjen ohjeen lisäykseen.  Merkinnän ohje lisätään org.eclipse.ui.ide.markerHelp-laajennuspisteen avulla.  Tämän laajennuspisteen avulla lisäosat voivat liittää ohjekontekstin tunnuksen tietynlaiseen merkintään.  Merkintä voi olla tarkennettu ainoastaan merkinnän lajilla, tai se voi olla tarkemmin tarkennettu yhden tai usean määritteensä arvolla.  Readme-työkalu esittelee useita erilaisia ohjekonteksteja:

<extension point="org.eclipse.ui.ide.markerHelp"> 
   <markerHelp 
      markerType="org.eclipse.ui.examples.readmetool.readmemarker" 
      helpContextId="org.eclipse.ui.examples.readmetool.marker_example1_context"> 
      <attribute name="org.eclipse.ui.examples.readmetool.id" value= "1234"/> 
   </markerHelp> 
   <markerHelp 
      markerType="org.eclipse.ui.examples.readmetool.readmemarker" 
      helpContextId="org.eclipse.ui.examples.readmetool.marker_example2_context"> 
      <attribute name="org.eclipse.ui.examples.readmetool.level" value= "7"/> 
   </markerHelp> 
   <markerHelp 
      markerType="org.eclipse.ui.examples.readmetool.readmemarker" 
      helpContextId="org.eclipse.ui.examples.readmetool.marker_example3_context"> 
      <attribute name="org.eclipse.ui.examples.readmetool.level" value= "7"/> 
      <attribute name="org.eclipse.ui.examples.readmetool.department" value= "infra"/> 
   </markerHelp> 
   ...

Jokainen merkinnän ohjekonteksti on määritetty readme-merkintälajille.  Kukin ohjekonteksti on kuitenkin liitetty erilaiseen määritteiden arvon yhdistelmään.  Ensimmäistä merkinnän ohjekontekstia käytetään merkinnöille, joiden id-määritteeksi on asetettu "1234".  Ohjekontekstit määritetään lisäosan HelpContexts.xml-tiedostossa:

<context id="marker_example1_context" >
	<description>Readme marker example 1 <b>Help</b> id = 1234 </description>
</context>

Kun valitaan readme-merkintä, jonka id="1234" ja valitaan ohje F1-näppäintä painamalla, näkyviin tuleekin ohjekuvaus.

Tehtävät-luettelo, jossa on merkinnän ohje