Open Stack

Btw., here's the answer to our question about using arbitrary elements
as the root of DocBook docs. The DocBook TC agrees with our opinion and
this will be fixed in DocBook 5.1.

Regards,
david


-------- Original Message --------
Subject: Re: [docbook] Allowing arbitrary elements as the root of a
DocBook document
Date: Mon, 26 Aug 2013 09:03:48 -0700
From: Bob Stayton <bobs at sagehill.net>
To: David Cramer <david at thingbag.net>, <docbook at lists.oasis-open.org>

This problem was recognized after DocBook 5.0 was released.
DocBook 5.1 will liberalize this policy and allow just about any element to
be the root element.

Bob Stayton
Sagehill Enterprises
bobs at sagehill.net

--------------------------------------------------
From: "David Cramer" <david at thingbag.net>
Sent: Monday, August 26, 2013 8:02 AM
To: <docbook at lists.oasis-open.org>
Subject: [docbook] Allowing arbitrary elements as the root of a DocBook
document

> Users sometimes want to create DocBook documents such that some
> arbitrary element is the root (e.g. <table>) and then xinclude that file
> into a larger doc more than one time. The motivation is to avoid the
> need to put an id on the element but still be able to refer to it from
> an xi:include. The hitch is that if they validate this standalone file
> against the DocBook schema, it's not valid because it doesn't have book,
> chapter, section, etc as a root element. I've customized the schema in
> the past and am about to do that again, but it makes me wonder, what is
> the rational for only allowing a few elements to be the root of a
> DocBook document. If I want to create a DocBook document that has
> <table> or even <phrase> as its root element, why shouldn't it be
> considered valid?
>
> Regards,
> David
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe at lists.oasis-open.org
> For additional commands, e-mail: docbook-help at lists.oasis-open.org
>
>
> 

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe at lists.oasis-open.org
For additional commands, e-mail: docbook-help at lists.oasis-open.org