如何使用样式表自定义Docbook？在哪里可以找到好的资源？

Question

我必须对我所做的项目进行某种形式的文档记录，包括屏幕截图等，并且我想使其变得不那么平凡，所以我尝试将CS​​S添加到我的文件中，但是没有用。经过一番浏览后，我发现需要XSL或XSLT，而我从未使用过它，并且找不到任何好的教程/文档/示例。

Answer 1

您必须区分DocBook的不同部分-创作和处理（输出结果）。

创作

DocBook的编写非常简单-使用XMLMind XML Editor或OxygenXML Author之类的特殊GUI XML编辑器（而不是纯文本编辑器）来获得最佳结果（我与XMLMind或Oxygen无关） 。当然，您可能会问，为什么我提到了创作工具而不是定制本身，以及这些工具与定制有何关系？答案是：任何XML编辑器本身都可以以某种方式完全自定义，您需要它来进行高效的工作。那里几乎没有与DocBook XSL样式表相关的东西，但是可以自定义任何编辑器 以获得最合适的创作结果。此自定义的许多部分都与XSLT / XPath有关。

处理

这部分完全取决于您对XSLT领域的了解，同时还取决于您要获得（预期）什么结果。 DocBook样式表旨在获取结果（输出文件），而与您的XSLT知识无关，但结果复杂度将完全取决于您的知识水平。 以下是一个简单的列表，可让您了解需要去的地方：

1. 如果您对XSLT一无所知-您将获得默认结果。

2. 如果您准备略微研究DocBook参数并对其进行调整，则结果将更适合您的需求。即您可以调整PDF的页面字体（body.font.master），选择目录标题中包含哪些文档标题（generate.toc等）。您只需要调整一个文件：<docbook-xsl-distro-dir>/<output_type>/param.xsl，其中{ {1}}-是DocBook XSL样式表的目录，docbook-xsl-distro-dir-您需要获取的输出结果的类型（<output_type>> print，fo> html）。要找出每个参数适合的参数，可以使用DocBook XSL reference或/和（推荐！）Bob Stayton撰写的《 DocBook XSL：完整指南》 （{{3} }）。

3. 如果您准备深入研究自定义的深度，则需要获得非常复杂的输出结果。在这种情况下，您需要：

   • 了解XSLT（DocBook XSL样式表以XSLT 1.0编写）。我会推荐快速XSLT （来自online）；
   • 完整阅读《 DocBook XSL：完整指南》 ；
   • 了解HTML或XSL：FO（取决于输出）。