摘要:
1 EverEdit插件-CHM助手:一种免费、高效的CHM手册制作方式 1.1 前言 业界制作CHM手册的工具多如牛毛,高贵的商业工具如:HelpNDoc、Help+Manual、HelpSmith等;号称最专业的免费CHM制作工具的Precision Helper,以及其他各种粗制滥造的收费或免 阅读全文
摘要:
1 生成CHM文件后搜索显示为乱码或搜索结果不全的原因及解决办法 1.1 问题背景 使用一些CHM帮助制作工具生成的帮助文件,在html编辑阶段都显示正常,但是生成chm后,可能会出现以下问题: 页面显示为乱码 搜索时,搜索结果为乱码 搜索不到结果,但明明打开手册时可以看到相关文字正常显示。 1.2 阅读全文
摘要:
1 使用Markdown工具写作手册 1.1 概述 为什么使用笔记软件写手册? Markdown语法简单,写作效率高 格式丰富,功能强大 支持代码着色,非常适合软件类手册 支持导出html、pdf 1.2 使用方法 1.2.1 在VNote中写作手册页面 VNote的使用方法本文不详细介绍,但需要明 阅读全文
摘要:
1 CHM助手 >> 高效制作接口文档 1.1 概述 用户如果书写代码的过程中使用了良好的注释,比如:doxygen规范, 则有可能生成比较规范的接口文档。很多工具软件都支持编程扩展,比如:宏/脚本接口,那么,完善的接口文档将会给用户带来极大的便利,否则,软件的使用和推广都会受到较大的影响。 为了能 阅读全文
摘要:
1 CHM助手使用说明 >> 步骤5:制作CHM工程并编译 1.1 概述 chm工程制作及编译并不神秘,chm工程主要包含3个文件,主工程文件(.hpp)、目录文件(.hhc)、索引文件(.hhc),这3个文件都是文本内容文件,在“CHM工程的组成”章节已经介绍。 准备好工程相关文件后,需要安装微软 阅读全文
摘要:
1 CHM助手使用说明 >> 步骤4:制作帮助文件大纲 1.1 概述 使用一般的CHM帮助文件制作工具写作CHM文档时,也需要编写大纲(目录),它们的写作形式一般如下: 逐个创建:由用户手工逐个创建目录节点,并绑定html文件 导入文件:部分软件提供了导入文件功能,导入后节点与html已经绑定,但目 阅读全文
摘要:
1 CHM助手使用说明 >> 步骤3:文字编码转换 1.1 概述 很多新手在制作chm帮助文档时,会发现要么搜索不全,搜索结果为乱码,要么帮助页面显示主乱码,这种情况主要是因为html文档中包含了中文,或其他语言文字,对于包含中文的chm文档,所有的html页面都必须要使用GB2312编码,否则无法 阅读全文
摘要:
1 CHM助手使用说明 >> 步骤2:图片宽度转换相对宽度 1.1 概述 在文档写作界,流传一句“字不如表、表不如图”的定律,所以,即使是chm联机帮助,良好的图文排版,会让手册的知识传播效果加倍,但不幸的是,微软对chm文档的更新已经停止好多年了, 随着硬件的发展,近些年出现了大量高分辨率的屏幕, 阅读全文
摘要:
1 CHM助手使用说明 >> 步骤1:清理HTML文档 1.1 应用场景 由于编译CHM文档时,html文档的目标文本编码方式是GB2312,而使用第三方工具编写的html文件可能是utf8编码或者其他编码方式,有些特殊字符如:©、🕮等,在GB2312文档中显示为乱码,需要使用html符号描述方式 阅读全文
摘要:
1 CHM索引文件说明(HHK) 1.1 概述 索引文件决定了CHM文件中“索引”标签页中显示的内容,索引文件脱胎于目录文件,但又区别于目录文件,目录文件可以显示帮助的章节层次结构,但索引文件不需要显示层次结构,且一个页面可以有多个关键字,且在索引标签中,多个关键字对应一个页面。 下面是一个索引文件 阅读全文