/ / Docbook: Como criar um artigo com partes - docbook, docbook-5

Docbook: Como criar um artigo com partes - docbook, docbook-5

Eu preciso criar um documento "Termos de Uso" que consiste em três partes ... e eu tentei criar um artigo como este:

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

O documento acima não funciona porque eu acho que ele não está de acordo com o esquema ... Existe algum exemplo útil que mostra como criar um artigo com partes?

Respostas:

2 para resposta № 1

Você não pode criar um DocBook article que contém um part elemento. No DocBook, uma part é uma divisão em um book. Eu acho que o que você quer aqui é apenas a section elemento.

Você pode, naturalmente, intitular suas seções como Parte um, etc., e conceitualmente, pense nelas como "partes" - mas no DocBook, a coisa que realmente recebe o nome especial part é uma coisa que é restrita a modelar apenas as partes de um livro, e section é uma coisa para modelar as partes (e sub-partes, recursivamente) de um artigo ou de um capítulo de um livro.