问题标签 [docbook]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
xml - 文档、图像、ANT
我正在尝试通过 XSLT 将 DocBook XML - 文件转换为 HTML。XML - 文件包含一个图像，这就是我收到以下错误的原因：
DocBook 文件：
构建文件：
我应该在哪里查找错误？
apache-fop - 通过 DocBook 和 FOP 生成 PDF 时如何禁用标题页？
并不是说这完全可行，我有一个特定的客户想要关闭正在生成的 PDF 中的标题页。我查看并查看了 DocBook FOP 参数和文档，但找不到禁用标题页的方法。然而，我找到了定制的方法。
xslt - DocBook XSL - 可以编辑原始样式表吗？
我想根据特定内容是否定义了某个属性，将 DocBook 目录的某些行加粗。<section>这很容易通过向<xsl:if test="...">DocBook XSL 添加一条语句（fo/autotoc.xsl 第 187-230 行——这是用于使用 XMLMind 输出到 PDF）。
不过，我想知道，自己编辑 DocBook XSL 是否是不好的做法。我在自己的单独 XSL 中进行了其他自定义，主要是设置参数，但我无法想象我将如何引入这个条件逻辑——基于当前正在处理的 TOC 的哪一行——而不放置某种代码在原件中。有什么想法吗？进行更改后如何升级到更新的 DocBook XSL？
xslt - XSLT：将值从一个 for-each 匹配传递到下一个
我正在使用以下内容将所有<section>s 与修订属性集匹配。<section>可以出现在文档树的许多不同级别，总是包含在<chapter>s 中。
正如评论所说，我需要让每次for-each迭代都知道前一个匹配部分所属的章节。我知道<xsl:variable>s 设置后实际上是静态的，并且<xsl:param>仅适用于调用模板。
这是 Docbook，我可以通过以下方式检索章节的章节编号：
但我认为它可以用纯粹的 XPath 来完成。
有任何想法吗？谢谢！
xslt - 图像上的文档最大宽度？(xml:fo)
有没有办法在 docbook xsl-transform 中指定图像的最大宽度？
我们有一个问题是屏幕截图太大而无法放在页面上，因此希望在输出中的图像上设置最大宽度。
在 Docbook XML 文件中指定图像的宽度似乎是错误的形式（Docbook 文件应该是关于内容而不是演示文稿），大量的手动工作，并且可能大小不一致
那么有没有一种方便的方法来做到这一点？
image.default.width 没有用，因为它也会改变小于“页面”宽度的图像。
xslt - XSLT 中的预处理
是否可以在 XSLT 中进行“预处理”？
通过预处理，我的意思是更新源树的（内存表示）。
这可能吗，还是我需要为它做多次转换。
用例：我们为客户提供 Docbook 参考手册，但对于某些客户，这些需要不同的“皮肤”（不同的图像等）。所以我希望做的是根据参数转换图像文件引用路径。然后应用其余的普通 Docbook XSL 模板。
php - PHP 的外部文档，没有 DocBook
我需要一个 PHP 项目的文档系统，并且我希望它能够将外部文档（用例、项目范围等）与从代码注释生成的文档集成。似乎 phpDocumentor 具有完全正确的功能集，但外部文档必须用 DocBook 编写，这对我们的团队来说太复杂了。
如果它在 python 中，sphinx 将非常适合这项工作（ReST 绝对比 docbook 简单）。有什么方法可以将外部 ReST 文档与从 phpdoc 中提取的文档集成在一起？我是否应该将外部文档分开（例如，将 ReST 用于外部，将 phpdoc 用于内部）？或者您对管理外部文档有更好的建议吗？
python - wiki/docbook/latex 文档模板系统
我正在寻找一个文档模板系统，或者更确切地说将创建一个。它应该支持以下功能：
- 以 PDF 和 HTML 创建输出
- 支持大而复杂的 (LaTeX) 公式
- 文档之间的引用
- 参考书目
- 模板将由 Python 脚本填充
我用各种 TeX-to-HTML 转换器尝试了 LaTeX，但我对结果不满意。用DocBook有一段时间了，但是我觉得编辑DocBook不好写，对公式的支持还不够。
主要问题是，该系统的用户不知道 LaTeX 语法或 DocBook。我已经考虑过为这些用户提供使用 Wiki 语法（由 Python 转换为 LaTeX）提供编辑可能性的替代方案。
让我们总结一下：我希望至少来自 LaTeX 和 Wiki 输入的 HTML 和 PDF 输出。DocBook 可以用作中间格式。
有没有人遇到过类似的问题，或者可以就我应该使用哪些工具和哪些文件格式给我一个建议？
metadata - Docbook 中的自由格式元数据
我希望在 Docbook (V5) XML 文件中存储一些元数据。具体来说，链接到与相关文章相关的各种资源。我找到了<info>和相关的元素，但它们不太符合我的目的。
有没有办法将自由格式的元数据存储在 Docbook 文件中？我真的只是想要存储在文章级别的键/值对。
谢谢，
肯特
docbook - 在 docbook 程序列表中启用换行并添加换行符号
我们有一些程序员手册，其中示例源代码行在转换为 PDF 时不适合 A4 页面。
由于手动换行代码太多且手动工作，我正在考虑为长行启用换行。然而，为了表示换行，应将换行符号（例如迷你回车符号）作为最后一个字符。
这可能吗 ？
谢谢，
保罗