安裝獨立式說明系統為 InfoCenter
您可以利用安裝獨立式說明系統和文件外掛程式至 Web 伺服器上,
讓使用者透過 Internet 或 Intranet 來存取說明系統。應用程式利用呼叫 URL 存取文件,而說明系統顯示在他們的 Web 瀏覽器。
InfoCenter 說明系統可供從屬站應用程式和 Web 應用程式使用,任一方式
均可自遠端存取說明。
除了蹦現資訊和作用中的說明之外支援所有特性。
安裝/包裝
這些步驟為說明系統整合器和 Web 管理的步驟而不是要解釋所有可能的情況。
假設所有的文件傳遞為 Eclipse 外掛程式,一般來說,您熟悉 Eclipse 說明系統。
對一般使用者來說,假設他們的機器已安裝了 IE5.x 或 6.x 或 Mozilla。
- 請確定已安裝了應用程式伺服器。我們已測試了 Tomcat 3 和 Tomcat 4。
- 從 www.eclipse.org 下載 Eclipse 2.0 版次平台執行時期驅動程式。
- 安裝(解壓縮)驅動程式至目錄 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,新增此區段為主機區段中的最後一個元素。
- 依據您所使用的伺服器安裝下列修正套件:
- Tomcat 3: Tomcat 3 沒有 Web 應用程式可用的 XML 剖析器程式庫。
要解決這個問題,從 d:\eclipse\plugins\org.apache.xerces_4.0.3\ 複製 xercesImpl.jar 和 xmlParserAPIs.jar 至 d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\WEB-INF\lib\ 中。
- Tomcat 4:
- Eclipse 和 Tomcat 都包含設定 URLStreamHandler 的程式碼,但是只能設定一次。要讓 Tomcat 和 Eclipse 正確地作用,程式庫 d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\eclipseurl.jar 需要被新增至 Tomcat 啟動的類別路徑中。在 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 : 除非您所使用的是 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。
使用 InfoCenter
啟動 Web 伺服器。將 Web 瀏覽器指到 Web 應用程式所在的路徑。在已安裝 Tomcat 的機器上,這應該是 http://localhost:8080/help/。
安裝自訂文件
Eclipse 文件和它本身的文件一起,包含在 org.eclipse.platform.doc.user 外掛程式中。依預設,在 InfoCenter 中它為可用的。要顯示您的文件,包裝文件作為 Eclipse 文件外掛程式。將它們安裝至 d:\eclipse\plugins\ 中。