我必须为我所做的项目制作某种形式的文档,以及屏幕截图等,我想让它不那么简单,所以我尝试将CSS添加到我的文件中,但它不起作用。经过一番浏览,我发现这需要XSL或XSLT,我从未使用过,也找不到任何好的教程/文档/示例。
您必须区分 DocBook 的不同部分 - 创作和处理(输出结果(。
创作
DocBook 创作是相当离散的 - 为了获得最佳结果,请使用特殊的 GUI XML 编辑器,如 XMLMind XML 编辑器或 OxygenXML Author,而不是纯文本编辑器(我与 XMLMind 或 Oxygen 没有任何关系(。当然,你可以问,为什么我提到创作工具而不是定制本身,以及这些工具与定制有什么关系?答案是:任何XML编辑器本身都可以以某种方式完全自定义,您需要它来进行富有成效的工作。那里基本上没有与 DocBook XSL 样式表相关的内容,但可以自定义任何编辑器以获得最适合创作的结果。此自定义的许多部分都与 XSLT/XPath 相关。
加工
这部分完全取决于您对 XSLT 领域的了解,同时取决于您想要获得(期望(的结果。DocBook 样式表旨在获得结果(输出文件(,无论您的 XSLT 知识如何,但结果的复杂性将完全取决于您的知识水平。 这里有一个简单的列表,让你了解你需要去的地方:
-
如果您对 XSLT 一无所知 - 您将获得现成的默认结果。
-
如果您准备对 DocBook 参数进行少量挖掘并调整它们 - 您将获得更适合您需求的结果。 即,您可以调整PDF(
body.font.master
(的页面字体,选择目录(generate.toc
(中包含的文档标题等。您只需要调整一个文件:<docbook-xsl-distro-dir>/<output_type>/param.xsl
,其中docbook-xsl-distro-dir
- 是包含 DocBook XSL 样式表的目录,<output_type>
- 您需要获取的输出结果类型(fo
>打印,html
> html(。要了解每个参数的适用性,您可以使用 DocBook XSL 参考或/和(推荐!(Bob Stayton 的《DocBook XSL: The Complete Guide》(可在线获取(一书。 -
如果您准备深入研究自定义的深度 - 您需要获得非常复杂的输出结果。在这种情况下,您需要:
- 了解XSLT(DocBook XSL样式表是用XSLT 1.0编写的(。我会推荐XSLT Quick(来自Manning出版社(;
- 通读DocBook XSL: The Complete Guide;
- 了解HTML或XSL:FO(取决于输出(。