Docbook：如何创建包含部分的文章

Question

我需要创建一个由三部分组成的 "Terms of Use" 文档...我已经尝试创建这样的文章：

<!DOCTYPE article [
  ...
]>
<article xmlns="http://docbook.org/ns/docbook" version="5.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://docbook.org/ns/docbook http://docbook.org/xml/5.0/xsd/docbook.xsd"
  xmlns:xi="http://www.w3.org/2001/XInclude"
  xml:lang="en-US"
  xml:id="terms-of-use">
<info>
  <title>Terms of Use</title>
  <copyright>
    <year>2015</year>
    <holder>My Company, Inc.</holder>
  </copyright>
  <legalnotice>blah blah blah</legalnotice>
  <date>October 16, 2015</date>
  <releaseinfo>1.0</releaseinfo>
</info>
<part label="I">
  <title>Title Part One</title>
  <xi:include href="part-1/file-1.xml"/>
  <xi:include href="part-1/file-1.xml"/>
  <xi:include href="part-1/file-N.xml"/>
</part>
<part label="II">
  <title>Title Part Two</title>
  <xi:include href="part-2/file-1.xml"/>
  <xi:include href="part-2/file-1.xml"/>
  <xi:include href="part-2/file-N.xml"/>
</part>
</article>

上面的文档不起作用，因为我猜它不符合架构...是否有任何有用的示例说明如何创建包含部分的文章？

Answer 1

您实际上无法创建包含 part 元素的 DocBook article。在 DocBook 中，a part is a division in a book. I think what you want here instead is just the section element.

您当然可以将您的部分命名为 第一部分 等，并且在概念上将它们视为“部分”——但在 DocBook 中，实际给出的是特殊名称 part 仅限于对一本书的部分建模，而 section 是对文章或章节的部分（和子部分，递归地）建模的东西一本书。

Docbook：如何创建包含部分的文章

Docbook: How to create an article with parts

docbook

docbook-5