定制模板

只要选择不同的模板，doc2help就能生成风格多样的文档格式，满足用户个性化需求。定制模板需要有一定的html和js知识。

模板保存在frametemplate目录下，每套模板单独一个子目录。如下所示，frametemplate有套default模板。

 

defualt模板目录下有如下文件，

当用户要定制模板时，请阅读如下几条，在理解了doc2help如何使用模板后，如果哟一定html知识的人，就可以自行修改模板文件：

 

1. 模板目录下必须提供一个pageset.ini文件。该文件保存了配置模板页面所需的所有配置信息。但用户可以只提供一个只有相同文件名的空文件。具体内容通过配置界面修改后再保存回来。

2. doc2help转换文档时，会在输出目录下生成一个docfile目录，word文档的转换内容都存放在该目录下。

3. Doc2help转换文档时，会在输出目录下的js目录下生成titleInfo.js和searchInfo.js两个文件。titleInfo.js文件中包含了树形菜单的菜单信息。searchInfo.js文件中包含了全文检索的关键字索引信息。

4. Doc2help转换文档时，将把模板目录下的其它文档全部拷贝到转换文档的输出目录下。因此，模板目录下的其它文件实际上就是生成文档的html框架文件。

5. 在执行第四步拷贝时，doc2help会同时执行如下文字替换操作，把配置模板中修改的信息替换到框架文件中。

a.替换index.htm文件中的DOC-2-HELP-TITLE为配置的页面标题。

b.替换frame/bottomframe.htm中的DOC-2-HELP-COPYRIGHT为配置的底部信息。

c.frame/menuframe文件中的(MENUTABHIGHT, MENUTABFILE)，在配置为chm格式时，将会被替换为(25, menutab.htm)，否则会替换为( 0, '' )。

 

注意：doc2help生成的文档都是UTF8编码的，修改框架页面时，请保持UTF8格式。

 

定制框架时，可以在拷贝系统提供的default模板文件，再default上进行样式修改满足自己的需要。甚至也可以自己另行生成一个完全不同的模板框架，框架需要的信息在JS目录下都已经提供。如果需要我们帮助定制修改模板，也可以邮件 service@younghua.com 联系我们协商。