问题标签 [docbook-5]

我正在使用 Maven docbkx 插件生成 PDF。

我希望这些数字像往常一样从 1 开始按顺序编号，忽略任何章节、章节等。

这不起作用，因为我sectionLabelIncludesComponentLabel使用pom.xml. 现在第 2 章的第一部分不是 1（默认情况下），而是 2.1，正如我想要的那样。

但作为一个副作用，第 2.1 章中的第一个数字也得到了数字 2.1，下一个数字得到了 2.2，所以章节号不仅被附加到部分，而且也被附加到数字（这绝对没有意义）。

我怎样才能有分层的部分编号，但同时有简单的连续数字编号？

[编辑]

看起来和sectionLabelIncludesComponentLabel它无关。即使我将其关闭，图形标题也会以章节号为前缀。

从 ant 脚本生成 webhelp 时，部分元素的目录被框阻止。此框似乎与左窗格中的 toc 连接。当目录窗格调整大小时，主窗口中的框也会调整大小。任何人都经历过这种情况并知道如何解决。使用 docbook webhelp 文件夹中的示例 build.xml 和属性文件，无需特殊定制。

我正在尝试更改内联元素的前景色和背景色。文档片段是这样的：

我的自定义层中的 XSL 部分是这样的：

这只会更改背景颜色或前景色，具体取决于最后一个模板。

当角色值为 时，如何同时应用前景和背景f00 b01？注意：不能进行第三次测试，contains " f00 b01 "因为有 256 种颜色可供选择，并且指定所有组合会使模板数量激增。

注意：编辑以更接近实际文件内容

xterm 颜色到 rgb 颜色的映射如下。从颜色 16 开始，它们可以用一个小的 perl 脚本来计算（摘自 xterm distruiution 的片段）：

结果：

背景：我正在编写一个 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 中删除？

（我正在为这个问题的尝试 1 的 Con 3 寻找解决方法。）

我有一个 DocBook 5 文档，其中一些glossentry标签包含多个glossterm标签。

具有等于​​ a 的属性的xref标签的 HTML 输出看起来不错（链接文本是第一个，并且链接正确指向），但它的鼠标悬停文本（在HTML 的属性中）将所有文本连接在一起。linkendxml:idglossentryglosstermglossentrytitleglossterm

我宁愿它只输出第一个glossterm（或者可能将glossterms 用/ora.k.a或其他东西分开以表明它们是同义词。）

我该怎么做呢？我是 DocBook 和 XSLT 的新手。

我的 DocBook 5 文档包含包含glossentry标签的abbrev标签。abbrev标签似乎对呈现的 HTML 没有任何贡献。我是 DocBook 和 XSLT 的新手。我需要从哪里开始寻求改变？我一直在查看文档，除了对这显然是默认行为感到惊讶之外，我不确定在哪里寻找故障排除。

设置：我的 DocBook 文件以<book xmlns:xl="http://www.w3.org/1999/xlink">. 我xsltproc只指向一个 XSL 文件，其中包含以下内容：

我一直在阅读 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 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 中会丢失整个文件。