Harry Goldschmitt wrote:
> I'm documentation coordinator for the IPCop open source project 
> <http://www.ipcop.org>.  We write our documentation in DocBook XML. It's 
> been suggested that we recommend your XMLmind Personal Edition to our 
> authors.

Please take the time to read this: 
http://www.xmlmind.com/xmleditor/limitations.html

"XMLmind XML Editor (XXE) cannot be used to edit the physical structure 
of an XML document (entities, CDATA sections, marked sections)."

This implies that XMLmind XML Editor is generally *rejected* by authors 
used to write XML with text editors or with XML ``programmer's editors''.



> I've downloaded copies to my OSX, Windows and Linux machines and it 
> seems to fit the bill.  Unfortunately, I can't figure out how to easily 
> modify the catalog.xml, as required by IPCop.  It seems that the only 
> way to do this is with an xxe addon.  Is this right?  

Right.

* You don't need to modify the bundled catalog.xml. (Doing this would be 
hard to maintain for you)

* You need to customize the DocBook configuration to make it use your 
customized DocBook DTD (well, that's what I suppose).

* Then, optionally, you may want to package this custom 
configuration+DTD+catalog as an add-on.

An add-on is simply a zip file containing some files + an XML manifest. 
Creating such an add-on takes 5mn.



> If so, can you 
> point me to some doc on how to do this.
> 
> I realize I don't deserve support as a personal edition user, but use by 
> our dozen or so authors and our several dozen translators might get you 
> some pay for business.

No problem.

Rather than explaining how to do this (which is already explained here: 
http://www.xmlmind.com/xmleditor/_distrib/doc/configure/dtd_example.html 
and here: 
http://www.xmlmind.com/xmleditor/_distrib/doc/configure/customizing.html), 
I would prefer that you would point me to a Web page explaining to your 
authors what they need to produce in terms of DocBook documentation. 
After reading this Web page, I'll send you a ready-to-use add-on.




Reply via email to