Guidance for basic features of the test environment

The future manuscript portal is currently under development (see our release notes, German only). Only a small part of the required features have yet been implemented.

Here you can find a list of current limitations. The future manuscript portal will be more intuitive to use than the test environment is at the moment.

Below we present main functionalities that have already been developed:

Search

Search for manuscripts by content

Depending on your prior knowledge and research question, you can conduct your search for manuscripts in relation to their content in a number of different ways.

  1. The search box that appears at the centre of the homepage (and also in the top bar) has an input field (search slot).
  2. Enter your search term in the search slot in any form and variation. 
    • The search engine is able to work with imprecise searches.
    • Leaving an empty search slot or entering an asterisk (*) performs an empty search and allows the user to view all of the manuscripts stored in the system.
    • To search for a phrase with a specific order of words, place the phrase in quotation marks (“…”).
  3. Press ‘enter’ or click on ‘search’.
  4. The search results will be displayed as a list, grouped by manuscript and sorted by relevance. 
  5. For more precise information on the context of each search result, click on the grey area or on the little arrow just below the result.
  6. Click on the manuscript’s shelfmark to access the overview page.
  1. Select the relevant field from the drop-down menu in the search box to the left of the search slot.
    • ‘All’: default setting that searches all fields and the full text.
    • ‘Shelfmark’, ‘Place of origin, ‘Language’: Only the selected option is searched.
  2. Enter a search term and click on ‘search’.
  1. Perform a text search to refine the list of results as much as possible.
  2. Click on ‘filters’ at the top centre of the list to view the filter options.
  3. The filters available can be used in various ways.
    • Multiple selection: Selecting one or multiple suitable options applies the values as OR conditions, so results will contain at least one of the options.
    • Sliders: Use sliders to define search range. The filter “date of origin” includes the checkbox ‘exclusively period within range’. If this checkbox is activated, it will exclude the results where only either the start or end date lie within the selected range.
    • Whenever the option ‘empty’ is enabled it displays results for which the information of that filter is not available.
  4. The total number of filtered results can be seen in the top right corner. Click the number to apply the filters.
    • Clicking ‘X’ in the top right corner closes the tab without applying the filters and discards any changes.
    • Click ‘filter’ at the bottom to temporarily close the filter tab. Opening and closing the filter tab has no effect on the list of results.
  5. The active filters are displayed at the top of the list of results where they can also be removed.
  1. Perform either an empty search or a text search.
  2. Open the filter tab in the list of results.
    • All of the filter options shown are based on the current results found during the search. Options not available in this dataset are not displayed.
    • The number of results is displayed after each filter option.
    • The number of datasets in which the corresponding information is not available is displayed after the ‘empty’ option.
    • The total number of results for the selected filter settings is indicated in the top right corner.
  3. Selecting one filter option may influence the numbers of another. Options that no longer apply will still be displayed as it allows you to see which datasets appear in the list of results.

Displaying the data for a specific manuscript

  1. Input the data known to you to identify the manuscript you are seeking, e.g. location, holding institution and/or shelfmark.
    • You can also just enter parts of the shelfmark (e.g. just the letters indicating repository location).
  2. Press ‘enter’ or click on ‘search’.
  3. Your search results will be displayed as a list, grouped by manuscript and sorted by relevance.
    • To quickly find the shelfmark you are looking for, change the display option for the list of results in the top right corner. For example, use the last of the four icons if you only wish to view the basic data and context of each search result.
  4. Click on the shelfmark to access the overview page.
  1. You can either copy the web address of the overview page to forward it or create a bookmark.
    • The filters activated during the search for the manuscript are also forwarded.
    • The web address is not yet permanent!
  1. Access the overview page for a manuscript from a search or via a link. 
  2. All available information on the manuscript can be viewed here:
    • Table containing basic data taken from descriptions.
    • All existing academic descriptions of the manuscripts.
    • All available digital copies.
  3. The three sections are arranged one after another; simply scroll to the section you desire.

Click on the shelfmark to access the overview page.

Workspace

Working with digital copies

  1. Go to the overview page for your chosen manuscript.
  2. Click on the thumbnail or
  3. scroll down to the ‘digital copies’ section.
    • Click on the digital copy to open and view it in your workspace.
    • Clicking on the plus symbol adds the digital copy to your workspace whilst you remain on the overview page. You now have the option to add other digital copies or descriptions to your workspace. Click on ‘workspace’ in the menu on the left to access your workspace.

ⓘ Digital copies can be opened in the Handschriftenportal in two ways: either via a link to an external presentation (e.g. in the holding institution’s digital library, project website or an edition) or as an IIIF manifest that can be viewed within your workspace. Sometimes both options are available. To access the digital copy’s IIIF manifest follow the instructions given above. External links are provided below the digital copy and open in a new tab.

  1. Open the digital copy in your workspace.
  2. Use the left and right arrows in the transparent bar at the bottom to move to the previous and next images of the manuscript one (/double) page at a time. The current page number is located beneath the two arrows.
  3. Other navigation options are also available:
    • Table of contents: Click on the menu left next to the shelfmark and open the table of contents (third option). The table of contents displays the structure of the digital copy and helps the user to navigate it. Usually, there are several levels of headings. Click on a heading to jump to the corresponding page.
    • Gallery view: Click on the first symbol at the top right to open the display options. Select ‘gallery’ to switch views. Thumbnails of each page will now be displayed, allowing for an overview of the digital copy. Double click on a page to enlarge it.
    • Thumbnails: Click on the first symbol at the top right to open the display options. In the bottom section you can select how you wish to see the thumbnails, below or to the right of the digital copy. Either one of those options will make the thumbnails appear in combination with either the ‘single’, ‘book’ or ‘gallery’ view. Use the arrows at the bottom to navigate the digital copy and click on a thumbnail to open it.

Both existing internal and added external digital copies can be displayed and reviewed in your workspace, provided they are compatible with the IIIF standard and you have the URL for the manifest file. In catalogues of IIIF-supported digital copies, the IIIF logo is usually displayed next to the URL normally ending in ‘manifest’ or ‘manifest.json’ (e.g. https://iiif.ub.uni-leipzig.de/0000011641/manifest.json).

Adding an external digital copy to your workspace:

  1. Use the menu on the left to open your workspace. To expand the menu, click on the burger symbol at the top left.
  2. Click on ‘add content’ to view the external content you have added to your workspace during the current session. At the start of your session the workspace will be empty.
  3. Click on ‘add content’ at the bottom right.
  4. Enter the IIIF manifest URL for the external digital copy and click on ‘add’.
  5. The digital copy will now appear in the list. You can now open this digital copy in your workspace. Use the ‘add content’ button to add further objects to your workspace.

Digital copies can be opened in the Handschriftenportal in two ways: either via a link to an external presentation or as an IIIF manifest that can be viewed within your workspace.

Reading academic descriptions

  1.  Go to the overview page of your chosen manuscript. 
  2. Scroll down to ‘descriptions’.
    • Click on a description to open it in your workspace.
    • Click on the plus symbol to add a description to your workspace; in doing so you will remain on the overview page. You now have the option to add other digital copies or descriptions to your workspace. Click on ‘workspace’ in the menu on the left to access your workspace.
  3. You can also open descriptions straight from the list of results.
  4. You can do this by expanding the field concerning the context of the search result.
    • Click on the plus symbol to add a description to your workspace.
    • The option to directly jump to the searched word in the text is currently under development.

Use the plus symbol to add as many elements (both descriptions and digital copies) as desired to your workspace. The plus symbol changes to a tick when the object has successfully been added to your workplace. The little number that appears just below the workspace symbol in the menu on the left indicates the number of objects that you have added to your workspace. Click on the tick to remove the selected object from your workspace.

  1. In the current test environment only the basic navigation functions are available. Extensive improvements are in development.
    • Use the mouse wheel or scroll bar to scroll up and down in texts (similar to other text viewers).
    • Click on an item in the table of contents on the left to jump to that location in the text. The table of contents is currently in an early stage of development.
    • Until a text search function is integrated into the system, you can use the default word search function available in your browser (Ctrl+F). The search function varies slightly from browser to browser. For example, Chrome opens an input field in the top right corner where you can type in a word/phrase and press ‘enter’.

Use the plus symbol to add objects to your workspace.

Customising your workspace

  1. Use the menu on the left to open your workspace. To expand the menu, click on the burger symbol at the top left. Before adjusting the layout, wait until you have added some digital copies and descriptions. Then you will be able to see the effects more clearly.
  2. Click on ‘view mode’ (second option in the ‘workspace’ menu).
  3. A popup will open in which you can choose between two view modes:
    • Elastic: The size of the workspace is limitless; however you can only see a section of it. Use your mouse to drag and drop objects into your workspace. Arrange the windows in your workspace entirely as you wish; you can even add more windows than you can see in the section on your screen. Each window can be scaled to the desired size and moved around freely. Windows can also overlap.
    • Mosaic: Your workspace only exists within the visible frame. Here all windows are displayed alongside one another. Use the mouse to reposition the windows and adjust their size. Changing the size of one window always affects the other windows.
  4. Select the preferred view mode for your work.
  1. Use the menu on the left to open your workspace. To expand the menu, click on the burger symbol at the top left.
  2. Click on ‘full screen’ (third option in the ‘workspace’ menu).
  3. Your workspace will now be displayed in full screen mode.
  4. Press ‘Esc’ to exit the full screen mode.