Docbook:如何使用部件创建文章

时间:2015-10-10 00:25:23

标签: docbook docbook-5

我需要创建一个"使用条款"文档由三部分组成......我试图创建这样的文章:

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

上面的文档不起作用,因为我认为它不符合架构......是否有任何有用的示例说明如何创建包含零件的文章?

1 个答案:

答案 0 :(得分:2)

您实际上无法创建包含article元素的DocBook part。在DocBook中,a part is a division in a book。我认为你想要的只是the section element

您当然可以将您的部分标题为第一部分等,并在概念上将其视为“部分” - 但在DocBook中,实际上赋予了特殊名称{{1这是一个仅限于对书的各个部分进行建模的事情,而part是用于对文章或书中章节的部分(以及子部分,递归)进行建模的事情。