问题标签 [docbook]

我正在使用Pandoc将 Markdown 转换为 Docbook，对其进行处理，然后使用Apache FOP将 Docbook 渲染为 XSL-FO 。不幸的是，Pandoc 使用 table-layout="auto" 制作表格，而 FOP 仅支持 table-layout="fixed"。

是否有支持 table-layout="auto" 的 XSL-FO 渲染器？

是否有任何现成的用于 Web 应用程序的文档编辑器？我正在考虑 FCKeditor 或 TinyMCE 之类的东西，它会将 docbook xml 代码返回给 Web 应用程序。我知道 FCKeditor 可以自定义执行此操作，但我没有听说有人这样做。

我正在研究 docbook 5.0 中的结构化书籍（小说）。我有几个介绍页面，比如关于这本书、关于作者、关于出版商（有版权、关于打印机和分页器的 isbn 信息）、混蛋标题、标题页。

我不确定，是否最好在 info 元素中构建所有这些内容，或者尝试构建几个部分部分作为每个介绍页面的容器。

有没有这方面的例子，或者你能提供一个例子吗？

任何提示表示赞赏。非常感谢！

坦率

有没有办法在 DocBook 文档中定义宏（如 tex 宏或 latex 定义）？

DocBook 非常冗长，宏会很有帮助。我没有在快速入门教程中找到它们。

如果是这样，任何人都可以提供一个简单的示例或链接吗？

谢谢

我写了一个带有标题的 docbook 5.0 文档：

并且 Ubuntu 9.10 上的 docbook2pdf 会打印许多错误消息，并且不执行任何 pdf 文档。错误是：

docbook2pdf 用于具有正常标题的 docbook 4.5 格式的文档，例如：

工作得很好。

有没有办法从 docbook 5.0 生成 pdf？

如果它与某个章节 ID 匹配，我想编写一个 xslt 规则，它将自动标签在该部分设置为零。

在伪代码中：

但是在阅读了 docbook xsl 网站和 docbook xsl 参考之后，我仍然无法弄清楚如何去做。也许有人可以把我推向正确的方向，因为我是 docbook 和 xls(t) 的新手

亲切的问候，杰瑞

在我的 DocBook 文档中，我有几个部分，它们遵循这种模式：

• 部分名称
• 简短的描述
• 长描述

我想创建这些部分的索引。但我需要它是一个表格，其格式如下：

| link_with_section_name | 简短描述|
| <link id="section1_id">节名1</link> | 简短描述 1 |
| <link id="section2_id">部分名称2</link> | 简短描述 2 |

我不喜欢复制简短描述的想法。我想在第二列中创建某种参考，以便直接从参考部分获取简短描述。我可能可以使用endterm属性创建一个xterm引用，但我不想在第二列创建链接。我只想从包含简短描述的段落中复制内容。

有没有办法在 DocBook 中做到这一点？

我过去使用过 DocBook，我喜欢将内容与表示分离背后的想法。我很喜欢直接编辑 XML。在我广泛搜索以找到满足我需求的最佳文档解决方案时，我总是回到这个解决方案：

DocBook -> 构建系统（ant、make 等） -> 输出

我已经看到很多关于编写 DocBook 的最佳 WYSIWYG、XML、文本编辑器的信息，包括 asciidoc 等替代标记语言。所有这些解决方案都集中在 DocBook 的创建或 DocBook 工具链的噩梦上。除了说“只使用 XSL”或“自定义脚本”之外，没有人提到过输出端

当任务是制作文档或手册时，我不想担心花费无数小时尝试重新编程、定制和修改 XSL、CSS 和 shell 脚本（即 O'Riely 书籍）。这是一项非常艰巨的任务。

我的疑问：是否有使定制更容易的工具？是否有任何类似于 Pages 或 Word 的内容，因为用户创建了一个模板，而工具链完成了其余的工作？尝试执行诸如漂亮的徽标之类的视觉任务并修复默认 XSL 提供的所有损坏的布局（分页是一团糟）对于文本编辑器来说是非常困难的。内容很简单。过去，编辑 DocBook XSL 真是一场噩梦。我搜索过很多关于 XML 编辑器的信息，但没有找到关于 XSL 编辑器的信息。

还是我对这个过程缺乏关键的理解。谢谢。

在花了很多时间试图让我的文章用 Docbook 在 Ant 中编译之后，我似乎无法让 FO 编译工作。我正在使用 Xalan 2.7.0，其他所有内容（单页和分块 HTML）都可以完美编译。只有当我尝试编译为 FO 时才会收到此错误：

这很奇怪，我似乎无法解决它。我什至添加了一个<param>值来定义它“找不到”的变量：

我能做些什么来解决这个问题吗？如果你问我，这真的很奇怪。（同样，使用与上面相同的代码，我所有的其他 Docbook 编译工作都很好）

我负责构建文档系统/平台。

以下是主要要求的简短列表：

• 易于本地化：这将需要支持十几种语言。（非技术人员添加/更新翻译的能力将是一个很大的优势，尽管不是 100% 需要）

• 输出格式的灵活性：至少，我需要将文档（作为一个整体或选定的块）输出为 PDF 和 HTML。Windows 帮助文件等原生格式的奖励积分。

• 通过直观的用户界面（最好是 Web）进行管理和部署。

我想知道你们是否知道已经支持这种类型的任何系统？我不反对从头开始写这篇文章，但如果我能帮上忙，我宁愿不重新发明轮子。

到目前为止，我遇到的两个主要候选人是DocBook和reST。前者似乎以吸吮而闻名。我对这两个都不熟悉，但有人告诉我，reST 可以让我在其中大获成功。

还有其他建议吗？从头开始构建它会更好吗？