MetaCombine Organization Editor

                                 version .1.1a

                                  2005-05-12

                                Stephen Ingram
                               Emory University


Overview
========

This software allows users to edit Organizations.  Organizations are XML
documents specifying a taxonomy of documents.  The sofware provides the ability
to rename, merge, and delete organization categories.

This software is part of the MetaCombine project, which seeks to  more
meaningfully bring together digital library resources, helping to build more
coherent services on top of them.  

See http://www.metacombine.org/ for more on MetaCombine.


Running
=======

You must first ensure that java of a version that is at least 1.4 is properly
installed on your system.  Next, decompress the scheme_editor.tar.gz file. It
should create a directory called scheme_editor.  In this directory there are
(among other things) two different scripts that allow the editor to be run, one
for Windows and one for Unix.

In windows you run the system by moving to the newly created scheme_editor
directory from the command line and type "scheme_editor.bat organization
basename" where organization is the name of your organization xml file and
basename is the basename of your metadata map files.

In Unix, move to the newly created scheme_editor directory and execute the
script "./scheme_editor.sh organization basename" where organization is the
name of your organization xml file and basename is the basename of your
metadata map files.


Instructions
============

There are two large white boxes that can contain trees.  At startup only the
box on the left contains a tree.  This tree represents your organization file.
The box on the right is the "scratch" box, an area similar to the "clipboard"
on the computer.  It is designed for holding temporary tree items. When you
output a tree from the editor, only the tree on the left is output.

The following instructions are organized by task.

1. To delete a category/item - Click on the category or item on the tree and
then click the "Delete Node" button.

2. To rename a category - Click on the category and its text should appear in
the text box at the bottom.  Change this text and then click the "Rename Node"
button.

3. To move a category - Click on the category you want to move and then click
on the "Move To >" button.  This moves the category and all its subcategories
and items from the main tree to the scratch box.  Now click on the category on
the main tree that you want to be the new parent of this category.  Then click
the "< Move From" button. This clears out the scratch box and moves the
category.

4. To merge two categories - Click on one of the categories you want to merge
and then click the "Move To >" button. This moves the category and all its
subcategories and items from the main tree to the scratch box.  Now click on
the category on the main tree that you want to merge with this category.  Then
click the "Merge" button.  This clears out the scratch box and merges the two
categories.

5. To output an XML file. - Click the "Save to XML" button and a standard file
box should open.  Enter the name and location of the XML file and click "Save".
This will write the contents of the organization to that file.


Building
========

IN WINDOWS: from the command line move to the decompressed root directory.
Then type "build.bat".

IN UNIX: move to the decompressed root directory and type "make".


License
=======

BSD.  See included "LICENSE" file.


Contact
=======

I can be contacted at singram@emory.edu.

Permanent contact: mhalber@emory.edu.

Stephen Ingram
Emory University
General Libraries

The MetaCombine Project