[[PageOutline]]

= 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] or via [http://echo.mpiwg-berlin.mpg.de/content/search ECHO Search]. In case the entry for the new images doesn't exist yet, you may want to search the digigroup's Filemaker database: Open filemaker -> Ablage -> Öffnen... -> Hosts -> Bibl.4 -> archiv_id (ask digigroup for login)

== 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.

== CHECK EVERYTHING ==
* Search for the author/title/year in [http://echo.mpiwg-berlin.mpg.de/content/search ECHO]
 * If links don't work (images are shown but not texts): Update links in [http://echo.mpiwg-berlin.mpg.de/content/manage ECHO/Zope] (ask XML-group for login)
  * Navigate to your resource
  * The link in the field "Link (if no ressourceID):" has to look like: {{{http://echo.mpiwg-berlin.mpg.de/ECHOdocuView?mode=texttool&url=/mpiwg/online/permanent/library/YHAK0YQ4}}}
  * The link in the field "MetaLink (if no ressource ID):" hast to look like: {{{http://content.mpiwg-berlin.mpg.de/mpiwg/online/permanent/library/YHAK0YQ4/index.meta}}}
 * The same has to be repeated for every collection your item is part of!
* Perform the same search in [http://141.14.236.36/fmi/xsl/katalog/findrecords.xsl?-db=katalog&-grammar=fmresultset&-view= the library catalogue]
 * Update links in biblio, if necessary.
* Check again.

= Preserving the old version =
Although this doubles the entries of some books, the decision was made to keep a version with the old images and the old XML text, as well. The images are kept in the {{{permanent/archimedes}}} folder.

 * Copy the respective XML document from your working copy of [source:/trunk/texts/eXist/archimedes/@2709] (this version is similar to the one in the Old CVS, but has the DTD fragment resolved) to the appropriate language folder in [source:/trunk/texts/eXist/archimedes], but insert an {{{_old}}} before the {{{.xml}}} prefix.
 * Open the {{{_old}}} version in an editor:
  * Insert the following line before the {{{</info>}}}-line (adjust {{{$directory}}} here to the corresponding directory of the xml file on the Foxridge):
{{{
<echodir>/permanent/archimedes/large/$directory</echodir>
}}}
  * Also in the {{{<info>}}}-Tag: change the {{{<title>}}} by adding (insert the actual number of pages)
{{{
, old version (xxx pages)
}}}
  * Save the document and upload it as documented in the section above.
 * Mount the Foxridge server and go to the corresponding directory of the XML text in {{{/Volumes/online_permanent/archimedes_repository/large/}}}
 * Open the {{{index.meta}}} in an editor
  * Change the {{{<title>}}} in the same way as above
  * In the {{{<texttool>}}} tag, add {{{_old}}} to the file in the {{{<text-url-path>}}} beforeht {{{.xml}}} prefix.
  * Save the changes
 * Open {{{info.xml}}} in the {{{presentation}}} directory in an editor
  * Edit the {{{<title>}}} as above and save the document.
 * Upload the file as usual

= To Be Updated =

Archimedes (images + text)
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuView?mode=texttool&url=/mpiwg/online/permanent/library/A41S4WF7&viewMode=text_dict Guidobaldo del Monte 1577] DONE
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuView?mode=texttool&url=/mpiwg/online/permanent/library/YHAK0YQ4&pn=7 Casati 1684] DONE
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuView?mode=texttool&url=/mpiwg/online/permanent/library/TPQ025WW&pn=5 Varro 1584] DONE
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuView?mode=texttool&url=/mpiwg/online/permanent/library/MT7GMZYT&pn=2 Baldi 1621] DONE
 * neue Bilder noch nicht in biblio verzeichnet!
* Agricola 1556 [http://echo.mpiwg-berlin.mpg.de/content/historymechanics/archimdesecho/agric_remet_001_la_1556 Alte Bilder];
 * neue Bilder: Foxridge -> online_permanent -> library -> 5CTEBAHQ
 * Problem: Eclipse hängt sich auf, wenn man das XML-file zu öffnen versucht.

ECHO & Archimedes (images)
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuView?mode=imagepath&url=/mpiwg/online/permanent/library/419CK1VT/pageimg&pn=9 Guldin 1635-1641] DONE
* [http://echo.mpiwg-berlin.mpg.de/ECHOdocuView?mode=imagepath&url=/mpiwg/online/permanent/library/WMMA0T8W/pageimg&pn=7 Delamarche 1800] DONE

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 Bescheid sagen; siehe oben!)
 * neue Bilder: Foxridge -> online_permanent -> library -> TG3ZW27M