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

游戏

我必须为我所做的项目制作某种形式的文档,以及屏幕截图等,我想让它不那么简单,所以我尝试将 CSS 添加到我的文件中,但它没有用。经过一番浏览后,我发现这需要 XSL 或 XSLT,我从未使用过,并且找不到任何好的教程/文档/示例。

爱德华·西藏

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

创作

DocBook 创作非常直接 - 要获得最佳结果,请使用特殊的 GUI XML 编辑器,如XMLMind XML EditorOxygenXML Author而不是纯文本编辑器(我与 XMLMind 或 Oxygen 没有任何关联)。当然,你可以问,为什么我提到了创作工具而不是定制本身,这些工具与定制有什么关系?答案是:任何 XML 编辑器本身都可以以某种方式完全自定义,您需要它来进行高效工作。那里几乎没有与 DocBook XSL 样式表相关的内容,但可以自定义任何编辑器以获得最适合创作的结果。并且这种定制的许多部分都与 XSLT/XPath 相关。

加工

这部分完全取决于您对 XSLT 领域的了解,同时也取决于您想要(期望)得到什么结果。DocBook 样式表旨在获得结果(输出文件),而与您的 XSLT 知识无关,但结果的复杂性将完全取决于您的知识水平。以下是一个简单的列表,可让您了解您需要去的地方:

  1. 如果您对 XSLT 一无所知 - 您将获得开箱即用的默认结果。

  2. 如果您准备好深入研究 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的完整指南(可在线获得)。

  3. 如果您准备深入了解定制的深度 - 您需要为您的输出获得非常复杂的结果。在这种情况下,您需要:

    • 了解 XSLT(DocBook XSL 样式表是用 XSLT 1.0 编写的)。我会快速推荐XSLT(来自Manning 出版);
    • 阅读DocBook XSL:完整指南
    • 了解 HTML 或 XSL:FO(取决于输出)。

本文收集自互联网,转载请注明来源。

如有侵权,请联系 [email protected] 删除。

编辑于
0

我来说两句

0 条评论
登录 后参与评论

相关文章

我的自定义样式表不会覆盖foundation.css样式表吗?

我可以从样式表 (qss) 更改自定义动态属性吗?

在哪里可以找到firebaseui CSS样式表?

如何告诉UI5在哪里可以找到我的自定义模块?

在哪里可以找到路由和资源的功能定义?

在哪里可以在Azure日志中找到我的自定义HTTP标头?

我在哪里可以找到 Numpy 的 astype() 函数定义?

范围地址,我在哪里可以找到工作表?

在哪里可以找到我的PC使用的Java版本

emacs 在哪里我可以找到使用包依赖

在哪里可以找到“自定义开/关”选项?

如何在UIButton上放置图像/在哪里可以找到好的图标?

使用样式表时自定义字体

为什么我的自定义元素的所有 css 在 Chrome 开发工具中都显示为用户代理样式表?

在哪里可以找到Mozilla firefox开发人员工具主题的样式表

在哪里可以找到由style =“?android:listSeparatorTextViewStyle”引用的样式xml资源?

自定义CSS样式表

在哪里可以共享我的自定义脚本?

如何使用NSwag的UseSwaggerUi3加载自定义样式表

如何在样式表中使用非标准自定义字体?

使用Bootstrap时如何添加自定义CSS样式表

在哪里可以找到好的HTMLEditorKit教程/参考,它实际上说明了如何编辑HTML文档?

在哪里可以找到/使用Python的API?

我在哪里可以找到我的 mySQL 数据库(使用 locate 没有帮助)?

在哪里可以浏览我使用 Terraform 的 AzureRM_Template_Deployment 资源进行的部署?

在哪里可以找到我的WPF应用程序的自由样式?

Filemaker - 如何/在哪里使用自定义功能?

是否可以在Android自定义样式中使用AppThemeBinding?

在我的代码中使用自定义样式