Docbook: Как создать статью с частями

Question

Мне нужно создать документ "Условия использования", который состоит из трех частей... и я попытался создать такую ​​статью:

<!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

Вы не можете на самом деле создать DocBook article который содержит part элемент. В DocBook, part это разделение вbook, Я думаю, что вы хотите здесь вместо этого просто section стихия

Конечно, вы можете называть свои разделы первой частью и т. Д., И концептуально просто думать о них как о "частях" - но в DocBook, то, что на самом деле имеет специальное название part это то, что ограничено моделированием только частей книги, и section это вещь для моделирования частей (и подразделов, рекурсивно) статьи или главы в книге.