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

【背景】

之前折腾docbook期间，看过不少个docbook制作的在线html教程。

比如：

（花了好半天才找到：）

第 27 章 docbook 指南 – 使用 CSS 定制外观

而其中的css配置，还是很不错的。

觉得比我自己现在正在用的：

https://www.crifan.com/files/res/docbook/css/common_html.css

要好。

所以打算去使用，这个相对好看的，且比较通用的docbook的css配置。

【折腾过程】

1.但是却没找到对应的该css的代码。

2.后来是看到：

docbook.css.source

http://docbook.sourceforge.net/release/xsl/1.78.0/doc/html/docbook.css.source.html

好像是：

可以通过docbook内置的

去生成对应的，通用的css配置的

这个，也是我之前就一直所要实现的效果：

对于docbook的html相关的（单个html，多个html，chm，webhelp等等），包括pdf（比如表格的背景色，标题加粗等公用设置）

都应该是统一实现，

而且是凡是用docbook，都统一用此单个配置

更容易互相理解含义。

对应的，需要那个：

docbook.css.xml

去找了下，找到：

https://projects.coin-or.org/Coopr/browser/coopr.doc/trunk/docbook/xhtml-1_1/docbook.css.xml?rev=6057

https://github.com/ironbee/libhtp/blob/master/docs/docbook-xsl-ns-1.77.1/xhtml5/docbook.css.xml

后来发现，其实本地就有：

E:\Dev_Root\docbook\tools\docbook-xsl-ns-1.78.1\xhtml\docbook.css.xml

E:\Dev_Root\docbook\tools\docbook-xsl-ns-1.78.1\xhtml-1_1\docbook.css.xml

E:\Dev_Root\docbook\tools\docbook-xsl-ns-1.78.1\xhtml5\docbook.css.xml

抽空，去试试这个。

3.Filelist of package docbook-xsl-doc-html in jessie of architecture all

看到有个：

reference.css

所以去看了看本地的：

D:\tmp\tmp_dev_root\cgwin\home\CLi\develop\docbook\tools\docbook-xsl-ns-1.78.1\docsrc\reference.css

然后去试试：

#HTML_STYLESHEET_LOCAL = file:///$(CSS_PATH_LOCAL)/common_html.css
HTML_STYLESHEET_LOCAL = file:///home/CLi/develop/docbook/tools/docbook-xsl-ns-1.78.1/docsrc/reference.css

结果是：

不是我想要的，通用的docbook的css的配置。

4.搜：

docbook css example

而找到：

CSS for HTML/XHTML

看到有个：

MozBook (example).

但是链接失效了。

自己去搜，而找到的：

http://svn.gna.org/svn/fsmetadata/trunk/demos/docbook/MozBook/

有：

http://svn.gna.org/svn/fsmetadata/trunk/demos/docbook/MozBook/MozBook.css

然后也看到有：

http://svn.gna.org/svn/fsmetadata/trunk/demos/docbook/docbook-css-0.4/

另外也找到：

https://github.com/orbeon/flyingsaucer-old/tree/master/demos/docbook/docbook-css-0.4

但是都还是不知道如何用。

5.从：

A CSS for DocBook

找到：

Cascading Stylesheet for DocBook XML

去下载：

http://www.badgers-in-foil.co.uk/projects/docbook-css/docbook-css-0.4.tar.gz

但是还是不知道如何用。

6.另外从

http://svnweb.freebsd.org/doc/head/share/misc/docbook.css

找到：

http://svnweb.freebsd.org/doc/head/share/misc/docbook.css?view=markup

下载

http://svnweb.freebsd.org/doc/head/share/misc/docbook.css?revision=42538&view=co

得到：

docbook.css

然后去用试试：

#HTML_STYLESHEET_LOCAL = $(CSS_PATH_LOCAL)/common_html.css
#HTML_STYLESHEET_LOCAL = file:///$(CSS_PATH_LOCAL)/common_html.css
#HTML_STYLESHEET_LOCAL = file:///home/CLi/develop/docbook/tools/docbook-xsl-ns-1.78.1/docsrc/reference.css
HTML_STYLESHEET_LOCAL = file:///D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/config/docbook-xsl-ns-1.78.1/html/css/docbook.css

效果是，多贴了些图，以便看清楚效果：

总体来说，效果还是很不错的。

所以，抽空，继续试试。

7.可以考虑，整合当前的这个docbook.css，再加上自己对于screen等内容加的背景，合并成自己的：

docbook_crl.css

给自己用。

8.后来又在：

http://www.badgers-in-foil.co.uk/projects/docbook-css/

中看到关于使用说明了：

To use, alter your XML file to include a stylesheet directive,

<?xml version="1.0"?>
<?xml-stylesheet href="docbook-css-0.3/driver.css" type="text/css"?>

<book>
...

然后注意到：

D:\tmp\tmp_dev_root\cgwin\home\CLi\develop\docbook\config\docbook-xsl-ns-1.78.1\html\css\docbook-css-0.4\driver.css

中就是导入其他css：

@import "core.css";
@import "tables.css";
@import "styles.css";
@import "l10n.css";
@import "mozilla.css";
@import "opera.css";

所以，可以去直接本地设置css路径，应该也可以试用的：

# current only support single css file
#HTML_STYLESHEET_LOCAL = $(CSS_PATH_LOCAL)/common_html.css
#HTML_STYLESHEET_LOCAL = file:///$(CSS_PATH_LOCAL)/common_html.css
#HTML_STYLESHEET_LOCAL = file:///home/CLi/develop/docbook/tools/docbook-xsl-ns-1.78.1/docsrc/reference.css
#HTML_STYLESHEET_LOCAL = file:///D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/config/docbook-xsl-ns-1.78.1/html/css/docbook.css
HTML_STYLESHEET_LOCAL = file:///D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/config/docbook-xsl-ns-1.78.1/html/css/docbook-css-0.4/driver.css
HTML_STYLESHEET_RELEASE = $(CSS_PATH_RELEASE)/common_html.css

结果是：

没啥效果，所以貌似不能这么用。

9.再去试试：

<!DOCTYPE book
[

<!ENTITY cur_book_name      "docbook_dev_note" >
<!ENTITY publish_date       "2013-09-05" >
<!ENTITY release_version    "1.7" >

<!ENTITY copyrith_year "2013" >
<!ENTITY entity_common_multi_format SYSTEM  "../../entity_common_multi_format.xml">
<!ENTITY entity_common_publish_info SYSTEM  "../../entity_common_publish_info.xml">
]>

<book version="5.0"
    xmlns="http://docbook.org/ns/docbook"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xl="http://www.w3.org/1999/xlink"

    xml:lang="zh_CN"
    >

<?xml-stylesheet href="D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/config/docbook-xsl-ns-1.78.1/html/css/docbook-css-0.4/driver.css" type="text/css"?>

<info>
    <title>Docbook开发手记</title>
    <subtitle></subtitle>
    <keywordset>
        <keyword>Docbook</keyword>
        <keyword>Docbook5</keyword>
        <keyword>中文</keyword>
        <keyword>开发</keyword>
        <keyword>搭建环境</keyword>
    </keywordset>

结果无效。

10.再去试试：

<?xml version='1.0' encoding="utf-8"?>

<?xml-stylesheet href="D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/config/docbook-xsl-ns-1.78.1/html/css/docbook-css-0.4/driver.css" type="text/css"?>

<!DOCTYPE book
[

<!ENTITY cur_book_name      "docbook_dev_note" >
<!ENTITY publish_date       "2013-09-05" >
<!ENTITY release_version    "1.7" >

<!ENTITY copyrith_year "2013" >
<!ENTITY entity_common_multi_format SYSTEM  "../../entity_common_multi_format.xml">
<!ENTITY entity_common_publish_info SYSTEM  "../../entity_common_publish_info.xml">
]>

<book version="5.0"
    xmlns="http://docbook.org/ns/docbook"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xl="http://www.w3.org/1999/xlink"

    xml:lang="zh_CN"
    >

结果，还是不行。

11.再去试试：

<?xml version='1.0' encoding="utf-8"?>

<?xml-stylesheet href="file:///D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/config/docbook-xsl-ns-1.78.1/html/css/docbook-css-0.4/driver.css" type="text/css"?>

<!DOCTYPE book
[

结果

还是不行。

11.后来对于：

http://i.linuxtoy.org/docs/guide/ch27s21.html

找到了其css：

http://i.linuxtoy.org/docs/guide/docbook.css

所以下载下来，另存为：

docbook_from_linuxtoy_org.css

去用试试：

# current only support single css file
#HTML_STYLESHEET_LOCAL = $(CSS_PATH_LOCAL)/common_html.css
#HTML_STYLESHEET_LOCAL = file:///$(CSS_PATH_LOCAL)/common_html.css
#HTML_STYLESHEET_LOCAL = file:///home/CLi/develop/docbook/tools/docbook-xsl-ns-1.78.1/docsrc/reference.css
#HTML_STYLESHEET_LOCAL = file:///D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/config/docbook-xsl-ns-1.78.1/html/css/docbook.css
HTML_STYLESHEET_LOCAL = file:///D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/config/docbook-xsl-ns-1.78.1/html/css/docbook_from_linuxtoy_org.css
#HTML_STYLESHEET_LOCAL = file:///D:/tmp/tmp_dev_root/cgwin/home/CLi/develop/docbook/config/docbook-xsl-ns-1.78.1/html/css/docbook-css-0.4/driver.css
HTML_STYLESHEET_RELEASE = $(CSS_PATH_RELEASE)/common_html.css

结果效果也很不错：