当前位置：首页 > 前端开发 > 正文

HTML如何制作CHM文件？

HTML文件本身不能直接制作成CHM文件，需借助专用工具实现，方法如下：首先创建包含HTML、图片等资源的帮助文档目录结构，然后使用HTML Help Workshop或类似工具编译生成CHM文件，关键步骤包括编写.hhp项目文件、设计目录导航（.hhc）和索引（.hhk），最后通过编译器将HTML内容打包为CHM格式。

将HTML文件制作成CHM（Compiled HTML Help）文件需通过特定工具编译,以下是详细步骤：

HTML如何制作CHM文件？ 第1张

核心工具准备

  1. HTML Help Workshop（微软官方工具）
    下载地址：Microsoft HTML Help Workshop
    支持Windows系统，免费且兼容性最佳

制作步骤

步骤1：组织HTML文件结构

  • 创建独立文件夹存放所有HTML文件、图片、CSS、JS等资源
  • 确保HTML间链接使用相对路径（如 docs/intro.html）

步骤2：创建项目文件 (.hhp)

  1. 打开HTML Help Workshop → 点击 File > New > Project
  2. 设置项目参数：
    • 项目名称：自定义（如 MyHelp）
    • 存储路径：选择步骤1的文件夹
    • 勾选 “HTML files (.htm)”

步骤3：添加文件到项目

  1. 在 Project 选项卡点击 Add/Remove source files
  2. 将所有HTML文件添加到列表（支持多选）

步骤4：创建目录表 (.hhc)

  1. 点击 Contents 选项卡 → 选择 Create a new contents file
  2. 编辑目录结构：
    • 右键 Insert Heading）
    • 右键 Insert Page（页面）
    • 为每个条目设置：
      • Entry Title：显示名称
      • File：关联的HTML文件路径

步骤5：创建索引 (.hhk)（可选）

  1. 点击 Index 选项卡 → 创建新索引文件
  2. 添加关键词：
    • Keyword：搜索关键词
    • File：关联的目标页面

步骤6：配置项目选项

在 Project 选项卡点击 Change project options：

[OPTIONS]
Compiled file=MyHelp.chm  ; 输出文件名我的帮助文档        ; CHM窗口标题
Default topic=index.html  ; 默认首页

步骤7：编译生成CHM

  1. 点击 Project 选项卡 → Save all files and compile
  2. 成功后在项目文件夹找到 .chm 文件

关键注意事项

  1. 路径问题：
    • 所有资源必须位于项目文件夹内
    • 禁止使用绝对路径（如 C:docsfile.html）
  2. 文件名规范：
    • 避免中文/特殊字符（建议英文命名）
    • 首页建议命名为 index.html
  3. 安全警告处理：
    • 若打开CHM提示”已阻止”，需右键文件 → 属性 → 勾选解除锁定

替代工具推荐

工具名称 特点 适用场景
HelpNDoc 可视化编辑，支持多格式导出 商业级文档制作
Far HTML 免费，支持批量处理 大型项目
CHM Maker 简单易用，中文界面 快速生成

常见问题解决

  • 编译后页面空白：检查HTML文件是否包含<body>
  • 图片无法显示：确认图片路径为相对路径（如 images/logo.png）
  • 搜索功能失效：重新生成索引文件（.hhk）
    •

引用说明：本文方法参考Microsoft HTML Help Workshop官方文档（2025版），工具下载链接来自Microsoft官网，第三方工具数据来源于HelpNDoc v9.2、Far HTML v3.5的公开技术文档。
0

相关文章