#topicpath ---- Eclipseのヘルプはワークベンチのメニューの ヘルプ >> ヘルプ目次 にありますが、このhtmlベースのヘルプも拡張して好きなヘルプを載せることができます。そして拡張するための拡張ポイントがorg.eclipse.help.toc拡張ポイントです。 この拡張ポイントで目次となるファイル(xml形式)を指定し、そのxmlファイルで目次に対応するhtmlファイルを指定します。 ***拡張ポイント [#e65d7276] org.eclipse.help.toc ***必須プラグイン [#vd99645e] org.eclipse.help.appserver org.eclipse.help.base org.eclipse.help.ui org.eclipse.help.webapp org.eclipse.tomcat ***plugin.xmlのサンプル [#cb38fa2e] <extension point="org.eclipse.help.toc"> <toc primary="true" file="toc.xml"/> <-トップの目次となるxmlファイル。 <toc file="tocconcepts.xml"/> <toc file="tocgettingstarted.xml"/> <toc file="tocreference.xml"/> <toc file="tocsamples.xml"/> <toc file="toctasks.xml"/> </extension> ***目次となるxml(ここではtoc.xml)のサンプル [#z24cb416] <?xml version="1.0" encoding="UTF-8"?> <?NLS TYPE="org.eclipse.help.toc"?> <toc label="Sample Table of Contents" topic="html/toc.html"> ↑目次のSample Table of Contents をクリックしたときに 表示されるhtmlはhtml/toc.htmlです、の意味 <topic label="Getting Started"> <anchor id="gettingstarted"/> </topic> <topic label="Concepts"> <-目次にConceptsと表示 <anchor id="concepts"/> <-toc.xml#conceptsとなってる箇所をここに挿入 </topic> <topic label="Tasks"> <anchor id="tasks"/> </topic> <topic label="Reference"> <anchor id="reference"/> </topic> <topic label="Samples"> <anchor id="samples"/> </topic> </toc> *** <anchor id="concepts"/> でリンクされるtocconcepts.xml [#pc4d4842] <?xml version="1.0" encoding="UTF-8"?> <?NLS TYPE="org.eclipse.help.toc"?> <toc label="Concepts" link_to="toc.xml#concepts"> <-ここでリンクされてる <topic label="Main Topic" href="html/concepts/maintopic.html"> <topic label="Sub Topic" href="html/concepts/subtopic.html" /> </topic> <topic label="Main Topic 2"> <topic label="Sub Topic 2" href="html/concepts/subtopic2.html" /> </topic> </toc> #ref(capture.png) **ポイント [#pbeecb8c] ***htmlファイル群は圧縮できる。 [#h51e70ea] ***目次ファイル内で別の目次ファイルを指定できる [#vd9b9873] *** ヘルプメニューからではなく、アクションやボタンなどでヘルプを起動する [#eacd3e65] ヘルプメニューの「ヘルプ目次」は ActionFactory.HELP_CONTENTS.create(window) でアクションを取得できます。このクラスは実体は org.eclipse.ui.internal.actions.HelpContentsAction なのですが、このrunメソッドからヘルプの起動方法を拝借しました。なかでは以下のようなことをやってます。 final IWorkbenchWindow workbenchWindow = getSite().getWorkbenchWindow(); if (workbenchWindow == null) { // action has been disposed return; } // This may take a while, so use the busy indicator BusyIndicator.showWhile(null, new Runnable() { public void run() { workbenchWindow.getWorkbench().getHelpSystem() .displayHelp(); } }); これでヘルプが起動できます。 **関連リンク [#cbfbb9c1] -[[Eclipseのヘルプ・システムを使ってプロジェクトを文書化する:http://www-6.ibm.com/jp/developerworks/opensource/040326/j_os-echelp.html]] ---- この記事は #vote(おもしろかった[2],そうでもない[0]) -ヘルプ右初期画面の表紙ってどうやってかえるんでしょ? -- [[たかひろ]] &new{2005-06-30 12:34:18 (木)}; #comment #topicpath SIZE(10){現在のアクセス:&counter;}