OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [docbook-apps] Docbook v5.0 documents - best practices ?


Your code looks right to me, but I'm not an authority on the matter.

On 5/21/07, Fredrik Svensson <fred@ludd.ltu.se> wrote:
> Hi,
>
> I was looking into starting to make Docbook version 5.0 documents.
> Since I am starting a document from scratch I would like to get to know the
> recommended way, for the future. I guess that is using RNG and Xinclude.
>
> I started to look at how to start the document and the Howto[1] suggests
>
> <?xml version="1.0" encoding="utf-8"?>
> <article xmlns="http://docbook.org/ns/docbook"; version="5.0" xml:lang="en">
>   <title>Sample article</title>
>   <para>This is really very short article.</para>
> </article>
>
> while the TDG5[2] disuses :
>
> <?xml version='1.0'?>
> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V5.0//EN"
>                "http://www.oasis-open.org/docbook/xml/5.0/docbook.dtd";>
>
> There are also unexplained examples (The Document (or Root) Element)
> <book xmlns="http://docbook.org/ns/docbook";>…</book>
>
> Still is the version="5.0" needed ? recommended ?
>
> I am also interested in using several files[3] and I am a bit unsure how to
> start. From what I read this would be the way (the example does not contain
> the xml markup or version) ?
>
> book.xml
> ========
> <?xml version="1.0" encoding="utf-8"?>
> <book xmlns="http://docbook.org/ns/docbook"; version="5.0" xml:lang="en"
>       xmlns:xi="http://www.w3.org/2001/XInclude";>
> <title>My First Book</title>
> <xi:include href="chap1.xml"/>
> <xi:include href="appa.xml"/>
> </book>
>
> chap1.xml
> =========
> <?xml version="1.0" encoding="utf-8"?>
> <chapter xmlns="http://docbook.org/ns/docbook"; version="5.0" xml:lang="en">
> <title>My First Chapter</title>
> <para>My first paragraph.</para>
> …
>
>
> I understand that the documentation is under development. Still I am trying to
> set up an environment for Docbook 5 for the future, and I was looking for a
> best practices page..
>
> [1] http://www.docbook.org/docs/howto/
> [2] http://www.docbook.org/tdg5/en/html/ch02.html#ch02-makexml
> [3] http://www.docbook.org/tdg5/en/html/ch02.html#ch02-physdiv
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>


-- 
http://chris.chiasson.name/


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]