sapphire01 发表于 2007-11-13 14:43:05

编译Html联机帮助

编译Html联机帮助
Html 联机帮助文件是基于 html 文件的帮助文件,已经广泛应用在 Windows 2000 Professional 等操作系统和应用程序上。
1) 特点 编译完成的 Html 联机帮助文件是扩展名为 chm 的二进制文件,由一系列 html 格式的源文件和 jpg/gif 格式的图像文件,使用编译工具编译创建。具有界面简洁、使用方便、文件占用空间小等优点。使用集成在操作系统的 Html 联机帮助查看器程序 (hh.exe) 打开。
2) 组成 一个典型的 Html 联机帮助文件,打开后如图 1 所示。 http://www.giltworld.com/Images/Online_Help.gif
图 1 联机帮助文档组成图 [*]导航栏位于标题栏下放的一组按钮,方便定位特定的帮助内容窗口。 [*]目录、索引及搜索标签联机帮助文件左边的窗口包括目录、索引和搜索标签。可以多种方式在“帮助”系统中定位寻找适合的“帮助”主题。 [*]“帮助”主题联机帮助文件右边的窗口是当前选定帮助主题的内容。 3) 编译环境 常用的 Html 联机帮助文件编译工具是 Microsoft HTML Help Workshop ,它采用项目文件 (Project File) 的方式管理组织编译环境,如图 2 所示。
一个 Html 帮助项目使用一个项目文件和 Microsoft HTML Help Workshop 编译创建。项目文件的扩展名是 hhp ,包含了全部帮助编译的设置信息,借助编译器,将一个或多个 html 和图像文件编译成一个 chm 文件。
http://www.giltworld.com/Images/compil2.jpg
图 2 html 联机帮助编译环境图 4) 文件类型 Microsoft HTML Help Workshop 编译器中包含多种类型的文件,其中某些文件需要正确的本地化,各种文件类型代表的含义如下表所示:
文件扩展名 代表含义 是否本地化 .gif 和 .jpg
将要编译的图像文件
是 .hhc
帮助目录文件
是 .chm
编译的联机帮助文件
否 .hhp
编译项目文件
是 .htm 和 .html
将要编译的源文件
是 .hhk
编译索引文件
是 .log
编译过程的日志文件
否 .png
图像文件
是 .wav
声音文件
是 .hh
上下文敏感的帮助头文件
否 .css
层叠样式表
是 .ali
别名文件
否 表 1 HTML Help Workshop 编译环境中的文件类型表 5) 编译流程 HTML 联机帮助文件的编译包括设置编译环境、执行编译命令、检查编译结果。其中设置编译环境主要包括准备帮助的源文件( html 文件和图像文件)、目录文件( .hhc )、索引文件( .hhk )等。编译流程图如图 3 所示。 http://www.giltworld.com/Images/compil3.gif
http://www.giltworld.com/Images/compil3.gif
图 3 html 帮助文件编译流程图 6) 编译步骤 使用 Microsoft HTML Help Workshop 编译 联机帮助文件的步骤如下。 在包含编译项目文件的目录中,创建编译语言的新目录,例如, Help_Chs 。 复制所有源语言文件到新目录。 使用全部本地化的文件(包括 html 文件、图像文件等)替换新目录的源语言文件。 运行 Microsoft HTML Help Workshop 程序,打开编译项目文件( .hhp )。左边的窗口显示了项目的设置。 单击“ Change Project Options ”按钮或双击 行,显示“ Options ”对话框。 在“ Options ”对话框中,确认“ Title ”的内容已经正确翻译,确认“ Language ”下拉列表选择了正确的本地化语言。 保存全部项目文件。 [*]从“ File ”菜单中,选择“ Compile… ”命令,运行编译。7) 检查 为了保证编译的正确性,在完成编译后需要对帮助文件,执行基本的检查,主要包括以下方面。 查看编译的日志文件 (.log) ,确认结果正确。如果不能正确编译,根据日志文件的错误类型,重新设置编译环境,再次编译,直到编译成功。 源语言帮助文件和本地化的帮助文件对比检查。使用 SDL HelpQA 或定制的检查工具,比较源语言帮助文件和本地化的帮助文件的布局和功能。 [*]在本地语言的操作系统上打开编译的帮助文件,检查其布局和功能的正确性。8) 编译技巧 为了保证编译的正确性,需要注意下面列出了内容。 确保全部翻译了需要本地化的文件。 确保全部使用了正确的本地化的文件。 确保语言等项设置正确,标题等内容正确地进行了本地化。 确保磁盘上足够的剩余空间。 分析编译日志文件的内容,正确排除编译错误。 [*]执行编译后的基本检查,与源语言帮助文件对比,在本地化操作系统上打开帮助,执行语言、布局和功能的基本检查。

作者:崔启亮
原始出处:本地化世界网www.giltworld.com
页: [1]
查看完整版本: 编译Html联机帮助