Skip to content

deutschestextarchiv/dtabf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DTA Base Format (DTABf)

DTA Base Format – Schema and Documentation

The DTA Base Format (DTABf) is a TEI customization for the annotation of digitized historical texts. It is the annotation basis for all texts published on the Deutsches Textarchiv (DTA) platform.

To explore the DTABf documentation see the official website. The DTABf documentation also contains information on how to access the RNG schemas and how to use them. For elaborate information on the purpose of the format and constraints for its further development see the DTABf Guiding Principles.

Contact

The DTABf ist published by

Deutsches Textarchiv
Berlin-Brandenburg Academy of Sciences and Humanities, Jaegerstr. 22/23, 10117 Berlin, Germany
mailto:[email protected]
https://www.deutschestextarchiv.de

Contributors

  • Matthias Boenig
  • Daniel Burckhardt
  • Stefan Dumont
  • Alexander Geyken
  • Martina Gödel
  • Susanne Haaf
  • Axel Herold
  • Christian Thomas
  • Frank Wiegand

Building

Requirements

In order to build RNG schemas of the DTABf and the documentation site, the following software is required:

Building the RNG schemas

With Docker installed, running

$ scripts/build-schema

will transpile the TEI/ODD resources under schema/ into compiled ODD and RelaxNG schemas under htdocs/:

$ ls htdocs/basisformat*
htdocs/basisformat_all.odd  htdocs/basisformat_ohne_header.odd  htdocs/basisformat.rng
htdocs/basisformat_all.xml  htdocs/basisformat_ohne_header.rng  htdocs/basisformat.sch
htdocs/basisformat_ms.odd   htdocs/basisformat_ohne_header.xml  htdocs/basisformat_template.xml
htdocs/basisformat_ms.rng   htdocs/basisformat_phase1.odd       htdocs/basisformat.xml
htdocs/basisformat_ms.xml   htdocs/basisformat_phase1.rng
htdocs/basisformat.odd      htdocs/basisformat_phase1.xml

Building the documentation site

Open the project file dtabf.xpr in oXygen XML Editor (tested with v26.0) and execute the DITA-OT transformation scenario "Documentation". This will transform DITA resources under documentation/, starting from dtabf.ditamap and store the result under htdocs/, adjacent to the transpiled schema resources.

Screenshot of oxXygen XML Editor with the DTABf/DITA project

Publishing to GitHub Pages

Once the schema resources and documentation have been built, the contents of htdocs/ can be published to GitHub Pages via

$ scripts/publish-gh-pages

License

All files of the DTABf documentation and schema are distributed under a CC BY-SA 3.0 DE license (Creative Commons Namensnennung - Weitergabe unter gleichen Bedingungen 3.0 Deutschland). The license text is available on the Creative Commons website. For all third party resources used by the DTABf documentation, license restrictions of the respective providers apply and are respected; see below for details.

Third Party Copyright Information

The DTABf is based on the P5 guidelines of the Text Encoding Initiative (TEI). The TEI P5 guidelines were only reduced or tightened, never extended. Thus, the DTABf is fully compliant to TEI P5. The TEI P5 guidelines and adjacent software are distributed under the Creative Commons Attribution 3.0 Unported License and the BSD 2-Clause license.

Disclaimer

We do not grant any warranty for the product published here. For details see the CC-BY-SA license.