EditXdocs - Velocity Wiki

Editing xdocs by hand is a painful experience. You can use the XMLMind XML editor to edit xdocs visually by installing the xdocs configuration.

Install XMLMind from XMLMind Editor page. It is written in Java and runs on all major OS brands.
Download the attached XMLMind XDOC add-on. Unpack it into the XMLMind Editor user add-on directory. The preferences directory is
- $HOME/.xxe/addon/ on Unix,
- %SystemDrive%\Documents and Settings\%USERNAME%\Application Data\XMLmind\XMLeditor\addon\ on Windows 2000/XP,
- %SystemDrive%\winnt\Profiles\%USERNAME%\Application Data\XMLmind\XMLeditor\addon\ on Windows NT.
Restart the Editor. Select File -> New. It should offer you "XDOC / Empty Doc". If yes, congratulations. It works.

To be able to automatically select XDOC for xdocs, add the following (preliminary!) DOCTYPE to your xdoc files:

<!DOCTYPE document PUBLIC "-//Apache Software Foundation//DTD XDOC 1.0//EN"
                          "http://www.apache.org/dtds/xdoc_1_0.dtd">

The xdoc add-on also recognizes the maven xdocs identifier

<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN">

Enjoy. This is how it should look like: | Editing a XDOC File with XMLMind

It should be possible to set this add-on for automatic installation using the add-on Manager in XMLMind.
It shouldn't be too hard to create a DTD from the XSD for the navigation.xml page and also add a CSS file for this.
- However, the "Standard" Edition of the XMLMind editor restricts the XSD usage to just a few schemas. So it would be necessary to convert the navigation.xsd from the maven-xdoc plugin into a DTD first.