Ong Blog

Tradamus – Structuring – Segmenting


Segmenting allows for much greater control on your Material. For example you could create segments for each chapter from a multi-chapter witness or your commentaries for each chapter from a single Material that contains all the chapter commentaries. This means you can segment you materials for easier use with Tradamus without having to restructure you materials as multiple documents. You can create this structure within Tradamus with out having to rework your content to be structurally consistent before bring it into Tradamus. it also allows you to segment the same Material in as many ways as you like without having to alter or rework the original source. This makes collation much more flexible and makes experimentation and multiple approaches to the content viable from the same set of original Material without having to rework that original Material.

Tradamus allows your Edition/Publication to be built of multiple, well-structured and well-annotated segments made from your Material. In order to support this we have built a tool Create Segments. The Create Segments button allows you to break your content into manageable pieces to allow you to have greater control in collating different elements of you witnesses as well as reordering them to facilitate this without the need to physically reorder the contents of the witness so your content remains true to its source while being usable especially when you need to reorder the content or need granularity in the collation of you witnesses. When you do this you are creating structural annotations of the Material.




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 Outlines.

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.


TRAD_FullogoTradamus is a free digital Critical Digital Edition creation web application. Whether you have straight transcriptions of your text or full TEI encoded documents you can bring them together in Tradamus to build a Critical Edition using the methodology that you want. From the Apparatus Criticus to the final publication you decide!

Annotate witnesses, Collate your witnesses by leveraging our sectioning approach to allow you to clearly and easily manage and work with the specific elements of your text, witness images, add commentary and editorial materials, tag, style and publish. Use the application in a way that works for you; import XML, TXT, and JSONs formats. Bring your Export your content in JSON, and JSON-LD at multiple points. Use our templates for your publication or take your publication content to deploy in whatever way you want.

Tradamus allows for collaboration as well as multiple levels of users to contribute to your Critical Edition in a way that works for you. We have built in a blind review option to facilitate peer review.


The Tradamus Approach


There are four core elements to building a critical edition in Tradamus.

  1. Create an Project – The Project will hold all your transcriptions, images, annotations. Think of it as a container for all of your work.
  2. Import your Materials. Everything that you bring into your Project are your materials. This could be your transcriptions, manuscript images, commentaries, bibliographies and anything else you want to include in you publications.
  3. Organize you Materials. there are two steps to organizing your materials. Firstly break your materials into manageable and logical segments. This is your opportunity to bring your Materials together and organize them to allow you to work with them. It also brings together the transcriptions in manageable and coherent divisions to collate them. For example you could create an segment for each of the ‘chapter ones’ in your witnesses. You bring those segments together into an outline which you then collate. Other content you have imported like an commentary which you can bring in as a single document also be divided into sensible and logical segments. This kinds of segments are put into outlines which are then ready to be arranged in its appropriate section when you are ready to prepare to publish. Thus you can deal with your materials in a content focused way.
  4. Prepare your Outlines for publication. Once you have collated The witness Outlines, you arrange the Outlines in Sections which are then put in the desired order for publication. Thus you put your commentary outline for chapter one with the collated text of chapter one and add any desired indexes, bibliographies or other relevant content. These Sections can then be ordered as needed. This ordered set of Sections can then be published.


This approach allows you to publish your critical edition, not only in a variety of formats but you can also return to your materials and re-imagine your work in a different way. Your first publication may take a diplomatic approach, your next might be mouvaunce in its approach. In each case you would leverage all the materials you have already done in Tradamus so you would not be starting from scratch but at the point of scholarly divergence. You can edit and rework any existing publication to enhance or enrich the work and all changes are saved so that the reader can reference those changes as well as the presented publication.


Project flow with collation

Project flow without collation



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 Materials, followed by a series on Structuring.


April 2016
« Nov   May »

Follow us on Twitter