问题标签 [docbook]

我使用基于 c++ 示例的自定义语言突出显示在文档手册上突出显示语法。

如何为相同的荧光笔类型使用不同的样式？

例如：

第二次加载的关键字应该以样式“类”突出显示，但是我如何定义和测试这种非默认样式？

我正在开发一个软件项目，该项目在同一个git存储库中维护源代码以及随附的用户手册（包括教程和参考资料等）。用户手册是使用DocBook编写的。

存储库对于不同的发布分支有不同的分支。例如，我们有一个“主要”分支，可以向其提交功能并从中创建下一个主要版本。我们还有一个“次要”分支，只能提交错误修正，并从中制作下一个次要版本。次要分支经常合并到主要分支中，以确保所有已完成的错误修复也最终出现在下一个主要版本中（这样我们就不会在例如 v1.3 和 v2 之间出现回归）。

我看到的问题是，由于主要分支和次要分支之间的软件不同（主要包含新功能），因此文档也不同（主要分支中的文档可能已在某些地方重写以提及新特征）。在将“次要”合并为“主要”时，这会不时导致 DocBook 源中的冲突，因为分支之间的单行不同。ChangeLog对于其他文档文件（如文件）来说，这实际上是正确的。

我最近开始想知道如何改善这一点。我的想法包括：

1. 只需要一个版本的主要分支和次要分支的手册。对于特定版本的功能，明确地说“从软件的 v2 开始，你也可以做 XYZ”。
2. 将文档文件移动到专用的 git 存储库中。当将存储库的“次要”分支合并到“主要”分支时，这仍然会导致冲突，但至少所有处理源代码的软件开发人员都看不到（并因此而烦恼）冲突。
3. 使用专用的 git 存储库并将它们作为git 子模块嵌入到原始存储库中。我不太确定这会给我带来什么，但我听说使用这样的子模块有点痛苦，因为我最终会一直更新要从外部存储库中提取的参考提交。

我想知道 - 其他人如何处理这种将源代码和文档保持在一起的情况？请注意，我在这里谈论的不是 API 文档（可以从源代码自动生成），而是简单的、手动编写的英文文本。

是否有一些源代码漂亮的打印机能够生成 DocBook，或者至少从我的 C 源代码中生成 XML 输出？

我想在我的 DocBook 文档中包含一些好看的源代码示例。

我需要配置 Apache FOP 以便它使用我的本地 docbook dtd 文件等。我尝试了几乎所有的东西，从编写目录文件到安装 apache xml 解析器等

这是我写的目录文件。我还将 xml.catalog.files 属性设置为该文件，并实例化了 FopFactory 用作 URIResolver 的 apache 目录解析器。但是 fop 仍然从网上获取所有内容。

任何想法出了什么问题？

问候， raichoo

我一直在寻找一个模板来实现这一点。显然，只有oXygen等商业应用程序才能做到这一点。

有没有免费的工具可以做到这一点？或者至少有一个基础模板来定制而不是从头开始编写它会很棒。

我在 SO 中找到的最接近的提示不是很有希望。

当我针对 运行 xjc 时docbook.xsd，我得到了很多错误：

....ETC。

我已经用 docbook 4.5 版和 5.0 版尝试过这个，但结果相同。

任何指针都将不胜感激。谢谢。

来自 Linux 发行版并从网络上的许多示例中复制/粘贴，我正在执行以下操作以在我的 XSL 文件中包含 DocBook 样式（使用 xsltproc 处理）：

只要“docbook.xsl”在指定的位置，它就可以很好地工作。当然，并非总是如此。例如，在带有 MacPorts 的 Mac OSX 上，它需要：

一条完全不同的路。我已经通过网络查看是否存在 XSL 的“文件存在”功能（显然还没有）或者条件包含是否可能（显然不是）。

因此，除了必须根据“docbook.xsl”的实际位置动态创建 XSL（我可能会通过 Makefile 执行此操作）之外，是否还有其他可能性可以从正确的位置导入文件而没有太多麻烦?

编辑/回答： Dimitre 指出了正确的方法，在阅读了一些内容和我系统上的一般目录文件之后，对具体问题的简短回答是使用：

结案，问题解决。编写自己的目录被推迟到另一个时间:-)

我想写一个 asciidoc 文档并将其转换为 pdf 文档。但是，我想使用与默认样式不同的格式样式。为此，我使用 asciidoc 将 txt 文件转换为 docbook，然后尝试使用 dblatex 将生成的 docbook xml 转换为 pdf 文件。这个想法是为 dblatex 设置特定的 tex 样式以获得所需的 pdf 结果。我已经复制了现有的 docbook.sty 样式，因为这里建议进行小的样式修改。在 ./docbook 文件中所做的唯一更改是 \setlength{\textwidth}{18cm} 到 \setlength{\textwidth}{12cm}。但是，当我运行命令时

或者命令

两者在样式更改中产生相同的结果：无。我的意思是，无论我对 ./docbook.sty 文件进行何种修改，这些修改都不会应用于输出。我总是获得相同的结果，即默认格式的 pdf。大家知道问题出在哪里吗？

提前致谢。

我正在使用 Eclipse 以 XML 格式编辑一些 DocBook 文档，而自动格式化程序在处理结尾不带空格的标签时并不是最佳工作。例如，如果我写：

在源文档中，自动格式化后，我得到：

这里的问题是，在构建输出时，在“Hello”和后面的逗号之间添加一个空格，输出类似于“Hello , World!”的内容。

我在编辑器 XML 格式化配置中没有看到任何参数来处理它......有没有办法优雅地处理这个？

组织模式，喜欢它。我一直在尝试设置 mac 以将任何内容导出为 pdf。还没有简单的方法。首先是 org-export-as-pdf，它首先导出为 pdf，然后生成一个 pdf。我得到“pdflatex：找不到命令”，很公平......很难过。其他选项是 org-export-as-docbook-pdf，它先导出为 DocBook XML，然后是 pdf。在这种情况下，我得到“XSLT 处理器命令设置不正确”。

在这两种情况下，都会生成 .tex 和 .xml 文件。在这两种情况下，我都通过足够的阅读来思考：“必须有一个更简单的方法”，我就在这里。谢谢。

Mac OS X 10.6.7 Emacs.app 23.2.1 组织模式 7.4