Skip to content
This repository has been archived by the owner on Feb 10, 2021. It is now read-only.

Springs Specification

Cliff Wulfman edited this page Mar 23, 2016 · 4 revisions

Data Model

bmtnobj

Blue Mountain Objects: bibliographic entities that are “in” Blue Mountain. Include magazines, issues, and constituents.

magazines

The “titles” in Blue Mountain.

run

the full, ordered sequence of issues published during the lifetime of a magazine

magazines
run
(property) the full, ordered sequence of issues published during the lifetime of the magazine
lifetime (duration)
a timespan starting with the publication date of the first issue in the run and ending with the publication date of the last issue in the run
title(s)
one of perhaps several acceptable names for the magazine taken as a whole. Titles have a language property; one title will be designated as the primary title within Blue Mountain
editors
one or more agents with editorial responsibility during the lifetime of the magazine
contributors
one or more agents whose work appears in the run of the magazine
pubPlaces
one or more places where the magazine was published during its lifetime
editorial content
advertising content
issues
the periodic publications comprising a magazine.
constituents
identifiable textual or visual elements of an issue.
bylines
the strings denoting authors, illustrators, etc. Distinct from agents.
agents
people or organizations who contribute in some way to the magazine or issue, including authors, illustrators, editors, publishers, printers, translators, etc.

Routes

overview

An API to metadata about the objects in Blue Mountain.

The prefix for these routes is :: springs/metadata/

bmtnobj

  • metadata
  • transcriptions?

magazine

Properties

  • bmtn identifier
  • title(s)
  • contributors (editors, authors, etc.)
  • start date
  • end date
  • number of issues
  • place(s) of publication
  • language(s) appearing in magazine (by percent of constituents)

Routes (Resources)

magazines/

The set of magazines in Blue Mountain.

magazines/{bmtnid}

The magazine with the identifier bmtnid.

magazines?{filter}

The set of magazines meeting the criteria specified in one or more filter expressions.

Representations

text/html (default)

application/json

application/tei+xml

application/rdf+xml

application/mods+xml

application/mets+xml

Filters:

start_run
{ w3cdtf }
end_run
{ w3cdtf }
primary_lang(s)
{ iso639-2b }
includes_lang(s)
{ iso639-2b }
with_bylines_containing
{ string }
with_contributions_by
{ id }

issues

Properties

  • bmtn identifier
  • title(s)
  • date(s) of publication
  • place(s) of publication
  • extent
  • contributors
  • constituents

Representations

text/html (default)

application/json

application/tei+xml

application/rdf+xml

application/mods+xml

application/mets+xml

constituents

Properties

  • bmtn identifier
  • title
  • class set

bylines

agents

Full-Text Springs

An API to text-based expressions of Blue Mountain objects. Formats are plain text (.txt) and TEI-XML.

  • application/tei+xml

Filtered Springs

SPARQLing Springs

IIIF Springs