Category Archives: Uncategorized

Tradamus – Structuring


Creating Structures is simple way to select and order the parts of your witness texts or other content as you want. The advantage to doing this is it allows you to deal with one piece of your content at a time in a manageable way while creating a useable structure for that content as you go. This has a number of immediate benefits. If you are bringing your content in from T-Pen and you have the first chapter transcribed for all your witnesses this will allow to start collation without needing your entire text transcribed. It also facilitates feeling with transposed or absent parts in the witnesses easily.

There are three steps to structuring

  • Create Segments. The Segments are the basic building blocks of your edition. They can be any number of things from individual chapters of your witnesses to single pages to the introduction or commentary you want to add to your edition. There are several benefits to doing this which will be explained in tomorrow post called Segmenting.
  • Once you have your Segments made you will collect them in Outlines which you can then collate. Attempting Collation of entire texts without creating manageable Outlines first is possible but it can take several days or more for CollateX to complete. We allow for this longer collation with an option to receive notification when the collation has been run.
  • Once your witnesses and other materials are collated, annotated and tagged you can put them in Sections to allow you to order them in the desired fashion for publication. You can generated indexes and other apparatus’s from these sections as you orange the sections for publication.






for more info and to sign up for an account go to

Tomorrow: More Details on Segmenting.


Tradamus – Materials


This information is not specifically about how to use this web application, but more about understanding the data model and the technical decisions made in its creation. Comprehending all this will help you work more effectively but is not required for basic use.

Broad Principles

Each critical edition is an arrangement of editorial materials and the assertions made about them. 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.


Types of Material


These are copies of a given text from different sources that may or may not vary from other witnesses of the same text. These can be imported From T-PEN, XML or JSON documents, or be manually created.


Tradamus supports images and while preferably sc:Canvas,any resolvable image is made annotatable. Images connected to an Project via a T-Pen project allows the relevant area of an image to be viewable with the text.

Editorial Content

Chapter headings, introductions, commentaries, analyses or any additional material you wish to add to your Project so as to be able to introduce them into the publication in the order or manner of your choosing.


Encoded data to generate charts, tables, or publication aids


any digital pointer to a non-digital or unavailable resource that needs a hook provided to allow for annotation. If for instance you have access to collation tables for a witness but not the witness and you only wish to capture the variants we generate a placeholder sc:canvas for that so as to allow you to annotate that specific material if you desire to.



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 is designed to facilitate adding, annotating or editing the following elements to the material:


A label that provides only a human-readable string. For a manuscript witness, this is often similar to the shelfmark or identifier, though significantly distinct. This is defined by the user and can be edited at any time.


This is a letter (especially an initial) or other symbol used to to refer to a particular witness of a text. It acts as human readable abbreviated label to aid identification of a witness. This is defined by the user and can be edited at any time.


annotations that specifically target the base material for the purpose of description. This is defined by the user and can be edited at any time.


Annotations that attach textual data to the material.


Sequence of sc:Canvas objects that represent the annotated images and other data of a material.


List of all other annotations that target the material, but which may not be otherwise classifiable, including those imported from XML or JSON files.






For more information and to create an account go to


We will be publishing a series of entries on this blog in the coming weeks on how to use tradamus.

The next blog entry will be on Structuring.