wiki:workflow_img-xml

Version 15 (modified by Klaus Thoden, 14 years ago) (diff)

--

  1. Situation
    1. Images
    2. XML files
  2. Workflow
    1. Download current version
    2. Edit file
    3. Upload new version (to SVN)
    4. Update index.meta
    5. Copy the folder of figures
    6. Upload new version (for ECHO display)
    7. CHECK EVERYTHING
  3. Preserving the old version
  4. To Be Updated

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 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 ​library catalogue or via ​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.

Workflow

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

Download current version

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)

CHECK EVERYTHING

  • Search for the author/title/year in ​ECHO
    • If links don't work (images are shown but not texts): Update links in ​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 ​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 trunk/texts/eXist/archimedesOldCVSRepository/archimedes/xml/ to the appropriate language folder in trunk/texts/eXist/archimedes, but insert an _old-withdtd before the .xml prefix.
  • The DTD fragment has to be resolved.
    • You need the xmllint-tool, which is part of libxml2, as well as the archimedes.dtd, which you can download ​here (NB you need the whole directory, a zipped version as of September 2010 is attached to this page).
    • On the command-line, resolve the DTD with the following command (adjust the path to the dtd-folder and the name of the xml-file): 
      xmllint --dropdtd --loaddtd dtd/archimedes.dtd --noent text_old-withdtd.xml > text_old.xml
  • Delete the _old-withdtd version and 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.

To Be Updated

Archimedes (images + text)

ECHO & Archimedes (images)

ECHO (images + text)

  • Wilkins 1684 XML: ​bisher nur in SVN (Bitte diesen Text nicht direkt ändern, sondern Klaus Bescheid sagen; siehe oben!)
    • neue Bilder: Foxridge -> online_permanent -> library -> TG3ZW27M

Attachments (1)

Download all attachments as: .zip