是否可以将文档 "article" 包含到 "book" 中？

Question

从 docbook 到 PDF 的生成有问题。

我需要基于多个 docbook-xml 生成一个 PDF。其中一些 XML 是手动编写的（如下面的摘录 "book.xml" 所示），其中一些是由 OxygenXML 生成的（下面的第二个摘录）。后者是 XSD-schemata 使用 OxygenXML 转移到 docbook 中。由于 Oxygen 在这里没有选项，它总是生成一个文档 "article"。

包含这些文章的文件是文档"book"。但是，包含会产生错误：第一个错误表明：

element "article" from namespace "http://docbook.org/ns/docbook" 
not allowed in this context

我的book.xml:

<?xml version="1.0" encoding="utf-8"?>
<book version="5.1" xml:lang="en" xmlns="http://docbook.org/ns/docbook"
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:xlink2="http://www.w3.org/1999/xlink"
  xmlns:xlink="http://www.w3.org/1999/xhtml"
  xmlns:xi="http://www.w3.org/2001/XInclude"
  xmlns:ns6="http://www.w3.org/2000/svg"
  xmlns:ns5="http://www.w3.org/1998/Math/MathML"
  xmlns:ns2="http://docbook.org/ns/transclusion"
  xmlns:ns="http://docbook.org/ns/docbook">

<title>xyz</title>

<chapter>
  <title>my xsd previously rendered by oxygen</title>
  <xi:include href="generated_schemata/my_xsd.xml"/>
</chapter>
...

和生成的开头my_xsd.xml：

<?xml version="1.0" encoding="UTF-8"?>
<?oxygen RNGSchema="http://www.oasis-open.org/docbook/xml/5.0/rng/docbook.rng" type="xml"?>
<!--XML Schema documentation generated by <oXygen/> XML Developer.-->
<article version="5.0" xmlns="http://docbook.org/ns/docbook"
     xmlns:ns5="http://www.w3.org/1998/Math/MathML"
     xmlns:ns4="http://www.w3.org/1999/xhtml"
     xmlns:ns3="http://www.w3.org/2000/svg"
     xmlns:ns2="http://www.w3.org/1999/xlink"
     xmlns:ns="http://docbook.org/ns/docbook">
  <title>Schema documentation for ServiceCatalogue.xsd</title>

  <info>
    <pubdate>february 20, 2018</pubdate>
  </info>

  <section>
    <title>Namespace: ""</title>
...

问题：有什么方法可以将 docbook "article" 包含到 "book"（或其他一些结构中，所以最后我得到一个 PDF）？

我使用的工具是maven和docbkx-plugin。

Answer 1

您的代码片段中的问题是您在 chapter 中包含 (XInclude) 文章 - 而不是在 book 本身中。这是 DocBook 模式不允许的（article 不能在 chapter 内）

即：

book < article（或 set < article）；
但是这个（在你的样本中）：book < chapter <article 不是

你只是因为 xinclude 语句而没有看到全貌。

所以解决方法是（比较这两个片段）：

你的：

<book version="5.1" ...>
...
<title>xyz</title>

<chapter>
   <title>my xsd previously rendered by oxygen</title>
   <xi:include href="generated_schemata/my_xsd.xml"/>
</chapter>
</book>

正确的是：

<book version="5.1"...>
...
<title>xyz</title>

<xi:include href="generated_schemata/my_xsd.xml"/>

</book>

注意：您对书籍 (5.1) 和文章 (5.0) 进行了不同的架构验证）！请注意！

是否可以将文档 "article" 包含到 "book" 中？

Is it possible to include a docbook "article" into a "book"?

maven

plugins

docbook

oxygenxml