打开一个二十年前的软件安装包,点开“帮助”菜单,中文弹出那个熟悉的中文CHM窗口——左边目录树,右边HTML内容。中文这玩意儿十有八九是中文用HTML Help Workshop做的。微软在1997年随Visual Studio 6.0一起扔出来的中文这个小工具,至今还能在Windows 11上跑。中文中文版更特殊,中文汉化不完全,中文菜单里中英混杂,中文“文件”下面跟着“New”,中文看着别扭,中文用起来倒不碍事。中文
核心功能就一个:把一堆HTML文件、中文图片、中文CSS打包成一个CHM(Compiled HTML Help)文件。CHM本质上是压缩的HTML集合,带索引和全文搜索。HTML Help Workshop提供图形界面来编排目录(TOC)、索引(Index)和搜索关键词。你不需要懂命令行,拖拽文件、填表格就行。生成后的CHM双击即开,不依赖浏览器,离线可用。很多老软件、内部文档、电子书至今保留CHM格式,就是因为这个。
中文版的问题在于翻译不彻底。比如“Project”标签页下,“Contents”、“Index”、“Search”这些词没翻,但“Add/Remove”翻成了“添加/删除”。新手容易懵:到底该点哪个?我的经验是,直接看英文原版菜单截图对照,或者干脆用英文版。中文版唯一的好处是帮助文档有部分中文,但翻译质量参差,有些句子读起来像机器翻的。
第一,路径不能有中文。项目文件(.hhp)、目录文件(.hhc)、索引文件(.hhk)如果放在中文目录下,编译时直接报错“Cannot open file”。必须全英文路径。第二,HTML文件编码要小心。老版本默认用GBK,如果你的HTML是UTF-8,中文会乱码。解决办法:在HTML里加<meta charset="gb2312">,或者用中文版自带的编辑器另存为ANSI。第三,编译后的CHM在Win10/11上打开可能空白,右键属性里勾“解除锁定”就行——这是微软自己埋的坑。
我去年帮一个工厂整理设备手册,三百多页HTML,用HTML Help Workshop中文版打包。目录层级做了四层,索引加了八百多个关键词。编译用了不到十秒,生成的CHM才12MB。车间电脑没联网,CHM直接扔共享盘,工人点开就能查。比PDF快,比网页省事。但有个细节:中文版对长文件名支持不好,超过64个字符的HTML文件在TOC里会显示不全。后来我把文件名全改成拼音缩写才解决。
现在做CHM的工具不少,比如HelpNDoc、Dr.Explain,界面漂亮,支持多格式输出。但HTML Help Workshop中文版依然有人用,原因简单:免费、绿色、体积小(安装包不到5MB)、不需要.NET框架。老程序员怀旧,小团队省钱,还有一些政府内网项目指定要CHM格式。我见过一个铁路调度系统,2023年了还在用这个工具生成操作手册。问为什么,答:稳定,没广告,不强制升级。
不过得说实话,这工具对新手不友好。没有实时预览,改完HTML得重新编译才能看效果。索引条目要手动一条条加,不能从HTML里自动提取。中文版更糟,有些对话框按钮文字被截断,比如“确定”显示成“确”。你要是想快速出活,建议先用英文版熟悉流程,再换中文版凑合用。或者干脆用命令行工具hhc.exe,写个批处理脚本,比图形界面快得多。
如果你只是偶尔做个CHM,HTML Help Workshop中文版够用。下载后先别急着建项目,找个英文版对照着看菜单。路径全英文,HTML编码统一成GB2312。编译报错就去微软文档里搜错误码,大部分是路径或文件缺失。别指望它像现代IDE那样智能,它就是个二十多年前的老古董。但老古董的好处是:你知道它每一步在干什么,没有黑箱。
最后提一句:CHM格式本身有安全风险,Windows会拦截从网上下载的CHM。自己做的内部文档没问题,对外发布的话,考虑转成PDF或在线文档。HTML Help Workshop中文版,适合怀旧、适合内网、适合不想折腾新工具的人。用不用,看你手头的事急不急。
```