Java 版 (精华区)

发信人: allen (夏夜晚风·原来的我), 信区: Java
标  题: [蔡学镛][Learning Java the O'Reilly's Way]22
发信站: 哈工大紫丁香 (2002年08月21日00:50:32 星期三), 站内信件

发信人: NullPointer (宁与骐骥亢轭，不随驽马之迹)
发信站: BBS 水木清华站 (Sun Jun 30 19:29:19 2002)

Learning Java the O'Reilly's Way (Part XXII)
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，而且都是
用一章的篇幅就带过。但「CreatingEffective 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吧！


--
   明天不一定会更好
       但更好的明天一定会到来...

※ 来源:·哈工大紫丁香 bbs.hit.edu.cn·[FROM: 218.7.25.106]