第05节 创建、打包 CHM 文件.pdfVIP

第05节　创建、打包 CHM ⽂件 　　与⼀般的 Markdown 编辑器不同，LME ⾛的是 IDE 的路⼦，包含较为简单的⽂ 件管理、引⽤链接字 串⽣成等功能。这种⽬录结构与微软公司的 CHM ⽂件格式所 要求的⽬录结构存在相似之处。⽽恰巧 Markdown 编译⽣成的 Html ⽹页⽂件又可以 作为 CHM ⽂件的基本素材。所以很⾃然地想到对 LME 作个简单的改进，使之⽀ 持“Markdown→Html→CHM”这样的功能。 　　由于微软公司官⽅提供了可以免费使⽤的 CHM ⼯程创建、编译的⼯具软件 （Html Help Workshop ）。所以，实现⾃⼰的 CHM 编译器并⽆必要。LME 只负责⽣ 成 Html Help Workshop 所需要的 CHM ⼯程⽂件 （包括⽬录⽂件、索引⽂件）。然后 ⽤户可以调⽤另⾏安装的 Html Help Workshop 来编译、⽣成打包的 CHM ⽂档。 　　当我们创建好了⼯作区中各⽬录、⽂件结构，并完成各 Markdown ⽂件的编写 后，就可以创建 CHM ⼯程⽂件了： 　　当我们点击“编译”→“创建 CHM ⼯程⽂件”菜单项时，通常会⾃动调 ⽤“编译”→“编译⼯作区”菜单项的功能。 安装 Html Help Workshop 　　如果我们还没有安装 Html Help Workshop 程序，这时会弹出： 　　如果计算机上没有安装 Html Help Workshop ，则应选择“否” ，然后去微软公司官 ⽅⽹站下载、安装。如果计算机上有所谓的“绿⾊汉化版” ，也可以尝试直接指定它的 可执⾏程序在磁盘上的真实路径。 　　微软公司官⽅⽹站提供的是英⽂版。⽹上有汉化版，但不建议使 ⽤。Html Help Workshop 界⾯上的英⽂并不是太多，即使英⽂不太好的 ⽤户⼀般查查词典也能⽤。⽹上的汉化版有时有些库⽂件未在操作系统 中注册，会造成意外错误——需要另⾏想办法。 　　　然后，选择“htmlhelp .exe”下载： 　　下载后⼀步步安装好，重启 LME 即可。 编译 CHM ⽂档 　　安装好 Html Help Workshop 后，点击“编译”→“创建 CHM ⼯程⽂件”菜单项，期 间可能提⽰需要编译整个⼯作区。然后，会⾃动⽣成 CHM ⼯程⽂件 （包括⽬录⽂ 件、索引⽂件）。 　　注意：如果需要将⼯作区打包编译成 CHM ⽂档，在将⼯作区中的 Markdown ⽂件编译为 Html ⽹页⽂件之前，应先点击“编译”→“Html 编 译选项”→“编译为 GB2 12”菜单项。 　　这是因为：作为⼀种⽐较旧的⽂件格式 （微软已放弃更新），CHM 对 Unocode 字 编码的⽀持较差；⽽对 GB2 12 编码⽀持较好。 　　LME 仅仅只⾯向中⽂⽤户，没有考虑其它语⾔⽤户的使⽤情况。故 只提供了两种编码⽅案供选择：UTF-8和GB2 12 。 　　然后，在下⾯弹出的窗⼜中检查⼯程⽂件路径⾸尾是否有双引号。如果有，⼿⼯ 删除掉。 　　再点击上图中“Compile”按钮执⾏打包 （编译）CHM ⽂件的操作。 　　为什么要检查路径⾸尾有没有双引号呢？ 　　这与当前⼯作区⽬录的路径中有⽆空格有关。LME 在调⽤ Html Help Workshop 时是通过命令⾏的⽅式来进⾏的。如果当前⼯作区⽬录的 绝对路径中包含半⾓空格字 ，在通过命令⾏调⽤ Html Help Workshop 时会将该路径⽤⼀对双引号包围起来作为命令⾏参数传递给 Html Help Workshop 。 　　命令⾏参数通常是以半⾓空格作为分隔 的。如果不使⽤⼀对双引 号把路径括起来，这个路径会被解释成为多个参数。这样 Html Help Workshop 就⽆法识别此⼯作区⽬录了。 　　可是 Html Help Workshop 本⾝设计上有缺陷，当它通过命令⾏参数 得到⽤双引号括起来