User Manual
The aim of the IIIF Manifest Editor is to reduce the guess work and pure JSON editing when creating and/or manipulating manifests. It features a simple and easy-to-use interface with forms to edit the JSON value-pairs and drag-and-drop of images/canvases to facilitate the ordering and editing of the manifest without JSON knowledge. It will let you validate and download the created/modified IIIF manifest.
See installation instructions of the README file on Github: https://github.com/bodleian/iiif-manifest-editor/
The start page of the application allows you to choose between creating a new manifest from scratch or open an existing manifest. Click on the "Open Manifest" button:
To load a remote manifest, insert the URL for the remote manifest to load and click on the "Open" button.
Alternatively, click on the "Choose File" button in the "From Computer" form field, this will let you choose a local file from your computer. Select a IIIF manifest (JSON) file from your computer and click on the "Open" button:
You can also drag & drop a manifest file onto the gray area to load it.
Once the remote or local manifest is loaded you will see the "Edit Manifest" page:
The "Edit Manifest" page contains the following main sections:
- Main viewer (top left): view, zoom and pan current canvas, navigate through sequence, toggle metadata sidebar
- Thumbnail strip (bottom left): view canvases and navigate through sequence. Drag canvases to reorder sequence
- Action buttons (top right): create new manifest, open another manifest, download and validate current manifest (save) and close current manifest, import canvases from other manifests
- Metadata sidebar: view and edit manifest metadata. Add, remove and edit metadata for the manifest level, the sequence level and the canvas level
- Bulk Actions: Bulk rename canvases in the current sequence
The "Manifest Metadata" panel has two tabs:
- Predefined fields and
- Custom fields
Predefined fields are top-level manifest metadata properties such as label, description, attribution etc. To remove a property, click on the "x" button to the right of each property box. To add a property, click on the "Add metadata field" button. This will open a drop-down menu that lets you choose from a number of predefined fields. Only fields that are not yet added to the current manifest will be available for selection. Editable fields have a "pencil" icon. Click on the field value to edit it.
Custom fields are value/label pairs that will be stored in the "metadata" section of the manifest. Click the "Add metadata field button" to add a custom field. This will add a new box with "Label" for the label of the new property and "Value" for the value:
To edit the label, click on it, replace the default text of "Label" with the name for the metadata field (e.g. "Date") and hit enter:
Do the same for the value field:
The Sequence Metadata panel let's you edit the label for the current sequence and set the viewing direction for the manifest. Use the drop-down menu to toggle between left-to-right and right-to-left. The selected viewing direction will be added to the manifest level viewingDirection property. You can also edit this in the Manifest Metadata panel directly. If right-to-left has been selected, the canvases in the thumbnail strip will be displayed in reverse order. This setting only affects the display of the canvases in the thumbnail strip and does not actually reverse the order of the canvases in the manifest itself.
The Canvas Metadata panel shows the metadata for the selected canvas. You can edit the canvas label, the width and the height of the canvas and the image URI for the image that is annotated to the selected canvas:
Empty canvases will show a "Add Image to Canvas" button underneath the thumbnail of the canvas, if the canvas already has an image annotation the button will say "Replace Image on Canvas". Clicking this button will open a modal window that let's you add or replace an image using either an image URI, an info.json URI or an existing image annotation:
Click on the "Help" link on the top right of the modal window to learn more about each of the 3 options.
In the Bulk Actions panel you can rename all canvases of the current sequence at the click of a button. Canvases can be renamed by pagination or by foliation. A drop-down menu for each button lets you select a canvas from which to start the bulk renaming process (default is the first canvas of the sequence). When renaming by foliation, you can choose whether to start with a recto or a verso page:
The thumbnail strip at the bottom of the viewer shows the current sequence. Click on a thumbnail to select the canvas and display it in the viewer as well as its metadata in the Canvas Metadata panel. A canvas can be deleted by clicking the trash icon on the top left of each canvas. Use Shift + click to select multiple (adjacent) canvases and delete all at once:
Clicking the icon on the top right of each canvas reveals a context menu that let's you:
- add an empty canvas to the left of the current canvas
- add an empty canvas to the right of the current canvas
- duplicate the current canvas
- go to "Import Canvases" view (see below)
At the right end of the sequence there is an "Add Canvas" button which let's you add a canvas to the end of the sequence. Use the Canvas Metadata panel to add an image to an empty canvas using the "Add Image to Canvas" button.
Drag and drop a canvas within the thumbnail strip to change its location within the sequence.
To go to the "Import Canvases" view you can use the context menu on each canvas or the "Manifest Actions" drop-down menu on the top right of the metadata sidebar. Instead of the main viewer you will see a button to open a sequence from a remote manifest:
Enter a URI for the remote manifest you would like to load. You can open as many remote manifests next to each other as you like. The view is horizontally scrollable. Click the "x" button on the top right of each sequence to remove a sequence.
The displayed sequences on the top will act as "source" manifests. The sequence in the thumbnail strip on the bottom is the "target" manifest (the one you are editing). To add a canvas from a source manifest to the target manifest simply drag & drop the canvas from the source to the target (i.e. from one of the vertically displayed sequences on the top to the horizontally displayed sequence on the bottom). Shift + click to select multiple (adjacent) canvases from a source manifest and drag them to the target to add multiple canvases at once.
Click the "i" icon on the top left of each source manifest to view the source manifest metadata:
Use the "Save Manifest" button on the top left of the metadata sidebar to download the created / edited manifest. A dialog will let you choose a name for your manifest and you can validate it before downloading it:
To create a new manifest from scratch instead of editing an exiting one, select the "New Manifest" option from the "Manifest Actions" drop-down menu on the top right of the metadata sidebar. You will be prompted if you would like to proceed or cancel and download your modified manifest first. After confirming, you will be presented with an empty "skeleton" manifest without any canvases plus some placeholder metadata.
Edit the metadata for the new manifest in the metadata sidebar by clicking on the placeholder text or adding a new metadata field. Add a new canvas by clicking on the "Add Canvas" button in the thumbnail strip. This will add an empty canvas that can then be updated with a label or image annotation in the Canvas Metadata of the sidebar.