欧卡2中文社区

 找回密码
 立即注册

QQ登录

只需一步,快速开始

需要三步,才能开始

只需两步,慢速开始

欧卡2入门方向盘选莱仕达V9莱仕达折叠便携游戏方向盘支架欢迎地图Mod入驻
查看: 10394|回复: 0
收起左侧

[计算机科学] 将在线文档转换为chm电子书的方法

[复制链接]
知行 发表于 2012-12-7 12:54 | 显示全部楼层 |阅读模式

在线帮助文档转CHM方法
用到的工具:
      wget工具(Linux自带,Windows下请自行下载),htm2chm(共享软件,不过没什么限制)

具体步骤:
1、使用wget工具下载在线文档整个目录
    简单介绍一下wget的几个用到的参数。

         

          -c 断点续传(ps : 使用断点续传要求服务器支持断点续传)

          -r 递归下载(目录下的所有文件,包括子目录)

          -np 递归下载不搜索上层目录

          -k 把绝对链接转为相对链接(这样下载之后的网页才能离线浏览)

          -L 递归时不进入其他主机

          -p 下载网页所需要的所有文件



    故,使用的命令为:

$wget -c -r -np -k -L -p http://www.dre.vanderbilt.edu/Doxygen/5.7.4/html/ace/index.html



2、使用htm2chm将下载的网页文件转化为CHM
     如前例,我下载了 ACE库,5.7.4版本的在线文档。接着,打开htm2chm软件。主界面如下图:







Note:

        这里不得不提一下CHM文件索引制作的事。能够自动生成CHM索引文件的工具还不存在,只能手动制作。顶多有根据网页文件目录层次生成CHM目录的功能,其实没什么用。各种CHM制作工具都是根据HTML文件的标题生成的索引信息,像制作精良的CHM帮助文档那样方便快捷搜索能力是很难达到的。因为一般来说网页的标题和内容之间关系不是很密切,标题中常常会有多余的信息。比如,说明某个类的页面其标题并不是某个类名,这样你在CHM的搜索框里面搜索这个类的时候是没有结果的。




      我们要选择的是 Compiler 。Compiler 窗口如下





      这里说明一下其中的 Preset(预置) 选项。包含 Downloaded website、Help、Saved page 三种预置方案。由于CHM 的 Help 文档并不能智能的生成目录结构和索引,所以我直接选择了 Downloaded website 方案。

      D:/WorkSpace/www.dre.vanderbilt.edu 是前例中下载的文件的根目录。

我的 Folder: D:/WorkSpace/www.dre.vanderbilt.edu/Doxygen/5.7.4/html/ace

我的 Home: D:/WorkSpace/www.dre.vanderbilt.edu/Doxygen/5.7.4/html/ace/index.html

我的 Output: D:/WorkSpace/www.dre.vanderbilt.edu/Doxygen/5.7.4/html/ace.chm



      接着,按 Start 开始编译 CHM 文件。片刻之后,CHM 文档生成。如下:





3、生成的CHM文件的使用技巧
      由于这种方法制作的 CHM 文档没有索引功能,所以会给日常的使用带来不便。但是,一般的在线手册都会有一个索引页,里面罗列了所有的主题,所有的类名,所有的函数之类的信息。我们只需在此页上 Ctrl + F 打开查找对话框,输入关键字,就可以查找我们感兴趣的内容。我们也只能期待高人们开发出智能生成 CHM 目录和索引的工具了。
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

联系我们|手机版|欧卡2中国 ( 湘ICP备11020288号-1 )

GMT+8, 2024-3-29 02:23 , Processed in 0.034459 second(s), 9 queries , Redis On.

Powered by Discuz! X3.4

Copyright © 2001-2023, Tencent Cloud.

快速回复 返回顶部 返回列表