DoTS

What is DoTS?

DoTS is an XQuery implementation of DTS using a BaseX backend.

Note

DoTS supports only DTS GET requests for browsing collections, document retrieval and navigation.

What is DTS?

The Distributed Text Services (DTS) Specification defines an API for working with collections of text as machine-actionable data.

Publishers of digital text collections can use the DTS API to help them make their textual data Findable, Accessible, Interoperable and Reusable (FAIR).

Capabilities

Using DoTS, you can

• with the DTS Collection endpoint:
  • Retrieve lists of collection members.
  • Retrieve metadata about individual collection items.
• with the DTS Navigation endpoint:
  • Retrieve lists of citeable passages within a text.
  • Retrieve a range of citeable passages within a text.
  • Retrieve metadata about the citation structure of a document.
• with the DTS Document endpoint:
  • Retrieve a single text passage at any level of the citation hierarchy.
  • Retrieve a range of text passages with a clearly defined start and end passage.
  • Retrieve an entire text.

Install

BaseX

Download BaseX (>= 10.0): https://basex.org/download/

Info

• Prefer ZIP Package, which ensure that you will find the complete BaseX folder.
• Requirements : https://docs.basex.org/wiki/Startup#Startup

DoTS

DoTS must be installed and started directly in the BaseX folder.

cd path/to/basex/webapp

git clone https://github.com/chartes/dots.git

The structure of your BaseX should be as follows:

basex/              # BaseX root dir.
    bin/            # Start scripts (GUI, HTTP server, etc.).
    data/           # Database directory.
    webapp/         # Web Application directory.
        dots/       # DoTS module (DTS reslover, etc.).
    ...             # Others BaseX files.

Start DTS resolver

cd path/to/basex/bin

bash basexhttp

By default, the base DTS API enpoint is available at http://localhost:8080/api/dts/.