Skip to content

Oxygen Framework

Jump to bottom
Christian Lück edited this page Oct 5, 2025 · 2 revisions

Oxygen Framework

The TEI DTS Oxygen Framework supports developing citation tree declarations with <refsDecl>, <citeStructure> and friends. It offers transformations scenarios for quickly checking, if your declarations do what you expect them to do.

TEI DTS uses TEI P5 as a base framework and only adds transformation scenarios for running the XSLT from the DTS Transformations package on your currently edited TEI XML file.

Installation

It's not required to clone the repository for using the TEI DTS Oxygen framework. It's installable with a few clicks by using the following link:

https://scdh.github.io/dts-transformations/descriptor.xml

Paste this link into the field Show add-ons from of the dialog Install new add-ons that is accessible from the Oxygen's main menu's Help entry. The dialog looks like this (the picture is actually taken from an other framework installation):

Dialog for adding a new add-on (Different URL here!)

After clicking Next>, do not forget to check the I accept all terms of the end user license on the next dialogue and hit Next> again. You will then be warned that the TEI DTS framework is not signed with a signature. That's OK, we haven't implemented the signing yet in our deployment pipeline. Just click Continue anyway.

Continue, albeit a signature is missing

The installation is done now. The TEI DTS framework is ready to use, after restarting the Oxygen editor.

Activation / De-Activation

TEI DTS is a framework with low priority. It is used instead of TEI P5, which is also in low priority, because TEI DTS precedes TEI P5 in lexical order.

If you have other frameworks configured für TEI editing, TEI DTS may not active albeit installed, because this other framework's name precedes TEI DTS in lexical order or it may run in a higher priority.

In Oxygen, only one framework can be active at a time (but that active framework can inherit functionality of an other framework that it is based on).

So you will probably want to activate or de-activate TEI DTS, to use it or other your other TEI frameworks. This can be done in the Document Type Association dialog. You find it via the main menu Options > Preferences > Document Type Association.

de-ctivated TEI DTS framework

Clone this wiki locally