Kevin, et al.,
For your information, I've had a lot of success with putting together
and using XXE configurations for editing composite documents like
this, so I don't think you should have too many problems. Both the
Relax NG and the DocBook 5 Relax NG schemas are designed to be highly
extensible, which is a big plus. You could easily import a targeted
subset of DocBook 5, for instance, and you can have a field day coming
up with different CSS views for varying tastes and uses.
Take care,
John L. Clark
On Thu, Jun 26, 2008 at 9:06 AM, Kevin Flynn <kevin at escenic.com> wrote:
> Hussein Shafie wrote:
>
> Kevin Flynn wrote:
>
> I need to add documentation to some RNG schemas. The standard method of
> doing this appears to be to use the annotations namespace's documentation
> element. However, this only allows plain text (no child elements), which
> means no formatting of the documentation text. So I am considering using
> docbook elements instead - the Relax NG specification seems to allow this, I
> think.
>
> I have experimented a little with XmlMind:
>
> - added the docbook namespace to an RNG file
> - added some documentation using docbook elements
> - opened the file in XmlMind
>
> and the result validates. However, if I write some invalid docbook, or
> remove the docbook namespace declaration, it still validates. Not too
> surprising, since there is nothing to tell XmlMind where to look for the
> docbook schema. Validation of RNG files in XmlMind appears to be "built in"
> - the addons folder contains no config for RNG. Consequently there is
> nowhere for me to add a reference to the docbook schema.
>
> Is there a way to do what I want to do with XmlMind? Or (supplementary
> question) is what I'm trying to do actually not allowed by the RNG schema
> or maybe just really stupid?
>
> Hope you can enlighten me a little here...
>
>
> --> You need to create a configuration for RNG schemas + DocBook 5
> documentation.
>
> We have created such configuration for W3C XML Schema + XHTML (*styled*)
> documentation so it's feasible. You can use the "W3C XML Schema
> configuration" add-on as an example. See attached screen shot.
>
>
>
> --> In order to do this, you need a copy of the RELAX NG Schema for RELAX
> NG. This schema is public and normalized:
> http://relaxng.org/spec-20011203.html (I've attached a copy to this email).
>
> This schema allows RELAX NG patterns to contain ``alien elements''. Your
> DocBook 5 documentation elements are such ``alien elements''.
>
> In itself, the RELAX NG Schema for RELAX NG does not validate the contents
> of alien elements. It merely allows you to insert them at certain places.
>
> Therefore your configuration should not be based on the stock RELAX NG
> Schema for RELAX NG but on a variant importing the DocBook 5 RELAX NG
> schema.
>
> Normally creating such composite schema is simple, clean and elegant (we did
> that successfully for DocBook 5+MathML) but how to do it is out of the scope
> of this mailing list.
>
>
>
> --> Recommended reading: "RELAX NG" by Eric van der Vlist --
> http://oreilly.com/catalog/9780596004217/
>
> http://books.xmlschemata.org/relaxng/
>
> ________________________________
>
> Wonderful, excellent answer, thanks a lot!
>
>> how to do it is out of the scope of this mailing list.
>
> Yes of course - I just wanted to know that it's possible and that XmlMind
> will handle it. I'll figure the rest out.
>
> Thanks again
>
> Kevin Flynn
>
>
>
> --
> XMLmind XML Editor Support List
> xmleditor-support at xmlmind.com
> http://www.xmlmind.com/mailman/listinfo/xmleditor-support
>
>
--
PLEASE NOTE that this message is not digitally signed. As a result,
you have no strong evidence that this message was actually sent by me.
Upon request I can provide a digitally signed receipt for this message
or other evidence validating its contents if you need such evidence.
