<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta content="text/html;charset=UTF-8" http-equiv="Content-Type"></head><body ><div style='font-size:10pt;font-family:Verdana,Arial,Helvetica,sans-serif;'>Hi Marcel,<br><br>Thank you for your time and reply.<br><br>I understand what the openOn: method does.<br><br>Here is what I would like to do...<br><br>In my <br><br><b>CustomHelp subclass: #CMakeVMMakerSqueakHelp</b><br><br>I have the class side method <br><br><b>pages<br> ^#(overview prerequisites namingConventions )<br></b><br><br>When I run<br><br><b>HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp</b><br><br>it opens the HelpBrowser just fine and the pages appear in the left hand panel.<br><br><br>What I would like to do is have it select the namingConventions page <br>Something like:<br><br><b>HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp page: #namingConventions</b><br><br><br>If the functionality does not exist, so be it. I may try adding it at another time.<br><br>cheers,<br><br>tty<br><br><br><br><div class="zmail_extra"><div id="1"><br>---- On Mon, 16 May 2016 14:16:46 -0400 <b>marcel.taeumel <Marcel.Taeumel@hpi.de></b> wrote ---- <br></div><blockquote style="border-left: 1px solid #0000FF;padding-left: 6px; margin: 0 0 0 5px"><div>Hi Timothy, <br> <br>this help system consists of help topics, which form a hierarchy. Each such <br>topic has text content. Given this, there is no distinction between "topic" <br>and "page". There are just topics. <br> <br>As you have correctly found out, you can open any help topic via HelpBrowser <br>class >> #openOn:. This works with all arguments that understand <br>#asHelpTopic and are hence able to represent themselves in the right format. <br>You can browse implementors of #asHelpTopic for more details. <br> <br>While you can open any help topic (in any tree of topics) with the help <br>browser, you are right, it might be helpful to open some "root topic" and <br>select some sub topic in it. I guess that's the "page" you are referring to. <br>:-) <br> <br>Here is an example on how to do that: <br> <br>(HelpBrowser openOn: HelpOnHelp) model <br> showTopicThat: [:topic | topic title beginsWith: 'API']. <br> <br>This iterates the help structure until one topic returns "true". It's like <br>#detect:. It selects the result. <br> <br>However, there can be a problem with writing such code because display <br>strings tend to be translated and changed. Therfore, help topics can have a <br>#key property to encode an id to refer to in that block. If there is no key, <br>you have to check for another property. <br> <br>You might wonder, why this is so. Well, the creation of help topics is a <br>dynamic process. There is, for example, SWikiHelp, which fetches Web content <br>and parses sub-topics. So, we have to search for the topic to show, instead <br>of directly referring to it object-wise. If you get access to an instance of <br>HelpTopic, you can read it, but it might not be valid for a long time <br>because the Help Browser can update its caches. <br> <br>Best, <br>Marcel <br> <br> <br> <br>-- <br>View this message in context: <a href="http://forum.world.st/HelpBrowser-openOn-topic-page-tp4895008p4895185.html" target="_blank">http://forum.world.st/HelpBrowser-openOn-topic-page-tp4895008p4895185.html</a> <br>Sent from the Squeak - Dev mailing list archive at Nabble.com. <br> <br></div></blockquote><br></div><br></div></body></html>