Digitalia ARTS MUNI Technical Documentation

Herbaria manuscripta documentation

Contact email: digitalia@phil.muni.cz

Updated: 23 Jul 2024

Prepared by Illyria Brejchová

Introduction

Basic information about the Herbaria manuscripta platform is available on the database website in the About section.

Technical Implementation

Herbaria manuscripta is realised using Islandora Open-Source Digital Asset Management and is part of the Digitalia MUNI ARTS infrastructure. It’s basic technical documentation can be found in a separate document.

Individual records are stored as Drupal Nodes and grouped by type into Content Types. URIs of the individual objects: https://www.herbaria.phil.muni.cz/en/node/[id] and taxonomy terms: https://herbaria.phil.muni.cz/en/taxonomy/term/[id].

GitHub repository for configuration files

GitHub repository for platform-specific modifications to the Digitalia theme

Database Contents

An overview of the content of Herbaria can be found in the Help section.

Metadata

Herbaria stores metadata in Drupal Fields. Each record type has a defined list of corresponding Fields. When exporting metadata in the Dublin Core (DC) schema, some of these fields are mapped to DC schema elements.

Content type Label Machine name Field type Note
Manuscript Bibliography field_bibliography Data field  
  Dating field_dating Text (plain)  
  Dating Interval field_dating_interval Entity reference  
  Created after field_created_after Number (integer) earliest estimate
  Created before field_created_before Number (integer) latest estimate
  Institution field_institution Entity reference  
  Known as field_known_as Text (plain) common name of manuscript
  Link field_link Link link to digitalization
  Note field_note Text (formatted, long)  
  Private note field_private_note Text (plain, long)  
  Provenance field_provenance Text (plain)  
  Scribe field_scribe Text (plain)  
Institution City field_city Entity reference  
  Country field_country Entity reference  
  Link field_link Link  
  Mother institution field_member_of Entity reference for linking subinstitutions to mother institutions
  Model field_model Entity reference  
Text in Manuscript Bibliography field_bibliography Data field  
  Explicit field_explicit Text (plain, long)  
  Foliation field_foliation Text (plain)  
  Incipit field_incipit Text (plain, long)  
  Manuscript field_manuscript Entity reference  
  Note field_note Text (formatted, long)  
  Private note field_private_note Text (plain, long)  
  Type field_type Entity reference  
  Unified Title field_work Entity reference  
Herbal entry Effects field_effects Entity reference  
  Bibliography field_bibliography Data field  
  Foliation field_foliation Text (plain)  
  Herbal field_herbal Entity reference  
  Modern identifications of the simple medicine field_botanical_identification Data Field  
  Note field_note Text (formatted, long)  
  Private note field_private_note Text (plain, long)  
  Order of entry field_order_of_entry Number (integer)  
  Transcription of herbal entry field_work Text (formatted, long)  
  Glosses field_gloses Data Field  
  Note field_note Text (formatted, long)  
  Private note field_private_note Text (plain, long)  
User Link field_link Link  
  Expertise field_expertise Text (plain)  
  User field_user Entity reference Link to user account
Bibliographic citation Citation field_citation Text (formatted, long)  
Taxonomy term Label Machine name Field type Note
Certainty Scale        
City Authority Link field_authority_link Authority Link.  
Country Authority Sources field_authority_link Authority Link  
Datation        
Effects        
Genre Authority Sources field_authority_link Authority Link  
Herbal entry type        
Language Authority Sources field_authority_link Authority Link of text in manuscript
Modern Name of Simple Medicine Bibliography field_bibliography Data field  
  Type field_herbal_entry_type Entity reference  
  Links field_authority_link Authority Link Links to databases with more information about this simple medicine
  Effects field_effects Entity reference  
  Common Czech Name field_common_czech_name Text (plain)  
  Common English Name field_common_english_name Text (plain)  
Type of recording       Transcription or transliteration
Unified Title of Text Bibliography field_bibliography Data field  
  Language field_text_language Entity reference  

The Modern identifications of the simple medicine Data Field groups four fields:

The Bibliography Data Field groups two fields:

The Glosses Data Field groups three fields:

Exporting data

CSV

Herbals: https://herbaria.phil.muni.cz/en/export/herbals.csv

Titles: https://herbaria.phil.muni.cz/en/export/titles.csv

Herbal entries: https://herbaria.phil.muni.cz/en/export/herbal_entries.csv

Modern names of simple medicines: https://herbaria.phil.muni.cz/export/modern-medicines.csv

Medieval names for simple medicines: https://herbaria.phil.muni.cz/export/medieval-medicaments.csv

REST API

All nodes and terms can be accessed via REST export (GET). The data is labeled with machine names the semantics of which was described in the chapter on metadata. A number of formats are available - json, csv, xml.

For nodes:

https://herbaria.phil.muni.cz/node/export?_format=json

https://herbaria.phil.muni.cz/node/export?_format=csv

https://herbaria.phil.muni.cz/node/export?_format=xml

It is also possible to filter the data using the id (nid) or content type (type). For example:

https://herbaria.phil.muni.cz/node/export?_format=json&nid=465

Herbals: https://herbaria.phil.muni.cz/node/export?_format=json&type=work_in_manuscript

Codes for filtering by content type:

Content type Code
Manuscript manuscript
Institution instituce
Text in Manuscript work_in_manuscript
Herbal entry herbal_entry
User user
Bibliographic citation bibliographic_citation

For taxonomy terms:

Filtering examples (by taxonomy term id (tid) and vocabulary id (vid)):

https://herbaria.phil.muni.cz/term/export?_format=json&tid=90

Modern names of simple medicines: https://herbaria.phil.muni.cz/term/export?_format=json&vid=botanical_name

Titles: https://herbaria.phil.muni.cz/term/export?_format=json&vid=work

Codes for filtering by taxonomy term vocabulary:

Taxonomy Code
City geo_location
Certainty Scale certainty
Country country
Datation datation
Effects effects
Herbal entry type herbal_entry_type
Language language
Modern Name of Simple Medicine botanical_name
Type of recording type_of_recording
Type of text genre
Unified Title of Text work

Dublin Core OAI-PMH

OAI-PMH is the main way in which data from Herbaria manuscripta is contributed to aggregating platforms, such as LINDAT/CLARIAH-CZ. Since the data in Herbaria manuscripta is highly specialized and not all of it would make sense outside of this platform’s context, only the central content type of the platform - that is the texts within manuscripts (the copies of herbals) - is shared via OAI-PMH. However, metadata from related content types (manuscripts, herbal entries) are also reflected in the Dublin Core records.

Endpoint: https://herbaria.phil.muni.cz/oai/request?verb=ListRecords&metadataPrefix=oai_dc

The mapping is realized using the Metatag module and tokens, the available Drupal tokens have been expanded by the Digitalia Token module

Dublin Core Element Herbaria manuscripta field relative to ‘Text in Manuscript’
title [node:field_work] ([node:field_manuscript])
subject medieval medicine, herbs, [digitalia_muni:field_herbal:herbal_entry:title]
description This text is part of the manuscript [digitalia_muni:field_manuscript:manuscript:title], [node:field_foliation]. It starts with the incipit: “[node:field_incipit]” and ends with the explicit: “[node:field_explicit]”. [node:field_note]
publisher  
date [digitalia_muni:field_manuscript:manuscript:field_dating_interval]
type [node:field_type]
format text
language [node:text_language]
identifier [node:url:absolute]
relation [digitalia_muni:field_manuscript:manuscript:field_link:uri]
rights  
coverage Central Europe, Middle Ages

Indexing and searching

Basic information about browsing and searching options can be found in the Help section of the database website.

The index for full text search on the platform contains the pages of all content types.

Roles

Content editor - can create, edit, and delete all content relevant to the Herbaria manusripta platform. Changes are saved as revisions.

Contributor - can add modern identifications to herbal entries and edit the Moden Names of Simple Medicines taxonomy.

Terms of use

The Herbaria manuscripta dataset authored and created by Masaryk University, can be used in accordance with the Creative Commons license terms: Creative Commons BY 4.0.