问题标签 [docbook-5]

是否有将 docbook 4.3 书籍转换为最新 DocBook 5 的自动方式（或使用最少的手动更正）？

我正在使用 docbook maven 插件编写一些文档，并且正在寻找自动在 HTML 输出的标题中制作导航栏。

我有一些这样组织的书：

• 指南1
• 指南2
• 教程
  • 教程1
  • 教程2

期望的结果是使用 XSL 样式表在 HTML 输出中为每本书生成一个导航栏。就像是 ：

提前致谢 ：）。

我正在尝试在 windows 上使用 xsltproc 和 xi:include 在我的 docbook 5 文档中而不是实体中。

不幸的是windows版本不支持这个。

Saxon 9.6 和 msxsl 都报错：

我已经包括

在我的自定义 xsl 中。

还有什么我应该做的吗？

我已将自定义样式表编辑为

并使用命令

这现在应该工作吗？

其实maven项目里面有一个maven插件docbkx-maven-plugin可以生成pdf、html或者其他格式，但是问题是你需要多配置xsl模板、css，或者如果你想高亮源码，支持中文等其他语言，你还需要做更多的配置，所以有没有一个独立的maven神器用作docbook生成工具，包括以下功能：

1. 包括 dtd 文件
2. 代码高亮支持
3. 非英文支持，意味着可以像中文内容一样生成pdf
4. 有一个用于生成 html、pdf 的默认 xsl 模板

我曾经使用 Maven 插件 (docbkx) 处理 DocBook 并生成 PDF/HTML……我想知道如何使用 MSBuild 或 XBuild 处理 DocBook。有人已经试过了吗？它有效吗？

我正在尝试阅读有关 Schematron 和 Perl 的文章。

http://www.xml.com/pub/a/2002/01/23/perl-schematron.html?page=2

我的目标是使用 Schematron 和 RelaxNG 来验证 Docbook 5 文档。

但是，我似乎无法让这个基本示例起作用。这是我从 O'Reilly 文章中复制的 Perl 脚本：

我这样调用脚本：

perl schematron.pl path-to-docbook.sch path-to-xml-file

我得到了与命名空间“db”有关的错误：

我的 docbook.sch 文件开始如下。它是 Docbook 5 发行版附带的 docbook.sch 模式文件：

会不会是 Perl 模块使用了不理解命名空间的 Schematron 版本？或者可能是 docbook.sch 不正确？那会很奇怪，因为它随 Docbook 发行版一起提供。

我可能缺少一些基本的东西，因为我是 Schematron 的新手。

我为 Schematron 找到了一个 shell 脚本，您应该能够提供 Schematron 模式和 XML 文档，以便将 Schematron 规则应用于 XML 文档。我在这里找到了脚本：

https://code.google.com/p/schematron/wiki/RunningSchematronWithGNOMExsltproc

脚本使用的各种 xsl 文件可从此处的 Schematron 发行版下载：

http://www.schematron.com/implementation.html

为方便起见，我将在这里重复 shell 脚本。

我像这样运行脚本：

run_schematron.sh docbook1.sch my_xml.xml

shell 脚本生成中间文件 step1.xsl、step2.xsl 和 step3.xsl。但是我已经在 step2.xsl 中偏离了轨道，因为它看起来像这样：

对我来说，这看起来不像 XSL 样式表。有任何想法吗？

当我使用 RelaxNG 和docbook.rngDocBook 5.0 发行版上提供的模式验证我的文档时，会出现这样的错误，

有问题的 XML 元素是informaltable. 事实上，我在 O'Reilly 网站上读到，an 的基本定义informaltable是没有标题的表。但是，在docbook.dtd同一发行版上提供的 DTD 将 指定title为informatltable. 那么这是DTD中的错误吗？

DTD 片段，包含在此处，供参考。如果这个 DTD 确实不正确，那么某处是否有正确的 DTD，或者我可以以某种方式生成它？

如何在 docbook 文件中添加选项卡或输入？我正在编写服务器命令的文档，我需要使用制表符并输入 docbook 文件，我认为 para 标记在我的情况下不起作用。

下面是我试图实现的一个例子：

我怎样才能创建看起来像这样或类似的东西？

我目前正在编写一个更大的 DocBook 文档，虽然它看起来很不错，但我被要求改进它的可访问性。阅读文档后，我想，“这看起来很简单，我只需在其中添加一个<alt>元素，就可以解决所有问题！” ...不用说，事实并非如此。

到目前为止，我一直在包含按键图像的方式；

我选择了图形元素而不是<keycap>在这种情况下使用，因为它使文档中的键看起来更接近真实的东西。但是，只是为了涵盖我的所有基础，我目前正在测试以下内容，但这也不起作用：

屏幕阅读软件仍然无法阅读我的替代文本。

fop除了简单地使用-a标志运行之外，我是否需要进行任何其他类型的配置才能使其在屏幕阅读软件中工作？