用JavaHelp系统开发和交付更好的文档

发表于:2007-07-14来源:作者:点击数: 标签:
在线帮助系统是任何软件系统整体不可或缺的一部分。帮助系统可提供直观的帮助信息,使用户可以轻松的浏览、查找和显示帮助信息,同时有助于用户学习系统的使用,如此一来,许多应用程序的学习周期就大大缩短。然而,从传统上讲,由于 Java 语言中没有集成帮
在线帮助系统是任何软件系统整体不可或缺的一部分。帮助系统可提供直观的帮助信息,使用户可以轻松的浏览、查找和显示帮助信息,同时有助于用户学习系统的使用,如此一来,许多应用程序的学习周期就大大缩短。然而,从传统上讲,由于 Java 语言中没有集成帮助系统,那么 Java 开发人员不得不从零开始创建自己定制的帮助系统。这样不仅成本高,而且费时。

  现在有了 JavaHelp 技术,Java 开发人员就不再需要为应用程序所运行的每个平台构建自己的帮助系统。JavaHelp 技术的目的是满足当今的工业强度的应用程序。 

  本文将详细介绍如何使用 JavaHelp 系统来为您的软件系统提供更好的帮助信息。内容包括:
  • 帮助信息实现方法概述。
  • JavaHelp 技术介绍。
  • JavaHelp 技术的功能特点和优势的讨论。
  • 开发帮助信息所应用的风格。
  • 可用于您自己应用程序中的示例代码。
  帮助系统的可选方案

  Java 开发人员可用以下几种方案来实现其应用程序的帮助系统:
  • 无帮助系统:让用户自行判断和领会系统是如何工作的。然而,一个软系统如果没有文档、帮助信息系统、或者手册,那么该软件系统就是不完全的。而且还会影响到使用它的用户。设想一下没有使用手册的 Adobe Photoshop 会是什么一种情况!
  • 使用 HTML:这是一个低成本的选项,但是其功能和导航受到限制。
  • 自定义系统:这是一个高成本的选项,耗费资源和时间。
  • 第三方私有方案:这是一个可替代自定义系统的可行的方案;然而,它也有自己的后果,包括:成本和长期支持。如果软件供应商破产,你能做些什么呢?
  这就是为什么要设计 JavaHelp 技术的原因。

  JavaHelp 技术

  JavaHelp 是一个可扩展的、平台独立的帮助系统,可使作者和开发人员将在线帮助融合到applet、应用程序、操作系统和设备之中。它也可用来 Web 上和公司内部 Intranet 上传递在线文档。它的设计理念之一就是以网络为中心,帮助数据和搜索功能既可以在客户端,也可以在服务器端,同时帮助数据可以通过 Web 进行更新。

  JavaHelp 系统是用 Java 语言所写,因此可以运行在任何支持 Java Runtime Environment (JRE)的平台或者浏览器上。这说明,它可用于异构环境中,如 Web 或 公司内部 Intranet。此外,它还可以用来为任何软件应用程序开发和提供在线帮助,而不只是针对那些用 Java 语言开发而成的应用程序。而且,它也可以自我应用,而不需与任何软件相关联--正如以 Web 为中心的分类文档(如人力资源、技术支持、等)的传输机制。

  JavaHelp 1.0 在 1999 年首次发布,经历了数年的发展和完善,该技术现在已经成熟。 JavaHelp 2.0 技术由 Java Community Process (JCP) 设计成 JSR-97。这说明和 WinHelp 不同,JavaHelp 具有 HTML 内容的跨平台优势,因为它并不将公司局限于单一的平台。请务必注意:JavaHelp 系统可以用来为部署在任何平台上的任何软件应用程序(而不仅仅是基于 Java 语言的应用程序)传递和提供在线帮助。

  JavaHelp 系统得到了来自行业和 主要帮助写作工具供应商 的广泛支持。

  JavaHelp 的功能和优势   JavaHelp 提供了几个对文档写作十分有用的功能。此外,它所提供的几个可重用的组件可为 Java 开发人员节省大量的时间。JavaHelp 的一些功能如下:
  • 帮助导航器:内容目录 (TOC) 支持以可折叠和可扩展的方式显示主题、无限分级、多目录合并;一个索引支持多索引合并;和具有灵活和可配置特性的全文检索。
  • 压缩:基于 JavaHelp 的帮助系统可以压缩并封装到一个单一的 Java Archive (JAR)文件中。

    原文转自:http://www.ltesting.net