Site Administration - ahankinson/imageserve GitHub Wiki

The administration site can be accessed at https://images.rasi.mcgill.ca/admin/.

Login

If you have not already logged in, accessing the admin site will prompt you to do so. Enter your username and password. Click "Log in".

Administration Home

Administration homepage image

Each of the links on this page is detailed in a separate subsection below.

Manuscripts

The entries on this page correspond to the various manuscripts available to view. Clicking one will take you to a page where you can view and change the configuration of some of the ISMI data for that specific manuscript.

Editing a manuscript when no ISMI ID has been specified

New manuscript page image

The first time you edit a manuscript, you will see only a field for its ISMI ID. This should be the unique ID number of the CODEX object in the ISMI database that the manuscript in question corresponds to. Once you enter a valid ID in this space and click "Save", the webapp will look up all the witnesses in the specified codex, so that the next time you visit the administration page for the manuscript, you will see the various witness and be prompted to choose the page ranges they occur on.

Editing manuscripts for which an ISMI ID has been chosen

Edit manuscript page image

Note that these page ranges are really the indexes of images in the manuscript, not folio numbers or any other conventional page numbering system. As a result, these numbers are likely to be completely wrong, and it is best to just input some random non-overlapping page ranges the first time. The easiest way to ensure that these page ranges are accurate is to use the Edit page numbers function in the Viewer page for the manuscript you wish to correct.

Att & Rel display settings

Display settings page image

The entries on each of these pages corresponds to an attribute or relation in the ISMI database (For a sense of what is meant by "attribute" and "relation", see https://it-dev.mpiwg-berlin.mpg.de/tracs/OpenMind3/wiki/IsmiDataModel). These pages allow you to control what gets displayed when the metadata window is accessed from a viewer page. When you select an entry, you have a few options to customize:

Changing a display setting page image

Show id (for relations only): Every entity in the ISMI database has its own unique ID number. When you view the metadata for a witness, some of the rows in the metadata table have information about other entities in the ISMI database to which the witness is related; if you check this box for the relation specified, the ID of the object to which the witness is related will also be displayed (This is really more for "experts" -- if you are directly manipulating objects in the database and want a quick way to access their details without looking them up).
Display name: this is the text that will be shown in the left-hand column of the metadata table in the row corresponding to the chosen attribute/relation. Most of the time this is just the variable name used in the ISMI database, and it is not terribly legible or descriptive (all lowercase letters, words separated by underscores). It may be useful to change the display names of attributes to more readable forms.
Show: This setting controls the circumstances under which the data for the chosen attribute/relation will appear in the metadata table. If "Always show" is selected, a row for this data will always appear, even if the chosen attribute/relation does not exist on the witness being viewed. "Show if set" should be selected if you want a row in the metadata table to appear only when the attribute/relation actually exists on the witness being viewed. Some of the fields in the ISMI database are useless or redundant for the use cases of the RASI image viewer project, so you can exclude them from all metadata displays by choosing "Never show".