Asciidoctor擅长的一个任务是将AsciiDoc源码转换成有效且格式良好的DocBook XML内容。但如果你处于需要反向操作的位置，将你的旧版DocBook XML内容迁移到AsciiDoc怎么办呢？你摆脱DocBook痛苦所需的药方（℞）可能是https://github.com/asciidoctor/docbookrx[DocBookRx^]。

DocBookRx

DocBookRx是一个早期版本的DocBook到AsciiDoc的转换器，使用Ruby编写。目前这个转换器远非完美，但它会随着转换的文档越来越多而不断改进。

计划是将其发展成为一个强大的库，以可靠的方式执行此转换。您可以在https://github.com/asciidoctor/docbookrx#readme[README^]中阅读有关此倡议的更多信息。

这个工具最棒的地方在于所有积极使用它的用户，他们正在不断地测试这个工具的性能。这个工具处理的DocBook XML越高级，我们收到的反馈越多，这个工具就会变得越好。立即使用它，以摆脱XML的困境吧！

来自doxygen

Doxygen可以生成多种输出格式的文档。其中一种格式是(DocBook) XML。这意味着有一条从doxygen到AsciiDoc的路径，通过DocBookRx实现。

要启用此功能（默认关闭），请在Doxygen配置文件中将`GENERATE_DOCBOOK`标签设置为`YES`。启用后，Doxygen将生成捕捉代码结构的XML文件，包括所有文档。

要开始迁移，首先运行doxygen命令以生成DocBook XML输出。然后在XML文件上运行DocBookRx以生成AsciiDoc文件。现在您可以使用Asciidoctor将AsciiDoc文件转换为可消费的输出格式，例如HTML。

请注意，生成的AsciiDoc可能需要一些后处理。