一个类和hhc.exe还有hha.dll

用于生成包含html目录的chm项目文件 ，然后通过hhp项目文件和内容文件生成 .chm手册。

/* 函数 listDirTree( $dirName = null )

** 功能 列出目录下所有文件及子目录

** 参数 $dirName 目录名称

** 返回 目录结构数组 false为失败

*/

function listDir($dirName = null) {

if (empty($dirName))

exit("IBFileSystem: directory is empty.");

if (is_dir($dirName)) {

if ($dh = opendir($dirName)) {

$tree = array();

while (( $file = readdir($dh) ) !== false) {

if ($file != "." && $file != "..") {

$filePath = $dirName . DIRECTORY_SEPARATOR . $file;

if (is_dir($filePath)) { //为目录,递归

$tree2 =listDir($filePath);

$tree = $tree2? array_merge($tree,$tree2):$tree;

} else { //为文件,添加到当前数组

$tree[] = $filePath;

}

}

}

closedir($dh);

} else {

exit("IBFileSystem: can not open directory $dirName.");

}

//返回当前的$tree

$tree = array_unique($tree);

natsort($tree);

return $tree;

} else {

exit("IBFileSystem: $dirName is not a directory.");

}

}

function listDirTree($dirName = null,$remove) {

if (empty($dirName))

exit("IBFileSystem: directory is empty.");

if (is_dir($dirName)) {

if ($dh = opendir($dirName)) {

$tree = array();

while (( $file = readdir($dh) ) !== false) {

if ($file != "." && $file != ".." && stripos($remove, $file) === false) {

$filePath = $dirName . DIRECTORY_SEPARATOR . $file;

if (is_dir($filePath)) { //为目录,递归

$arr = listDirTree($filePath,$remove);

natsort($arr);

$tree[$file] = $arr;

} else { //为文件,添加到当前数组

$tree[] = $filePath;

}

}

}

closedir($dh);

} else {

exit("IBFileSystem: can not open directory $dirName.");

}

//返回当前的$tree

return $tree;

} else {

exit("IBFileSystem: $dirName is not a directory.");

}

}

function cmp($a,$b){

$a = (int)$a;

$b = (int)$b;

if($a == $b)    return 0;

return ($a>$b)? 1:-1;

}

class chmBuilder{

// const version = 0.1;

public $chm_name;

public $chm_path;

public $chm_hhp;

public $chm_hhc;

public $chm_hhk;

public $chm_uninclude_dirs;

public $chm_uninclude_files;

public $chm_image_type;

public $chm_first_open;

public $chm_title;

public function __construct($chm_name='your_chm',$chm_path='',$chm_uninclude_dirs,$chm_uninclude_files){

$this->chm_name = $chm_name;

$this->chm_path = $chm_path;

$this->chm_uninclude_dirs = $chm_uninclude_dirs;

$this->chm_uninclude_files = $chm_uninclude_files;

$this->chm_image_type = 'Folder';

}

public function build(){

$this->buildHhp();

$this->buildHhc();

$this->buildHhk();

}

public function buildHhp(){

$manual_files = listDir($this->chm_path);

$files = implode(PHP_EOL, $manual_files);

$this->chm_first_open = iconv('UTF-8', 'GB2312', $this->chm_first_open);

$this->chm_title = iconv('UTF-8', 'GB2312', $this->chm_title);

$tpl = <<

[OPTIONS]

Compatibility=1.1 or later

Compiled file={$this->chm_path}/{$this->chm_name}.chm

Contents file={$this->chm_hhc}.hhc

COPYRIGHT=www.thinkphp.cn

Display compile progress=No

Default topic={$this->chm_first_open}

Error log file=chm_builder.Log

Full-text search=Yes

Index file={$this->chm_hhk}.hhk

ImageType={$this->chm_image_type}

Language=0x804

Title={$this->chm_title}

[FILES]

{$files}

eof;

file_put_contents("{$this->chm_path}/{$this->chm_hhp}.hhp", $tpl);

}

public function buildHhc(){

$list = array();

$file_tree = listDirTree($this->chm_path,"{$this->chm_hhp} {$this->chm_uninclude_dirs}{$this->chm_uninclude_files}");

uksort($file_tree, 'cmp');

foreach ($file_tree as $key => $value) {

if(is_string($value)){

$title = explode(DIRECTORY_SEPARATOR, $value);

$title = array_pop($title);

$title = rtrim($title,'.html');

$list[] = <<

eof;

}else{

$child = array();

foreach ($value as $k => $val) {

$title = explode(DIRECTORY_SEPARATOR, $val);

$title = array_pop($title);

$title = rtrim($title,'.html');

$child[] = <<

eof;

}

$child = implode(PHP_EOL, $child);

$list[] = <<

{$child}

eof;

}

}

$list = implode(PHP_EOL, $list);

$tpl = <<

HTML PUBLIC "-//IETF//DTD HTML//EN">

{$list}

eof;

file_put_contents("{$this->chm_path}/{$this->chm_hhc}.hhc", $tpl);

}

public function buildHhk(){

$list = array();

$file_tree = listDir($this->chm_path);

foreach ($file_tree as $key => $value) {

if(is_string($value)){

if(stripos($value, '.html')){

$title = explode(DIRECTORY_SEPARATOR, $value);

$title = array_pop($title);

$title = rtrim($title,'.html');

$list[] = <<

eof;

}

}

}

$list = implode(PHP_EOL, $list);

$tpl = <<

HTML PUBLIC "-//IETF//DTD HTML//EN">

{$list}

eof;

file_put_contents("{$this->chm_path}/{$this->chm_hhk}.hhk", $tpl);

}

public function makeChm(){

if(!is_file("{$this->chm_path}/{$this->chm_hhp}.hhp"))

return "build error：can't generate *.hhp file!";

$command = "hhc {$this->chm_path}/{$this->chm_hhp}.hhp";

system($command);

if(file_exists("{$this->chm_path}/{$this->chm_name}.chm"))

return true;

else

return 'generate chm failed!';

}

}

?>

使用方法，放到要生成目录的外面 定义好路径，手册名，不包含目录，不包含文件 字符串(空格分割)，设置好一些属性后， 将hhc.exe的位置加入环境变量path中，cmd 里调用 执行的index.php 可以看到生成的信息，或者错误

index.php

header('Content-type:text/plain;charset=utf-8');

error_reporting(E_ERROR);

ini_set('memory_limit', '30M');

include 'chm_builder.php';

$chm = new chmBuilder('ThinkPHP manual',__DIR__.DIRECTORY_SEPARATOR.'manual','public ','.DS_Store Thumbs.db book.tpl');

$chm->chm_hhp = 'index';

$chm->chm_hhc = 'index';

$chm->chm_first_open = $chm->chm_path.DIRECTORY_SEPARATOR.'序言.html';

$chm->chm_hhk = 'index';

$chm->chm_title = 'ThinkPHP 3.1.2官方手册';

$chm->build();

//$chm->makeChm();

?>

这个可以配合ThinkPHP Sublime 插件来生成手册，目前排序方面有点问题，故没集成到插件里去。目前只支持二级分类，多级的大家递归时tab缩进好个是就行了，用手册里第一层目录和单文件名作为章节，里面的文件作为子章节