问题标签 [docbook-xsl]

我在命令行中使用 Docbook 1.78 和 xsltproc（libxslt 1.1.26 和 libxml 2.7.8）从 XML 文件生成 fo 文件。我的目标是使用 Apache 格式的输出处理器（fop；1.1 版）生成 PDF。我的 XML 输入文件：

如果我运行以下命令

生成了 fo 文件，但它包含 fo:wrapper 元素，其 ID 不是唯一的。这是生成的 fo 文件：

现在，如果我尝试从该 fo 文件生成 pdf 文件，fop 会引发异常：

我在这里做错什么了吗？我很感激任何帮助！

提前致谢！

编辑 这里是 glosar_test.xml：

背景：我正在编写一个 DocBook 5 文档（并在其中包含一些已经编写的文本），目的是从中生成 HTML。我想从一开始就得到正确的语义标记，所以我以后不需要重新做，但是标准方法似乎没有生成我正在寻找的东西，所以我不确定我是否应该是否偏离它，取决于 XSL 的可能性。

当前设置：我的词汇表只有缩写项目。它由glossentrys 组成，每个 s 都包含一个完整的拼写glossterm和一些非零数量的acronyms 和/或abbrevs。我想这可能只是glossterms 。对我来说没关系。假设例如我有这个：

理想的

假设无论我想在哪里提到 Firefox，我都会FF在文本中输入。理想情况下，没有任何额外的标记，只要“FF”（区分大小写）在我的 DocBook 文件中的para图形（或者title，但不是，例如，code或者programlisting属性内的 URL 内......）中作为一个简单的整个单词出现，它会在 HTML 中以文本“FF”的形式出现，但标记为词汇表条目的链接，但不使用标准链接 CSS，此外还有一个title具有值的属性Firefox. 这样，读者可以将鼠标悬停以获取为他们拼写的首字母缩写词/缩写，如果这还不够，他们可以单击以获取更完整的定义。同时，我会将其设置为黑色并加下划线，以便他们知道此功能存在，但它不会像普通链接那样分散注意力，尤其是在文本中出现的频率。

主要问题：在 XSL 中这种纯文本、无标记术语的替换是否可能（不会产生像斯肯索普问题这样的问题）？如果是这样，它可以自动为每个acronym或abbrev在词汇表中找到吗？

我无法弄清楚如何直接做到这一点，但这仍然是我的目标。同时我尝试了其他事情：

方法一

设置一个键盘宏，这样我就可以ff在输入<xref linkend="ff"/>.

优点：

1. 词汇表的链接
2. 拼出缩写

缺点：

1. 拼出缩写（最好保持简短阅读，而不仅仅是简短键入）...解决方法：将其acronym放入 aglossterm并将其放在首位glossentry（语义丢失，但也许在这里可以吗？）
2. 词汇表的链接（我希望它的样式不同）...解决方案：CSS fora.xref
3. 即使解决了上述两个问题，标题FFFirefox也不仅仅是Firefox（以及其他有多个同义词的人，混搭继续）......解决方案：在您喜欢的首字母缩写词/缩写词上放置一个替代xml:id词，然后使其中的链接在其endterm属性中引用该 id（以及linkend对第一个 id 的引用）
4. 我必须记住使用键盘宏，而不是仅仅键入并让系统完成工作；任何导入的文本都必须对每个词汇表条目进行文本替换

方法二

使用<xsl:param name="glossterm.auto.link" select="1"/>和 键盘宏更改FF为<glossterm>FF</glossterm>.

优点：

1. 词汇表的链接

缺点：

1. 拼出缩写（最好保持简短阅读，而不仅仅是简短键入）...解决方法：将其acronym放入 aglossterm并将其放在首位glossentry（语义丢失，但也许在这里可以吗？）
2. 词汇表的链接（我希望它的样式不同）...解决方案：CSS for.glossterm
3. 即使解决了上述两个问题，也没有title给出任何属性
4. 我必须记住使用键盘宏，而不是仅仅键入并让系统完成工作；任何导入的文本都必须对每个词汇表条目进行文本替换

到目前为止，方法 1 在解决方法之后似乎更好，但是有没有办法实现我概述的理想？

xsltproc←当我尝试使用在任何 DocBook 5 实体列表中都没有看到的普通左箭头（即 ←）时，会抱怨“实体 'larr' 未定义'” 。我需要包括什么才能让它工作？

我当前的 XSL 是：

...并且 docbook 文件仅以：

...之后我直接进入titleandchapter标签。

我是否需要链接到其他东西才能获得“larr”实体，还是只是从 DocBook 5 中删除？

我一直在阅读 DocBook 文档，但我并没有真正理解如何去做。

如果你看到这个网站，它们包含我想要的东西，一个树视图和一个搜索索引，它使用与该工具相同的文档，用于 DocBook 的 webdocs。

http://docbook.sourceforge.net/release/xsl/current/webhelp/docs/ch01.html

我有一个json字符串：

我需要将其转换为 DocBook，就像我提供的链接中显示的一样；但是，每次我阅读有关教程和文档的页面时，它们都会更改所需的一切，我应该使用的程序，产品。所以我很困惑。

给我一个小例子，说明我应该使用什么程序sudo apt-get install，以及上面数据中的一本书应该如何以 DocBook 的格式显示（只是一本示例书）。

听说DocBooks可以转换成html、multiple-html、chm；我想要单个html。

我正在 DocBook 中编写一些文档，并且文档中有一些图片，如下所示：

它没有什么奇怪的，但正如你所看到的，在图像的标题中是reference。我的问题是，在参考列表中不仅是当前图像的标题，而且是整个引用，如下所示：

<book lang='sk'>如您所见，语言是斯洛伐克语 ( )。我不想显示红色区域 - 只显示没有引用的图像标题。

如有任何帮助，请提前感谢您。

我应该采取哪些步骤在 docbook xml 文件中创建一个占位符，该文件将在生成的 HTML 输出中使用字体真棒字体。寻找在从 DocBook 生成的 HTML 输出中使用字体真棒字体的 xslt 示例。

我有一个 DocBook V5.0 文档，它曾经是一个.docbook包含整本书的文件。那时，生成的 TOC 看起来不错。现在，我已经将输入分块到 4 个不同的.docbook文件中，并且还想要分块输出。

在这个改变之后，我突然有两个问题：

1. TOC只包含四个条目（每个 .docbook 一个），而不是它过去的全部深度
2. 很奇怪的是，TOC 章节编号是1、2 和 4，然后是没有编号的词汇表。

关于后者，如果我删除第二章，我会得到 1、2 和词汇表，所以我猜不是第二章的内容导致了编号错误。

无论如何，我的问题是，如何在保留分块输入和输出的同时恢复正常的 TOC？（分块甚至可以限制为单文件深度，即一个文件输入，一个文件输出 - 但我希望 TOC 深度更高。）

我做了什么

我使我的主文件看起来像这样：

我的 XSL 与以前类似，但添加了一些分块控制选项（但对原始 TOC 选项没有更改）：

我的.docbook文件都是这样的：

一个 ...

除了glossary.doc：

词汇表

现在，我意识到在一个章节中有一个章节可能有点奇怪。这甚至可能是原因。但是，它会在没有警告的情况下进行验证，而且，如果我改为在给定文件中制作最外层的标签<section>，则 TOC 中会丢失整个文件。

在我的 docbook 用户指南项目中，我有一个 pdf 格式的小 2 页快速入门的链接。在我生成并打开用户指南 pdf 并单击快速入门 pdf 的链接后，快速入门将替换 acrobat 阅读器中的用户指南。快速入门是否可以在单独的 pdf 查看器中打开。我的研究表明没有。但是，可以将 pdf 打开到特定页面，但不是我想要的。 xlink:href="qs.pdf#page=3"

本FAQ部分描述了如何设置目录中显示的“section depth”/“TOC level”/toclevel。但是，我不知道如何在我的简单中实现这一点：

命令。有没有人？

我有一些 asciidoc 源，我将其转换为分块的 HTML 和 PDF 用于文档。该文档包含外部链接，如下所示：

ASCIIDOC 源：

Asciidoc 正确生成以下 XML 表示：

xsltproc 正在将此 XML 转换为 .fo，如下所示：

在 PDF 中呈现如下：

Link Text [ https://some-url-here.tld ]

而不是：

Link Text

这是指向https://some-url-here.tld的链接

我将 Asciidoc 8.6.9 与 docbook 1.7.0 xsl 样式表一起使用。