Hi,

I'm currently in the process of moving our documentation source to  
Docbook XML, and I find that we've got some domain-specific data that  
we can't easily represent using the Docbook schema - in particular,  
we need the ability to capture nested directory structures in our  
documentation.

So, what I've done is written an XML Schema for a new namespace (call  
it "tt"), containing the additional elements, and I embed these in a  
Docbook XML document like so:

<para>
   <tt:filesystem xmlns:tt="http://www.transitive.com/transitive";>
     <tt:directory name="/">
       <tt:directory name="var">
         <tt:directory name="accounts">
           <tt:desc>The Solaris application "ReconcileAccounts" needs  
to alter files in <filename>/var/accounts/</filename></tt:desc>
         </tt:directory>
       </tt:directory>
       <tt:directory name="usr" />
     </tt:directory>
   </tt:filesystem>
</para>

I've had have no problem in using the XSLT transforms to generate  
sensible PDF and HTML output from these new tags, but I'm having  
trouble coming up with a way for XMLMind to play nicely with this  
arrangement - ideally, I want anyone editing a DocBook XML document  
in XMLMind to be able to see elements like "tt:filesystem" in the  
list when they choose to insert new elements into the document.

How could I go about doing this?  The number of options seems pretty  
vast:

- Use the DocBoox DTD, or XML Schema, or the RELAX NG Schema
- Modify those namespaces, or write my own (with the definition in  
whatever format)
- Define a new namespace that references the DocBook one and extends  
it, or reference my new namespace from within DocBook.

I can't imagine that I'm the first person to try and achieve this -  
before I head off and find the wrong way of doing this, does anyone  
have any experiences they could share?

Thanks,
Geraint North

Reply via email to