【记录】docbook的docbook-xls-ns-1.78.1中的webhelp：优化使得共享webhelp的（css和js等）模板文件

【背景】

折腾：

【记录】使用docbook的docbook-xsl-ns-1.78.1替换旧的ant改用make去编译webhelp

期间，已经使得在本地，使用docbook-xsl-ns-1.78.1，可以正常编译webhelp了。

现在接着去：

确保，本地和在线，都只有一份webhelp\template\common的内容

• 其下包含很多子文件夹和公用文件的，比如：
• css
  • ie.css
  • positioning.css
• images
  • admon\
  • callouts\
  • …
• jquery
  • jquery-1.7.2.min.js
  • jquery-ui-1.8.2.custom.min.js
  • …
• browserDetect.js
• main.js
• splitterInit.js

【折腾过程】

1.去看了看当前生成的：

D:\tmp\tmp_dev_root\cgwin\home\CLi\develop\docbook\books\docbook_dev_note\output\webhelp\index.html

中的内容，关于common方面的路径，都是类似于：

然后又看到官网的解释：

webhelp.common.dir

所以，去加了对应参数：

然后也不拷贝common了：

结果是：

生成的html中，地址变成需要的本地的路径了：

但是由于不小心，少了个斜杠：

D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/tools/docbook-xsl-ns-1.78.1/webhelp/commonjquery/theme-redmond/jquery-ui-1.8.2.custom.css

应该是：

D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/tools/docbook-xsl-ns-1.78.1/webhelp/common/jquery/theme-redmond/jquery-ui-1.8.2.custom.css

所以去改makefile为：

然后结果是：

地址又搞错了：

D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/tools/docbook-xsl-ns-1.78.1/webhelp/common/css/positioning.css

应该是：

D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/tools/docbook-xsl-ns-1.78.1/webhelp/template/common/css/positioning.css

再去makefile改为：

结果是：

（1）Firefox还是无法正常显示侧边栏目录

原因：

猜测是之前就遇到的：

Firefox中不支持本地css文件地址，

需要加上：

file冒号三个斜杠

的前缀才可以的。

（2）IE中，提示js被禁了

然后去Allow Blocked content，结果：

IE也是可以正常显示侧边栏的目录的：

（3）chrome则最好，直接就支持了，可以正常显示：

2.然后，就去为本地地址，加上

前缀：

结果是：

地址就变成：

了。

（1）firefox可以正常显示了：

（2）IE还是要开启js才可以正常显示，chrome还是正常无压力的打开。

3.然后再去看看，

原先的docbook的webhelp的生成的，本地的：

D:\tmp\tmp_dev_root\cgwin\home\CLi\develop\docbook\tools\docbook-xsl-ns-1.78.1\webhelp\docs\index.html

其结果是：

（1）Firefox可以正常显示

注意到，对应的js等文件，是：

common/css/positioning.css

的地址，即：

相对地址，所以直接显示，无需：

加

前缀；

（2）IE中，也是需要提醒开启js：

然后才能正常显示的：

（3）chrome可以正常打开。

另外，对于在线的：

http://snapshots.docbook.org/xsl/webhelp/docs/

（其中：

• 也是用的类似的webhelp的配置
• 内部的js和css，也是相对路径

）

但是是：

firefox中也是可以正常显示的；

且IE也可以，不会有js被禁止的提示，直接正常显示：

由此推断：

之后，再把webhelp上传到自己的网站时，也是会把对应的js和css等文件，都弄成相对地址的。

这样：

Firefox：js是css是相对地址，可以直接正常显示；

IE：无需被提醒js被禁止，也可以正常显示；

chrome：本身就可以正常显示；

如此以实现，可以同时支持三种浏览器；

而且无需用户去设置什么参数，无需点击运行js运行等等麻烦的操作；

4.然后继续去增加，当make编译 for 在线的webhelp，需要修改对应的路径的。

最后是用如下核心的makefile代码：

然后可以正常的各种编译和删除：

5.另外，再去参考：

webhelp.autolabel

（看到目录中，可以加上章节编号）

webhelp.indexer.language

（看到有zh中文支持）

去加上这些参数：

效果为：

结果经常章节索引编号没生效。

然后语言也没生效。

关于语言部分，看到了：

-DindexerLanguage=en

所以，需要改为统一的配置：

然后效果为：

好像语言部分生效了：

但是目录索引还是没有编号：

后来看到：

D:\tmp\tmp_dev_root\cgwin\home\CLi\develop\docbook\tools\docbook-xsl-ns-1.78.1\webhelp\xsl\webhelp-common.xsl

中设置了：

但是其只是去配置正文部分的章节索引。

而对于webhelp的目录的索引，的确是：

等等内容去配置的。

但是不知道此处为何通过命令行给xsltproc传递：

–stringparam webhelp.autolabel 1

没效果。

6.所以去改为：

–stringparam webhelp.autolabel "1"

和：

–stringparam webhelp.indexer.language "zh"

看看效果：

结果问题依旧。

算了，暂时不管这部分了。

还是等后续，再去合并通用的xls配置，到此webhelp的xls的配置中，再去折腾这部分的设置吧。

【总结】

至此，算是基本告一段落了：

可以实现根据make编译local和release的不同

而传递xsltproc不同的WEBHELP_OTHER_XSLTPROC_ARGS值，

使得模板（css和js等文件）的路径分别指向本地还是在线的地址。

且都可以正常用三种浏览器，firefox，IE，Chrome，去打开。

注：

暂时，由于webhelp部分的template内容，还没上传到网站上，所以此时打开release版本的webhelp，部分js或css加载异常。

需要后续上传上去再去确认才可以的。

转载请注明：在路上 » 【记录】docbook的docbook-xls-ns-1.78.1中的webhelp：优化使得共享webhelp的（css和js等）模板文件