首頁
中文書目錄
原文書目錄
 站內快速搜尋
資源中心
Book Series
Special Interest













■好消息,歐萊禮書籍已重新鋪貨至各大書局及網路書店,歡迎讀者選購       ■歡迎各院校採用歐萊禮書籍,學校團購請洽校園服務團隊

Learning Java the O'Reilly's Way

Creating Effective JavaHelp


如果你設計過 WinHelp 格式的 online help,而且沒有 help 寫作工具的幫忙,那麼你可能知道,其實製作 WinHelp 需要懂一大堆知識,包括 RTF 的格式、編譯檔案的方式 ... 等,所以 WinHelp 的書厚度總是不小,但是 Java 平台的 online help 就完全不同了。O'Reilly 最近出版的「Creating Effective JavaHelp」一書是講解 Java 平台的 online help 製作,此書是 O'Reilly 的 Java 系列中最薄的一本書,只有 171 頁,原因無它,只因為 JavaHelp 原本就是一個迷你的主題。JavaHelp 使用 HTML 當作說明檔格式,使用 XML 當作附屬檔格式,使用一套 class(位於 javax.help 和 javax.help.event 此二 package)當作 Java 程式和說明文件之間的銜接橋樑。

雖然「Creating Effective JavaHelp」是目前唯一一本 JavaHelp 的專書,其實市面上幾本 Swing 的書有討論到 JavaHelp,而且都是用一章的篇幅就帶過。但「Creating Effective JavaHelp」的定位不太一樣,因為它除了教導 JavaHelp API 的用法之外,也教你建立「effective(有用的、實際的)」的線上說明系統,如書名所示。此書除了解說 JavaHelp 的使用方法之外,作者用了許多篇幅來講解如何規劃一套實用的 online help。這是比較難能可貴的部分。

如果你是 online help 設計的老手,你可以不用看此書,直接看 JavaSoft 的 JavaHelp 文件即可;如果你是 online help 的新手,那麼這本書應該可以帶你輕鬆入門。以我自己來說,因為我本來就懂 HTML 和 XML,又有製作 WinHelp 的經驗,加上這本 JavaHelp 的書又很薄,所以我花了兩天就差不多看完了。

雖然許多程式員都很「不屑」設計 online help,認為 online help 只是多餘的東西。但是我認為 online help 很重要,特別是近年來許多軟體的手冊都電子化,使用者也習慣在操作軟體時,一但遇到疑問,就去查 online help,如此一來可以快速地透過主題分類、搜尋、索引、交互查詢等 功能,不但找資料的速度比翻手冊快,還更環保呢!但是,我發現許多軟體的 online help 做得不好,常會有 broken link,或者讓我找了許久還找不到我要的說明,顯然它們 的 online help 沒有規劃好。每次遇到這種情況,我都會 show 出我那不肯輕易示人的中指(其它指頭成握拳狀)。

最近,我正打算為我所寫的軟體加上 JavaHelp。如果你正使用 Java 開發軟體,請別忘了把 JavaHelp 整合進去,而且多花一些時間規劃出一個「effective」的 online help 吧!


本文作者:蔡學鏞
張貼日期:9/11/00

| 首頁 | 聯絡我們 |
© 2009, O'Reilly Media, Inc. Taiwan Branch