为RCP添加帮助系统

from ：http://blog.csdn.net/moneyice/archive/2006/05/10/715795.aspx
一款软件，如果希望用户能够快速的上手，完善的帮助系统必不可少。帮助中要包含操作指南，相关的疑难解答，软件的配置，维护等信息。优秀的文档可以节省用户的时间精力，也为维护人员省去了不少麻烦。
Eclipse的帮助系统可以说是十分优秀，功能全面，界面美观，操作便利，而且和Eclipse IDE结合的十分紧密，用户在任何时候都可以通过F1来体会这一点。
在RCP中，也可以利用Eclipse Help构建自己的帮助系统。Eclipse 帮助系统包括静态，动态和上下文敏感的帮助，这些都可以应用到RCP中。
在RCP中，加入帮助，也是通过plugin,如果要帮助要依赖于指定的plugin，也可以做成fragment的形式，这里是以plugin的形式。
要实现完整的帮助功能，需要依赖于以下插件：
1.    org.apache.lucene
2.    org.eclipse.help.appserver
3.    org.eclipse.help.base
4.    org.eclipse.help.ui
5.    org.eclipse.help.webapp
6.    org.eclipse.tomcat
7.    org.eclipse.ui.forms
1        在RCP的帮助菜单中加入Help Contents
在RCP的ActionBarAdvisor.makeActions()方法中实例化Help Constents Action，并注册到工作台中。
com.mi.pwdgate.ApplicationActionBarAdvisor.makeActions()
helpContentsAction = ActionFactory.HELP_CONTENTS.create(window);
register(helpContentsAction);

在Help Menu的About Action前面加入此helpContentsAction,在fillMenuBar()中实现。
com.mi.pwdgate.ApplicationActionBarAdvisor.fillMenuBar()

    MenuManager helpMenu = new MenuManager("&Help","help");

    helpMenu.add(helpAction);

    helpMenu.add(aboutAction);


现在运行RCP时，可以看到Help > Help Contents菜单项。运行RCP时，要选中上面列出的plugin。


2        加入帮助内容
帮助文件就是一组html格式的文件，要加入到帮助系统中必须要有一个定义帮助文件结构的配置文件，是xml格式。帮助文件的内容需要资料人员制作成标准的html文件即可。为了美观性，也可以加入css。
1）  在plugin.xml文件中加入扩展点

        plugin.xml

        <extension point="org.eclipse.help.toc">
              <toc file="toc.xml" primary="true"/>

               <toc file="tocgettingstarted.xml"/>

</extension>
    此扩展点告诉帮助系统所有的toc文件，toc文件中定义的帮助的显示结构，它们显示在帮助对话框的左边。这个扩展点标示了2个toc 文件，它们都是位于帮助的顶级。其中toc.xml标示为primary,保证其在帮助对话框中永远显示。

插件根目录下的toc.xml文件，
    toc.xml

    <toc label="Pass Gate User Guide" topic="html/toc.html">

        <topic label="Getting started" href="doc/gettingstarted.html"/>
        <topic label="Copy" href="doc/copy.html"/>
        <topic label="Preferences" href="doc/preferences.html">
            <topic label="Policy" href="doc/preferences_policy.html"/>
<topic label="User Interaction" href="doc/preferences_ui.html"/>
        </topic>
        <topic label="Import" href="doc/imexport_import.html"/>
        <topic label="Export" href="doc/imexport_export.html"/>
        <topic label="Credits" href="doc/credits.html"/>
</toc>
              帮助文件结构

执行RCP后，可以在帮助对话框中看到刚才加入的帮助内容

3        加入上下文敏感帮助
如果希望能够和用户进行良好的交互，上下文敏感的帮助就必不可少。当用户执行特定的操作，或者在操作某个程序界面，只要点击帮助件，就可以得到与此相关的帮助内容。在Windows是F1,在GTK是Ctrl+F1。在 Eclipse3.1以前，是以Infopops的形式出现，就是弹出一个黄色的框框，从Eclipse3.1，默认的形式是Help View。

下面在PassGateView中加入上下文敏感帮助
com.mi.pwdgate.view. PassGateView. createPartControl()
PlatformUI.getWorkbench().getHelpSystem().setHelp(viewer.getControl(),
                      " pwdgatehelp.PassGateView");
其中" pwdgatehelp.PassGateView"是上下文的id,系统使用这个id在上下文表中寻找要显示的内容。上下文表由org.eclipse.help.contexts扩展点定义。在plugin文件中加入如下内容。

plugin.xml

<extension point="org.eclipse.help.contexts">

       <contexts file="contexts.xml"/>

</extension>

contexts.xml文件中定义了上下文id和显示内容的映射。



contexts.xml

<contexts>

<context id="PassGateView">

    <description>This is Password Gate View</description>

    <topic

      label="Password Gate"/>

      href="doc/gettingstarted.html"

    <topic

      label="Preference"/>

      href="doc/preferences.html"

</context>

</contexts>

PlatformUI.getWorkbench().getHelpSystem().setHelp(viewer.getControl(),
                            "pwdgatehelp.PassGateView");中，上下文id, PassGateView对应contexts.xml中的context id, pwdgatehelp对应帮助插件的plugin id。

运行RCP,在Password Gate View 按F1,自动打开Help View。

用PDE的导出Wizard到处该帮助plugin，就生成了一个独立的帮助plugin，可以直接放在自己的RCP产品的plugins目录下

评论

2 楼 yhyysxqygs 2012-05-15  

大哥，晓得我是谁不啊

1 楼 yhyysxqygs 2012-05-15  

大哥，你这个都不晓得是哪个版本的了，在3.5版本的eclipse中tomcat要换成org.eclipse.equinox.http.jetty了