- 追加された行はこの色です。
- 削除された行はこの色です。
#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;}