Materials

lead

Each critical edition is an arrangement of editorial materials and the assertions made about them.

entry

The most common materials are those that represent various witnesses to the edited text, but there may be supporting texts, images, digital or real objects, and original material generated by the editor without which the edition could not be considered complete.

Any material can be annotated, included in a section of the edition, or referenced as a data object in an annotation or apparatus. Tags or annotation types can be used to filter or group materials into manageable clusters, if needed.

These annotations can also be used to emulate families of related texts in a way that allows for non-exclusive and non-destructive grouping.

aside

Types of Material

• Witness
  from T-PEN, XML or JSON documents, manual creation
• Image
  preferably sc:Canvas, but any resolvable image is made annotatable
• Editorial Content
  chapter headings, introductions, commentaries, analyses
• Dataset
  encoded data to generate charts, tables, or publication aids
• Placeholder
  any pointer to a non-digital or unavailable resource that needs a hook provided for annotation

sample/detail

Anatomy of a Material

The creation of a new material relies on a link/import/upload or a manual process. All a material requires to exist is a title. Tradamus will immediately create a full digital document representing this material and update it with any additional data. This document is available at its URI. When a material is imported from a location that provides a URI which resolves to a SharedCanvas Manifest, that URI will be retained. Otherwise, Tradamus will mint and maintain a new URI.
The interface will assist with adding the following elements to the material:

• Title
  rdfs:label that provides only a human-readable string. For a manuscript witness, this is often similar to the shelfmark or identifier, though significantly distinct.
• Siglum
  short reference to the object for human abbreviation to be used as needed throughout the interface.
• Metadata
  annotations that specifically target the base material for the purpose of description.
• Transcription
  annotations that attach textual data to the material.
• Manifest
  sequence of sc:Canvas objects that represent the annotated images of a material.
• Annotations
  list of all other annotations that target the material, but which may not be otherwise classifiable, including those imported from XML or JSON files.

---

include some samples of an image, witness, or text resource

---

best practice

TODO

related topics

• Annotations
• Transcription
• Manifest
• Witnesses