= Situation =
You want to update XML files in ECHO because new images are available (e.g. a book has been digitized by the MPIWG library & these images are to replace older images that are not owned by the library).

NB: These instructions do not apply to MPDL project texts, for example Wilkins 1684. In these texts, the explicit file name of the JPG is given in an attribute of <pb>. And at least in the next few months, the texts in [source:trunk/texts/eXist/echo] can (and will) be overwritten without warning, i.e. all changes will be lost. As an interim solution, please notify Klaus if changes have to be made.

== Images ==
Both new and old images are online on Foxridge, subdivision online_permanent
* old image files: archimedes_repository -> large -> [image-folder-old]
* new image files: library -> [image-folder-new]
The names of the image folders can be looked up in the [http://141.14.236.36/fmi/xsl/katalog/findrecords.xsl?-db=katalog&-grammar=fmresultset&-view= library catalogue].

== XML files ==
ECHO XML files are stored in two places.
* Subversioning file system: https://it-dev.mpiwg-berlin.mpg.de/svn/mpdl-project-content/trunk/texts/eXist/
* The (further processed) files that ECHO uses for display: https://it-dev.mpiwg-berlin.mpg.de/tracs/mpdl-project-content/browser/trunk/texts/eXist/

= Workflow =

We are currently using oXygen to edit and to version the XML files.

== Download current version ==
* Open oXygen
* Choose: Tools -> SVN Client
* Click the "Repository check-out"-icon in the upper left corner
* Insert Repository URL: https://it-dev.mpiwg-berlin.mpg.de/svn/mpdl-project-content/trunk/texts/eXist/archimedes/ (or the URL to whichever folder your file is stored in)
* Select an empty folder on your machine as target folder
* Chose Revision: HEAD (= newest version)
* Click OK, and wait for files to download

== Edit file ==
* Open the file you want to edit from the downloaded files
* Insert into <info> the element <echodir> containing the path to the new images, e.g. <echodir>/permanent/library/A41S4WF7/</echodir>
* Insert in the appropriate places as many <pb/> elements as necessary (usually at the beginning and end of the book)

== Upload new version (to SVN) ==
* In the SVN Client, chose "Check in all" (4th item on top from left)

== Update index.meta ==
* Copy index.meta from the new images folder to your machine
* Open it with oXygen (or any other text editor)
* Insert into <bib>
{{{
<texttool>
        <image>pageimg</image>
        <figures>figures</figures>
        <text-url-path>/[path-to-file]/[name-of-file].xml</text-url-path>
</texttool>
}}}
Example for text-url-path: /archimedes/la/casat_mecha_017_la_1684.xml
* Copy the updated image.meta back into the new images folder

== Copy the folder of figures ==
* Copy the "xxx-xx-figures" folder from archimedes to the corresponding folder in library
* Rename the folder to "figures"

== Upload new version (for ECHO display) ==
* [Activate your eXist account: http://mpdl-proto.mpiwg-berlin.mpg.de/mpdl/doc/index.html ]
* Login to eXist: http://mpdl-proto.mpiwg-berlin.mpg.de/mpdl/doc/login-exist.xql 
* Chose the file to upload from your local machine
* Chose Document base: Archimedes (in this case)
* Chose language appropriately
* Execute
* To check if the upload was successful, you may have to reload the result page before you see the link to the uploaded file in an ECHO viewer. -> '''Das Bilder-Anzeige-Problem?'''
= To Be Updated =
Archimedes (images + text)
* Guidobaldo del Monte 1577 DONE
* Casati 1684 DONE
* Varro 1584 DONE
* Agricola 1556
ECHO & Archimdes (images)
* Guldin 1635-1641 Wird gescannt. Kein XML
* Delamarche 1800 Kein XML
ECHO (images + text) 
* Wilkins 1684 XML: [https://it-dev.mpiwg-berlin.mpg.de/svn/mpdl-project-content/trunk/texts/eXist/echo/en/Wilkins_1684_EEU2MA1B.xml bisher nur in SVN] (Bitte diesen Text nicht direkt ändern, sondern Klaus bescheidsagen; siehe oben!)