CHM助手 >> 使用说明 >> 步骤1：清理HTML文档

 

 

1 CHM助手使用说明 >> 步骤1：清理HTML文档

1.1 应用场景

  由于编译CHM文档时，html文档的目标文本编码方式是GB2312，而使用第三方工具编写的html文件可能是utf8编码或者其他编码方式，有些特殊字符如：©、🕮等，在GB2312文档中显示为乱码，需要使用html符号描述方式进行书写。
  此外，为了使CHM页面显示和搜索正常，html文件中也要声明charset为GB2312，如下所示：

<meta http-equiv=Content-Type content="text/html; charset=gb2312">

另外，由于某些css样式在chm中不能正常显示，该清理过程还要删除html中的样式表，并重新引用根目录的vx_style.css文件。

1.2 使用方法

  1. 步骤1：打开EverEdit，并选择主菜单“扩展 -> 模式 -> CHM”，此时，主菜单中会增加“CHM助手”。
🕮说明：
  如果主菜单已经显示“CHM助手”菜单，则步骤1可以省略。
  1. 步骤2：选择主菜单“CHM助手 -> 【一】清理HTML文件(1)”。
  2. 步骤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.

posted @ 2024-12-21 21:58  tyysoft  阅读(4)  评论(0)  编辑  收藏  举报