制作帮助文件速成
帮助文件速成(上)
---- 带 有 帮 助 文 件 的 应 用 程 序 无 论 对程 序 员 还 是 用 户 都 是 不 同 凡 响 的， 它 能 节 省 印 刷 大 量 用户 手 册 的 开 支， 对 程 序 员 编 辑 修 改 和 用 户 手 册 的 复 制 保存 都 极 为 方 便。 帮 助 文 件 的 另 一 个 很 有 前 景 的 应 用 是 单独 作 为 带 有 图 文 信 息 的 电 子 图 书 发 布。
---- 在 此 对 帮 助 文 件 的 编 制 及 如 何 在程 序 中 编 程 调 用 作 一 详 尽 介 绍。 首 先 介 绍 第 一 部 分， 帮 助文 件 的 编 写。
---- 帮 助 文 件 的 编 写 步 骤：
先 编 写 存 有 所 有 帮 助 信 息 的 帮 助 源 文件RTF 文 件。
编 写 帮 助 项 目 文 件HPJ 文 件。
对HPJ 文 件 编 译， 最 后 生 成HLP 文 件。
帮 助 源 文 件RTF 文 件 的 编 写
---- 帮 助 源 文 件 是 存 有 所 有 帮 助 信 息的， 这 是 一 种RTF（Rich Text Format) 文 件, 帮 助 文 件 象 一 本 书，由 目 录 及 一 个 个 章 节 组 成， 各 章 节 之 间 的 跳 转 是 由 定 义的 热 点 来 完 成。 现 在 举 一 具 体 例 子（ 由 目 录 等 五 条 信 息 组成） 详 细 说 明。
---- 原 始 信 息 由 五 个 章 节 组 成： 目 录、概 述、 说 明、 程 序、 安 装。象 前 面 每 一 节 的 标 题（“ 目 录”，“ 概 述”， “ 说 明”，“ 程 序”， “ 安 装”） 在RTF 文 件 中 必 须 以特 有 的 脚 注（ 即$) 明 确 指 定。 对 每 一 节 还 须 指 定 其 跳 转 名( 脚 注 是# ， 跳 转 名 不 能 是 汉 字）， 以 便 标 识， 在 这 我 们 给 每一 节 分 别 取 名 为：contents , description, explanation ,programming, setup, 对 每 一 节 还 可 指 定 其 搜 索 关 键 字（ 脚 注 是K）， 关 键字 可 以 是 一 个 或 多 个， 汉 字 和 英 文 均 可。
---- 具 体 操 作 如 下： 进 入Microsoft Word 中文 版, 选 择： 文 件/ 新 建， 先 输 入 第 一 节 的 内 容： 输 入 第 一节 的 标 题：“ 目 录”， 将 光 标 移 到“ 目 录” 的 前 面， 选 择 系统 菜 单 的“ 插 入”， 选 “ 脚 注 和 尾 注”， 选“ 脚 注” 和“ 自 定义 标 记”， 输 入：$ 符 号， 这 时 文 档 下 方 出 现 脚 注 编 辑 窗 口，光 标 也 自 动 落 在 文 档 下 方 的 脚 注 编 辑 窗 口 中， 在 光 标 处接 着 输 入 这 一 节 的 标 题：“ 目 录”， 有 时 看 不 到 文 档 下 方的 脚 注 窗 口， 这 只 要 将 系 统 菜 单 中“ 视 图” 的“ 脚 注” 选 上。
---- 下 面 定 义 这 一 节 的 跳 转 名, 将 光 标移 到“ 目 录” 的 前 面， 选 择 系 统 菜 单 的“ 插 入”， 选 “ 脚 注和 尾 注”， 选“ 脚 注” 和“ 自 定 义 标 记”， 输 入：# 符 号， 这 时文 档 下 方 出 现 脚 注 编 辑 窗 口， 光 标 也 自 动 落 在 文 档 下 方的 脚 注 编 辑 窗 口 中， 在 光 标 处 接 着 输 入 这 一 节 的 跳 转 名：“contents”( 有 时 看 不 到 文 档 下 方 的 脚 注 窗 口， 这 只 要 将 系 统 菜 单 中“ 视 图” 的“ 脚 注” 选 上) 定 义 这 一 节 的 搜 索 关 健 字。 将 光 标移 到“ 目 录” 的 前 面， 选 择 系 统 菜 单 的“ 插 入”， 选 “ 脚 注和 尾 注”， 选“ 脚 注” 和“ 自 定 义 标 记”， 输 入：k 符 号， 这 时文 档 下 方 出 现 脚 注 编 辑 窗 口， 光 标 也 自 动 落 在 文 档 下 方的 脚 注 编 辑 窗 口 中， 在 光 标 处 接 着 输 入 这 一 节 的 搜 索 关健 字， 搜 索 关 健 字 可 以 是 中 文 或 英 文， 一 个 或 多 个， 中 间用 分 号（ 即 ；） 隔 开， 这 儿 我 们 输 入： 目 录； 目 次；contents。
---- 最 后 定 义 这 一 节 的 顺 序 号。 顺 序号 相 当 于 一 本 书 中 各 章 节 的 页 码。 将 光 标 移 到“ 目 录” 的前 面， 选 择 系 统 菜 单 的“ 插 入”， 选 “ 脚 注 和 尾 注”， 选“ 脚 注” 和“ 自 定 义 标 记”， 输 入：+ 符 号， 这 时 文 档 下 方 出 现脚 注 编 辑 窗 口， 光 标 也 自 动 落 在 文 档 下 方 的 脚 注 编 辑 窗口 中， 在 光 标 处 接 着 输 入 这 一 节 顺 序 号， 如：0001，0002，0003 等。 这 儿 我 们 输 入：0001.
---- 这 样， 第 一 节 的 脚 注 标 记 全 部 作完。
---- 第 二 节 的 脚 注 标 记 作 法 一 样。（ 第一 节 和 第 二 节 要 有 分 页 符， 选 择 系 统 菜 单 的“ 插 入”， 选 “ 分 隔 符”，“ 分 页 符”）。
---- 在 帮 助 文 件 中， 当 用 户 在 按 了 绿色 的 跳 转 文 本， 就 应 该 跳 转 到 对 应 的 章 节， 如 何 定 义 一 个热 点 跳 转 呢 ？ 因 为 我 们 已 经 定 义 了 第 一 节 的 跳 转 名， 只要 将 跳 转 文 本 与 要 跳 转 到 的 那 一 节 的 跳 转 名 联 系 起 来，跳 转 文 本 在RTF 文 件 中 是 带 双 下 划 线 的 文 本， 以 上 例 操 作如 下：
---- 选 择 系 统 菜 单 上 的“ 格 式”/“ 字 体”，选 择“ 字 体”/“ 下 划 线”， 选“ 双 线”， 然 后 开 始 输 入 热 点文 本， 这 儿 我 们 输 入“ 概 述”， 输 入 完 热 点 文 本， 清 除 双 下划 线 格 式， 操 作： 选 择 系 统 菜 单 上 的“ 格 式”/“ 字 体”， 选择“ 字 体”/“ 下 划 线”， 选“ 无”， 清 除 双 下 划 线 格 式 后， 紧接 着 选 择 隐 藏 文 本 格 式， 输 入 跳 转 目 的 地 的 跳 转 名， 操 作：选 择 系 统 菜 单 上 的“ 格 式”/“ 字 体”， 选 择“ 字 体”/“ 效 果”，选“ 隐 藏”， 输 入 跳 转 目 的 地 的 跳 转 名， 这 儿 输 入“description”，输 入 完 清 除 隐 藏 文 本 格 式。 清 除 隐 藏 文 本 格 式 的 操 作： 选择 系 统 菜 单 上 的“ 格 式”/“ 字 体”， 选 择“ 字 体”/“ 效 果”，将“ 隐 藏” 复 选 框 除 去。
---- 如 何 定 义 热 点 弹 出 说 明。 它 与 以上 热 点 跳 转 文 本 一 样， 只 不 过 它 是 带 单 下 划 线 的 文 本。 操作 如 下： 选 择 字 符 的 单 下 划 线 格 式， 输 入 弹 出 式 热 点 文 本，如 上 例 输 入 的 是“ 单 下 划 线 的 指 定 说 明 热 点”， 操 作 如 下：选 择 系 统 菜 单 上 的“ 格 式”/“ 字 体”， 选 择“ 字 体”/“ 下 划线”， 选“ 单 线”， 然 后 开 始 输 入 热 点 文 本， 这 儿 我 们 输 入“ 单 下 划 线 的 指 定 说 明 热 点”， 输 入 完 热 点 文 本， 清 除 单 下划 线 格 式， 紧 接 着 选 择 隐 藏 文 本 格 式， 输 入 跳 转 目 的 地 的跳 转 名， 这 儿 是 弹 出 窗 口 的 跳 转 名： 这 儿 输 入“my_pop_up”，输 入 完 清 除 隐 藏 文 本 格 式。 弹 出 窗 口 一 节 要 与 其 它 章 节用 分 页 符 分 开。 只 要 指 定 跳 转 名 即 可。
---- 我 们 经 常 看 到 的“ 参 阅”、“see also” 弹 出 窗 口 就 是 这 样 作 出 来 的。
---- 如 何 对 图 形 指 定 热 点 跳 转。 在RTF 文 件 中 使 用 图 形， 可 以 用 语 句：{bmc 图 形 文 件 名}，bmc 表 示图 形 放 在 中 间，bml 表 示 图 形 放 在 左 边，bmr 表 示 图 形 放 在 右边， 图 形 文 件 可 以 是 一 般 的BMP 位 图 和SHG 热 点 跳 转 图 形 文件。
---- 如 用 户 在 图 形 某 处 按 动 时， 会 弹出 一 个 说 明 窗 口。 而 热 点 图 形.shg 文 件 由.bmp 位 图 文 件 通 过工 具 软 件Hotspot Editor 编 辑 而 来。Hotspot Editor 是 随Visual Basic （ 在VB 的HC 目 录 下） 和Visual Foxpro（ 在VFP 的HELPCOMP 目 录 下） 发布 的。 执 行 文 件 名 是SHED.EXE。 操 作： 运 行SHED.EXE， 选File/Open，装 入 要 用 到 的 位 图 文 件。 这 儿 用 一 人 头 形 位 图man.bmp, 在 图形 上 拖 动， 产 生 一 个 个 热 点， 双 击 任 一 热 点 区 域， 出 现 一对 话 框， 只 要 在Context String 处 输 入 要 跳 转 或 弹 出 目 的 地 的跳 转 名。 热 点 类 型Type 处 选 取 Jump 跳 转 式 或 Popup 弹 出 式。 热点 区 域 边 框 属 性Attribute 选 取 可 见Visible 或 不 可 见Invisible。在 这 个 例 子 中Context String 输 入eye_popup,Type 选 取 Popup,Attribute 选 取Invisible ( 隐 去 热 点 区 域 的 边 线).
---- 以d:\winword\man.shg 文 件 名 存 盘， 退出SHED.EXE。
---- 如 何 产 生 固 定 的 不 滚 动 标 题 区 域，不 滚 动 区 域， 在 显 示 特 长 的 信 息 时 很 有 用， 可 这 样 操 作：用 光 标 将 要 不 滚 动 的 区 域 全 选 上， 点 取 系 统 菜 单 上 的“ 格式”/ “ 段 落”， 选“ 正 文 排 列”， 将“ 与 下 段 同 页” 选 上。
---- 就 这 样， 帮 助 信 息 源 文 件 所 有 的工 作 都 已 作 完， 在WORD 中 将 文 件 以RTF 格 式 存 盘。 下 面 进 入帮 助 项 目 文 件HPJ 的 编 辑。
建 立 帮 助 项 目 文 件（.HPJ 文 件）
以 一 实 例 说 明， 语 句 分 号 右 边 是注 解
[OPTIONS] ; 这 一 节 的 内 容 并 非 必 须
COMPRESS=0 ; 指 示HLP 文 件 不 压 缩
ERRORLOG=my.err ; 编 译 错 误 存于 此 文 件
REPORT=Yes ; 编 译 时 报 告
CONTENTS=contents ; 目 录 跳 转 名
COPYRIGHT= ; 版 权 信 息
DEFFONT=,10,0 ；字 体 大 小
BMROOT=. ; 指 示BMP 文 件 的 存 放 位 置，
在 同 一 目 录 下 用 空 白 或“.” 否 则BMROOT=Drive:\Path
HLP=.\dxchlp.hlp ; 表 明 生 成 的 帮 助 文 件 名
[FILES] ; 唯 一 重 要 的 一 节
