最新消息:服务器现已从linode换到fzhost.net,且主题已从retina 0.2换为大前端D8

【记录】docbook的docbook-xsl-ns-1.78.1的webhelp:尝试配置参数docbook.css.source给定docbook.css.xml看看是否能生成所需的css

Docbook crifan 58浏览 0评论

【背景】

之前已经折腾过了:

【记录】寻找docbook的通用的css配置

且已经找到了一些可用的css。

但是,对于之前:

docbook.css.source

还是不懂。

所以打算去试试。

【折腾过程】

1.去给:

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

添加对应的设置:

<!-- !!!!NOTE!!! note css file, but is XML file, contain <style> -->
<!-- http://docbook.sourceforge.net/release/xsl/1.78.1/doc/html/docbook.css.source.html -->
<xsl:param name="docbook.css.source">&xsl_ns_path;/xhtml-1_1/docbook.css.xml</xsl:param>
<!-- http://docbook.sourceforge.net/release/xsl/1.78.1/doc/html/custom.css.source.html -->
<xsl:param name="custom.css.source"></xsl:param>
<!-- http://docbook.sourceforge.net/release/xsl/1.78.1/doc/html/make.clean.html.html -->
<xsl:param name="make.clean.html" select="1"></xsl:param>

去编译看看:

结果生成的webhelp中:

(1)是有docbook的css:

<link rel="stylesheet" type="text/css" href="/home/CLi/develop/docbook/tools/docbook-xsl-ns-1.78.1/xhtml-1_1/docbook.css">

但是却是有问题的:

A:

/home/CLi/develop/docbook/tools/docbook-xsl-ns-1.78.1/xhtml-1_1/docbook.css

不存在;

B:

应该是有生成的:

xhtml-1_1/docbook.css

但是不知道在哪里。

后来找到了,原来是在:

D:\tmp\tmp_dev_root\cgwin\home\CLi\develop\docbook\books\docbook_dev_note\output\webhelp\home\CLi\develop\docbook\tools\docbook-xsl-ns-1.78.1\xhtml-1_1\docbook.css

所以上述的:

/home/CLi/develop/docbook/tools/docbook-xsl-ns-1.78.1/xhtml-1_1/docbook.css

其实是相对于:

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

的相对路径,而不是cygwin中的绝对路径。

但是试了试,Firefox和Chrome,点击css地址,都无法打开,说明是不识别此地址的。

 

(2)html中,还是有

<style type="text/css">

#noscript{
    font-weight:bold;
	background-color: #55AA55;
    font-weight: bold;
    height: 25spx;
    z-index: 3000;
	top:0px;
	width:100%;
	position: relative;
	border-bottom: solid 5px black;
	text-align:center;
	color: white;
}

...

还不是clean的html。

2.去拷贝对应的,几种版本的docbook.css.xml文件到当前xsl文件夹下,然后去配置:

<!-- <xsl:param name="docbook.css.source">&xsl_ns_path;/xhtml-1_1/docbook.css.xml</xsl:param> -->
<xsl:param name="docbook.css.source">docbook_css/xhtml-1_1/docbook.css.xml</xsl:param>

结果是:

这下生成的html中有了:

<link rel="stylesheet" type="text/css" href="docbook_css/xhtml-1_1/docbook.css">

看看浏览器中是否能打开和加载:

结果firefox无法打开css:

Firefox 无法在 view-source:file:///D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/books/docbook_dev_note/output/webhelp/docbook_css/xhtml-1_1/docbook.css 找到该文件。

且的确也没有改css文件。

3.再去试试:

<!-- <xsl:param name="docbook.css.source">&xsl_ns_path;/xhtml-1_1/docbook.css.xml</xsl:param> -->
<!-- <xsl:param name="docbook.css.source">docbook_css/xhtml-1_1/docbook.css.xml</xsl:param> -->
<xsl:param name="docbook.css.source">docbook.css_xhtml_1_1.xml</xsl:param>

结果:

还是不行。

4.换成:

<!-- <xsl:param name="docbook.css.source">docbook.css_xhtml_1_1.xml</xsl:param> -->
<xsl:param name="docbook.css.source">docbook.css.xml</xsl:param>

结果:

当然文件夹下会有:

docbook.css

然后html中也是:

<link rel="stylesheet" type="text/css" href="docbook.css">

浏览器效果:

没变化。

5.估计是我自己加了自定义的css,覆盖了原有的效果。

所以去掉自定义的css,再去试试。

结果是可以用到此docbook.css了,但是由于docbook.css中本身内容很少,所以配置效果很差,包括programlisting都没有背景色:

docbook css default for programlisting is no background

所以还是放弃使用这个docbook.css了。

6.换用:xhtml和xhtml5的docbook.css.xml,看看效果,结果也都不是不好。

 

【总结】

至此,即传递docbook.css.xml给docbook.css.source,可以生成docbook.css,但是由于默认的docbook.css.xml的配置太弱,生成的docbook.css也效果很差,所以还是不用这个了。


还是抽空,再去弄自己的docbook_crl.css吧:

【记录】docbook中借鉴别人的css配置以制作自己的css:docbook_crl.css

转载请注明:在路上 » 【记录】docbook的docbook-xsl-ns-1.78.1的webhelp:尝试配置参数docbook.css.source给定docbook.css.xml看看是否能生成所需的css

发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
51 queries in 0.552 seconds, using 13.10MB memory