{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"dc1d9a79-7f51-4a3d-8553-fc9eea776545"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Purpose","type":"text"}]},{"type":"paragraph","content":[{"text":"This page is a step by step guide to add help to a module. This help will be displayed in the help menu of the SNAP application.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Step by step guide","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1","type":"text","marks":[{"type":"strong"}]},{"text":" Add the following line to the ","type":"text"},{"text":"manifest.mf","type":"text","marks":[{"type":"strong"}]},{"text":" file","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"full-width"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1619.0]},"content":[{"type":"paragraph","content":[{"text":"OpenIDE-Module-Layer: org/esa/snap/","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":"/layer.xml","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"For example: The layer for the module ","type":"text"},{"text":"snap-aatsr-sst","type":"text","marks":[{"type":"em"}]},{"text":" the layer file should be placed at ","type":"text"},{"text":"org/esa/snap/aatsr/sst/layer.xml","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"2","type":"text","marks":[{"type":"strong"}]},{"text":" Create or update the layer.xml file in the resources section at the location given above","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\n \n \n --helpset.xml\" url=\"helpset.xml\">\n \n \n \n \n\n\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"The helpset file name must be unique, so we use the filename convention","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":"--helpset.xml. Dots in the groupId shall be replaced by dashes '-'","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The \"position\" defines where the help will appear. To choose a position please refer to the \"Menu organisation\" bellow","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3","type":"text","marks":[{"type":"strong"}]},{"text":" Create the ","type":"text"},{"text":"helpset.xml","type":"text","marks":[{"type":"em"}]},{"text":" next to the ","type":"text"},{"text":"layer.xml","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n//docs/help.hs\" merge=\"true\"/>","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"It is ","type":"text"},{"text":"important","type":"text","marks":[{"type":"strong"}]},{"text":" that the path to helpset is derived from the ","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":" and the","type":"text"},{"text":" as defined in the pom file of the module","type":"text","marks":[{"type":"em"}]},{"text":". For the ","type":"text"},{"text":"snap-aatsr-sst","type":"text","marks":[{"type":"em"}]},{"text":" module the path must be ","type":"text"},{"text":"/org/esa/snap/snap/aatsr/sst/docs/help.hs. ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"In this case the term 'snap' is not accidentally duplicated. It is needed. The group Id ends with 'snap'and the artifactId starts with 'snap'. This might be different in your case.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"While the ","type":"text"},{"text":"docs","type":"text","marks":[{"type":"em"}]},{"text":" folder is ","type":"text"},{"text":"necessary","type":"text","marks":[{"type":"strong"}]},{"text":", the name of the helpset file can be freely chosen. As convention we want to name it ","type":"text"},{"text":"\"help.hs\"","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"4","type":"text","marks":[{"type":"strong"}]},{"text":" Add the help content.","type":"text"}]},{"type":"paragraph","content":[{"text":"It must be added in a folder named ","type":"text"},{"text":"javahelp which ","type":"text","marks":[{"type":"em"}]},{"text":"must","type":"text","marks":[{"type":"strong"}]},{"text":" be created under","type":"text"},{"text":" src/main","type":"text","marks":[{"type":"em"}]},{"text":". Here, create the path which is given in the ","type":"text"},{"text":"helpset.xml","type":"text","marks":[{"type":"em"}]},{"text":" above. It is also ","type":"text"},{"text":"mandatory","type":"text","marks":[{"type":"strong"}]},{"text":" that the path ends with the ","type":"text"},{"text":"docs","type":"text","marks":[{"type":"em"}]},{"text":" folder. Finally, you end up with a path for the sst example which looks like ","type":"text"},{"text":"src/main/javahelp/org/esa/snap/snap/aatsr/sst/docs/help.hs","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"docs","type":"text","marks":[{"type":"em"}]},{"text":" folder you can place the javahelp content as normal:","type":"text"}]},{"type":"paragraph","content":[{"text":"help.hs references all help files (map.j,m toc.xml, search, ...)","type":"text"}]},{"type":"paragraph","content":[{"text":"maps.jhm make the links between help page id and urls","type":"text"}]},{"type":"paragraph","content":[{"text":"toc.xml is the table of content, it lists the pages to display and menu entries, telling what page is displayed where. To add a help page to an existing help menu it must match the menu organisation bellow. For example, to add a geometric processor the toc.xml file could look like that:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"toc.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\n\n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Where myGeometricProcessor is the id of the help page referenced in the map.jhm file. For more information about javahelp see ","type":"text"},{"text":"jhug.pdf","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/download/attachments/14811190/jhug.pdf?version=1&modificationDate=1432213504299&cacheVersion=1&api=v2"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Tips and Tricks","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Opening external links","type":"text"}]},{"type":"paragraph","content":[{"text":"It is possible to open external web help in the default web browser instead of the javahelp window. For this, the external links need to be changed, by example for the BeamDataSources.html page, change","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"https://earth.esa.int/web/guest/pi-community/apply-for-data","type":"text"}]},{"type":"paragraph","content":[{"text":"to","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"

","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Remark","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The dependency ","type":"text"},{"text":"org-netbeans-modules-extbrowser","type":"text","marks":[{"type":"code"}]},{"text":" must be added to the Platform application.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unfortunately repeating the link as fall back within the object tag is not working in NetBeans. Actually, it should be used as an alternative if the ","type":"text"},{"text":"BrowserDisplayer","type":"text","marks":[{"type":"code"}]},{"text":" is not available, e.g. the page is displayed in a normal web browser. ","type":"text"},{"type":"hardBreak"},{"text":"Using a URL in the alternative link seems to break the javahelp. When running the jhindexer an exception is thrown like ","type":"text"},{"text":"java.lang.ArrayIndexOutOfBoundsException: -845100606","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"See: ","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DevFaqHelpGuidelines","type":"text","marks":[{"type":"code"},{"type":"link","attrs":{"href":"http://wiki.netbeans.org/DevFaqHelpGuidelines#How_do_I_make_a_link_to_an_external_web_page_open_in_the_IDE.27s_external_web_browser.3F"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"netbeans-modules-javahelp API","type":"text","marks":[{"type":"code"},{"type":"link","attrs":{"href":"http://bits.netbeans.org/dev/javadoc/org-netbeans-modules-javahelp/org/netbeans/api/javahelp/doc-files/api.html"}}]}]}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Creating a link between pages of different modules","type":"text"}]},{"type":"paragraph","content":[{"text":"It is possible to create a link between pages of different modules, for this it is necessary to specify the full path to the module. One common example is \"BeamOverview\".","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"should be replaced by","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Resources","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NetBeans Help Guidelines","type":"text","marks":[{"type":"link","attrs":{"href":"http://wiki.netbeans.org/HelpGuidelines"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NetBeans Maven Platform Tutorial with Helpset Registration","type":"text","marks":[{"type":"link","attrs":{"href":"https://netbeans.org/community/magazine/html/04/maven.html"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JavaHelp System User's Guide","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.oracle.com/cd/E19253-01/819-0913/819-0913.pdf"}}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Menu organisation","type":"text"}]},{"type":"paragraph","content":[{"text":"The following tree represents the help menu. When the help menu item is followed by a number, it represents the position of this item as specified in the layer.xml file. The relative position of two items in the same sub-menu is determined by this number, the lowest number goes higher in the menu. These number must be unique.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"General: 1000","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Overview","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Definition","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Data Sources","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BEAM-DIMAP Format","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The 'pconvert' Tool","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Application: 2000","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Introduction","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Menus and Toolbars: 2100","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Menus bar","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"File","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"View","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tools","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Processing","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Window","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Help","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Toolbar","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Product View: 2200","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Product Browser","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Imaging Tools","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Analysis Tools","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Import & Export: 2300","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Import raster data: 2310","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SAR: 2315","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GeoTiff: 2320","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Spot: 2330","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"RapidEye: 2331","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Envi: 2340","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NASA Ocean Color: 2350","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Import vector data: 2360","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Export raster data: 2370","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Other exports: 2380","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Extract pixel value: 2395","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tools: 2400","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create band from Math Expression: 2410","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Graph Tools: 2420","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"... (Tools menu)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Plugins","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Preference","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"External Tools: 2480","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Command Line Interface: 3000","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GPF Overview","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GPF Graph Processing Tools","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GPF Operator Index","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Processors: 4000","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pre-processing: 4010","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MERIS L1B Radiometry Correction: 4020","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cloud probability processor: 4025","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Geometric Operations: 4100","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Collocation: 4110","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Image Analysis: 4200","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cluster analysis: 4210","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Image analysis: 4220","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Land Processing: 4300","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NDVI: 4310","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SMACS Processor: 4350","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Water Processing: 4400","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SST Processor","type":"text","marks":[{"type":"textColor","attrs":{"color":"#008000"}}]},{"text":": 4410","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FLH/MCI Processor","type":"text","marks":[{"type":"textColor","attrs":{"color":"#008000"}}]},{"text":": 4420","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Level 3 Binning: 4700","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SAR Processing: 5000","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}