将帮助系统作为信息中心安装
可以通过在 web 服务器上安装独立的帮助系统和文档插件来允许用户通过因特网或内部网访问帮助系统。应用程序通过调用
URL 访问文档,而帮助系统会显示在它们的 web 浏览器中。信息中心帮助系统可用于客户机应用程序或
web 应用程序,对于每种应用程序,都可以远程方式访问帮助。除弹出信息和活动帮助之外的所有功能部件都受支持。
安装/封装
这些步骤用于帮助系统集成器和 web 管理,但不代表能解决所有可能的情况。假定所有文档都是作为
Eclipse 插件交付的,并且通常您很熟悉 eclipse 帮助系统。对于最终用户,假定他们在机器上安装了 IE5.x 或 6.x 或者 Mozilla。
- 确保应用程序服务器已安装在机器上。已对 Tomcat 3 和 Tomcat 4 作了测试。
- 从以下网址下载“Eclipse 2.0 发行等级平台运行时二进制文件”驱动程序:www.eclipse.org。
- 将该驱动程序安装(解压缩)至目录 d:\eclipse。
- 向 Web 服务器注册驻留在 d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0 中的 Eclipse 帮助应用程序。不要将此目录复制到别处;
它必须保留在 Eclipse 安装树中。
在 Tomcat 中,此注册可通过将下列几行添加至 tomcat\conf\server.xml 文件完成:
<Context path="/help" docBase="d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0">
</Context>
在 Tomcat 3 中,将这些行添加至文件中靠近结尾的地方,作为
ContextManager 部分中的最后一个元素。在 Tomcat 4 中,将此部分作为 Host 部分的最后一个元素添加。
- 根据正在使用的服务器,安装下列修订:
- Tomcat 3:Tomcat 3 不具有可供 web 应用程序使用的 XML 解析器库。要修正这一点,可将 xercesImpl.jar 和 xmlParserAPIs.jar 从
d:\eclipse\plugins\org.apache.xerces_4.0.3\ 复制至
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\WEB-INF\lib\
- Tomcat 4:
- Eclipse 和 Tomcat 都包含用来设置
URLStreamHandler 的代码,但它只能设置一次。要允许 Tomcat 和
Eclipse 正常工作,需要在 Tomcat 启动时将库
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\eclipseurl.jar
添加至类路径。在 Tomcat 4.0.3 中,编辑
tomcat/bin/setclasspath.bat 文件,并在以下一行:
set CLASSPATH=%JAVA_HOME%\lib\tools.jar
后插入以下一行:
set CLASSPATH=%CLASSPATH%;d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\eclipseurl.jar.
-
由于对 xml 库所作的更改,除去 tomcat\common\lib\xerces.jar,然后编辑 setclasspath.bat,方法是将以下一行
set JAVA_OPTS=
替换为
set JAVA_OPTS=-Xbootclasspath/a:d:\eclipse\plugins\org.apache.xerces_4.0.3\xercesImpl.jar;d:\eclipse\plugins\org.apaches.xerces_4.0.3\xmlParserAPIs.jar.
- 禁用预编译的 JSP's:。除非您正在使用
Tomcat 4.0.x 或打算交付 jasper jar 文件,否则您还应将
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\web.xml 复制至
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\WEB-INF。
使用信息中心
启动 Web 服务器。使 web 浏览器指向 web
应用程序的路径。在安装了 Tomcat 的机器上,这应是
http://localhost:8080/help/。
安装定制文档
Eclipse 平台带有它自己的文档,包含在 org.eclipse.platform.doc.user 插件中。缺省情况下,可在信息中心中获取。要显示自己的文档,将该文档作为
Eclipse 文档插件封装。将它们安装至 d:\eclipse\plugins\。