我必须为我所做的项目制作某种形式的文档,以及屏幕截图等,我想让它不那么简单,所以我尝试将 CSS 添加到我的文件中,但它没有用。经过一番浏览后,我发现这需要 XSL 或 XSLT,我从未使用过,并且找不到任何好的教程/文档/示例。
您必须区分 DocBook 的不同部分 - 创作和处理(输出结果)。
DocBook 创作非常直接 - 要获得最佳结果,请使用特殊的 GUI XML 编辑器,如XMLMind XML Editor或OxygenXML Author而不是纯文本编辑器(我与 XMLMind 或 Oxygen 没有任何关联)。当然,你可以问,为什么我提到了创作工具而不是定制本身,这些工具与定制有什么关系?答案是:任何 XML 编辑器本身都可以以某种方式完全自定义,您需要它来进行高效工作。那里几乎没有与 DocBook XSL 样式表相关的内容,但可以自定义任何编辑器以获得最适合创作的结果。并且这种定制的许多部分都与 XSLT/XPath 相关。
这部分完全取决于您对 XSLT 领域的了解,同时也取决于您想要(期望)得到什么结果。DocBook 样式表旨在获得结果(输出文件),而与您的 XSLT 知识无关,但结果的复杂性将完全取决于您的知识水平。以下是一个简单的列表,可让您了解您需要去的地方:
如果您对 XSLT 一无所知 - 您将获得开箱即用的默认结果。
如果您准备好深入研究 DocBook 参数并调整它们 - 您会得到更适合您需要的结果。即,您可以为 PDF ( body.font.master
)调整页面字体,选择 TOC ( generate.toc
) 中包含哪些文档标题等。您只需要调整一个文件:<docbook-xsl-distro-dir>/<output_type>/param.xsl
,其中docbook-xsl-distro-dir
- 是您的 DocBook XSL 样式表目录,<output_type>
- 输出结果的类型需要获取(fo
> 打印,html
> html)。要找出每个参数适用于什么,您可以使用DocBook XSL 参考或/和(推荐!)书籍DocBook XSL: Bob Stayton的完整指南(可在线获得)。
如果您准备深入了解定制的深度 - 您需要为您的输出获得非常复杂的结果。在这种情况下,您需要:
本文收集自互联网,转载请注明来源。
如有侵权,请联系 [email protected] 删除。
我来说两句