The Divvun and Giellatekno teams build language technology aimed at minority and indigenous languages
This is a brief guide for using XMLMind XML Editor (XXE) to edit xml-based dictionaries.
To avoid unneccessary noise in our commits, it is important that we use identical settings for whitespace handling. Choose Preferences > Save, and make sure that the following settings are as in the picture below:
This is the basic setup to make things work good enough wrt our svn repository. Open a file and start editing (details below). When done, check in, and the commit will only contain your changes - no changes in the whitespace of the document.
| If you don’t have write access to the repository, you can instead [make a patch | http://ariejan.net/2007/07/03/how-to-create-and-apply-a-patch-with-subversion/] and send it to us. |
If you are going to do more substantial editing, it is very helpful to install the XXE configuration for our dictionaries. To do that, first add the following URL to the Install add-ons section in the XXE preferences (once). Then install the add-on.
http://divvun.no/static_files/list.xxe_addon
First click the Add… button:
Then paste the URL into the URL dialog:
The resulting preference pane should look like this:
Open the menu Options > Install Add-ons…, and click in the check box in front of the Giellatekno/Divvun dictionary configuration:
[images/xxe-update-dictconfig.png]
The two arrows in a circle in front of the check box indicates that there is an update available. If this is the first time you install the configuration, there are no such arrows there.
When done, click OK, and restart XXE.
You can do almost all editing using point and click (demo, including showing the xpath path).
But to work efficiently, you should switch to the keyboard. Here are the most important keyboard shortcuts:
Specific points:
The dictionary configuration automatically opens two views, one resembling a traditional dictionary article, and another with most elements on a line by itself. These are just views of the same underlying xml document, which means that changes in one view is immediately visible in the other. The same goes for selections.
It is also possible to open a third view (and a fourth, and fifth) to the right (or top / bottom) e.g. with the regular tree view, but that should normally not be necessary. Most, if not all, tree structure operations can be done without that view, by clicking on the appropriate places, or using command+up arrow.
Clicking the appropriate places means:
The official quickstart guide is available at the xmlmind site.
