Eclipse Help 系統集中化部署與外部化訪問指南

為何集中化 Help？

團隊開發需一致環境，插件帶來的 Help 碎片化難以管理。遵循 DRY 原則：單一權威副本，避免多份副本失去同步。

Eclipse Help 內部結構

• 基於插件架構，通過 org.eclipse.help.toc 整合
• TOC XML 定義層級目錄，指向 HTML 內容（通常打包為 doc.zip）
• PDE 向導可快速生成 Help 插件骨架

構建外部 Infocenter 服務器

1. 安裝 Eclipse Runtime Binary 到服務器
2. 啟動命令：

   java -classpath [ehome]/plugins/org.eclipse.help.base_3.0.1/helpbase.jar
     org.eclipse.help.standalone.Infocenter
     -eclipsehome [ehome] -port 8081 -command start

3. 瀏覽器訪問 https://localhost:8081/help/index.jsp

Apache 代理整合

LoadModule proxy_module modules/ApacheModuleProxy.dll
ProxyPass /eclipsehelprepo https://internalhelpserver:8081/help
ProxyPassReverse /eclipsehelprepo https://internalhelpserver:8081/help

Eclipse 客戶端接入

1. 創建菜單項插件（Sample Action 模板）
2. Action.run() 調用 Program.launch("https://localhost:8081/help")
3. 啟動外部瀏覽器訪問集中化 Help

總結

外部化 Infocenter + 客戶端菜單插件 = 團隊統一、可擴展、動態的 Help 系統。可整合公司編碼標準、專案文檔，支援遠程開發。