1 CHM助手使用说明 >> 步骤1:清理HTML文档
1.1 应用场景
由于编译CHM文档时,html文档的目标文本编码方式是GB2312,而使用第三方工具编写的html文件可能是utf8编码或者其他编码方式,有些特殊字符如:©、🕮等,在GB2312文档中显示为乱码,需要使用html符号描述方式进行书写。
此外,为了使CHM页面显示和搜索正常,html文件中也要声明charset为GB2312,如下所示:
另外,由于某些css样式在chm中不能正常显示,该清理过程还要删除html中的样式表,并重新引用根目录的vx_style.css文件。
1.2 使用方法
- 步骤1:打开EverEdit,并选择主菜单“扩展 -> 模式 -> CHM”,此时,主菜单中会增加“CHM助手”。
如果主菜单已经显示“CHM助手”菜单,则步骤1可以省略。
- 步骤2:选择主菜单“CHM助手 -> 【一】清理HTML文件(1)”。
- 步骤3:在弹出的输入框中输入html文件所在的路径并单击确定,如下图所示:
注:由于脚本工作原理是使用EverEdit打开html文档,并使用EverEdit的替换API对文档进行替换,在处理大量html文件时,会伴随文件的打开及关闭,出现界面不停的闪烁,此为正常现象,处理完成后在输出窗口打印处理的过程信息,用户可以在此查看是否存在错误。
🕮说明:如果是处理VNote导出的html文档,可以选择“【多合一】清理并转码HTML文件(F)”菜单, 一次处理格式和转码。
如果使用了VNote中某些格式描述,或者用户自定义了CSS样式,在清理时可能会处理不全,如果chm显示时缺少样式,用户可以自行添加到vx_style.css文件中,如果添加到插件目录的vx_style.css文件,则后续新的chm工程就不需要再添加,修改css样式后,chm工程需要重新编译。
1.3 后记
如果用户处理的是其他软件生成的html文档,可能存在css样式表不兼容,或格式清理不完整的情况,需要用户手动根据具体情况进行处理,当然,这需要用户有一定制html/css基础。普通用户,如果只是一般的写作手册,为与“CHM助手”兼容,建议使用VNote写作手册。
文档作者声明:本文档仅用于学习交流,未经作者许可,不得将本文档用于其他目的。
Copyright © 2022~2024 All rights reserved.