自從開始學java之后，有一件事一直讓我很糾結，這就是查看幫助文檔不是很方便。java的幫助文檔大多是javadoc制作的，通常提供的是一 個壓縮包，里面是一堆網頁文件，這種查看方式中搜索功能比較弱，所以很不方便。因此不得不去找一些第三方制作的chm格式的文檔，然而，這種文檔在 linux系統下查看卻又有些不友好。因此，找到一個在windows和Linux都好用的幫助文檔成了我最大的愿望。

昨天，照例流量開源社區時，發現了一款名為GroovyHelp的軟件，其實在以前逛網站時也多次見到它，但是一直沒有在意，昨天點進去看了下詳細介紹，沒想到這一看讓我找到了好寶貝。正所謂好東西不能藏著掖著，得拿出來分享一下，因此，小撰此文推介一下。

GroovyHelp是一款幫助軟件，它能夠幫助Java開發人員方便快速地查找Javadoc文檔并對其進行高效管理，從此無需苦尋chm格式的幫助文檔了。

GroovyHelp能夠幫助Java開發者快速查閱Javadoc幫助文檔，主要特性如下所示（山風小子注：目前最新特性列表請詳見GroovyHelp 3.1.0發布信息）：
* 根據輸入關鍵字，查找類，接口，方法等幫助信息（支持模糊查詢）
* 支持全文檢索，并高亮搜索結果（支持模糊查詢）
* 以樹型結構完整展現文檔的整體結構及文件結構
* 支持源碼關聯，即查看文檔所對應的源碼，并語法高亮顯示源碼
* 支持JDK1.4+（包括JDK1.4）自帶的Javadoc生成的幫助文檔
* 無需解壓文檔及源碼ZIP壓縮包，節省磁盤空間
* 用戶可以自由選擇所需的jre1.6.0+（自己安裝的jre，或者GroovyHelp提供的jre）

由于它自身也是由java編寫，因此有著java的跨平臺特性，我們可以在各個操作系統中使用它。不過在使用過程中有一個需要注意的地方，由于它是 在32位環境下編寫的，使用的swt類也是32位的，因此，和我一樣的64位用戶需要自己去下載swt的64位版，替換應用目錄下 lib\endorsed的SWT類。由于只能在eclipse官網上下載，而該文件藏得比較深，這里我提供一個網盤下載：（山風小子注：從GroovyHelp 3.2.0 RC-2開始，GroovyHelp自帶了Windows和Linux下32位及64位swt的jar包，并自動選擇正確的版本，故無需自行下載swt）
    swt-3.7-gtk-linux-x86_64.jar:盛大網盤、115網盤
    swt-3.7-win32-win32-x86_64.jar:盛大網盤、115網盤 （山風小子注：此處“盛大網盤”的地址有點問題，可至swt 3.7 下載頁面下載）

這個應用的使用也是非常簡單，解壓后在系統環境變量中添加GROOVYHELP_JAVA_HOME，值為jdk所在路徑。

啟動后點擊菜單欄docs中manage docs，選擇你需要添加的文檔即可，它會自動讀取文件名，如果你還需要加上源碼查看的話，可以同時添加源碼壓縮包。建議把文檔和源碼都置于同一個目錄下，方便管理。對了，路徑中不能出現中文，否則會有問題。

等創建好索引之后就可以在應用中方便的查看、管理文檔及源碼了，相信它可以給開發者提供最大的幫助吧？

       由于剛剛開始使用它，還有一些不熟悉，不過在這點時間里，發現了一些比較郁悶的現象。并非所有第三方類庫的開發商會提供幫助文件的下 載，通常只提供在線版，這樣一來，在斷網情況下仍舊無法查看。希望有朝一日有那么一個應用，可以直接將那些幫助文檔下載下來，并以一定的格式顯示。而像 groovyhelp的文檔、源碼互相對應方便查看的功能，更可以做成一個上下兩個框架同步顯示的形式，讓用戶在查看幫助的同時通過源碼進行進一步了解其 操作形式。

       附帶說下，雖然應用界面是純英文的，但是它可是我們國人的杰作哦。

項目地址：http://code.google.com/p/groovyhelp/