Introduction
This section documents the model for documents that contain text, including artworks such as medieval manuscripts, archival material such as letters, ledgers or diaries, scholarly communication such as journals, articles and monographs, digital objects such as web pages, or any other sort of written communication.
The intent is not to be an all-encompassing model that would be suitable for a graph based library management system, archival finding aids, or catalog of any digital resource, but instead to provide sufficient description that the object is identified, understandable and able to be referenced within other more specific systems and ontologies. This model is intended to be enough to use for the basic use cases of referencing texts that are related to artwork, regardless of whether they are held in a library, archive, museum, or on the internet.
Notably, it does not attempt to reproduce the formalisms of FRBR, as manifested by FRBRoo or BibFrame, or other conceptual hierarchies, but instead provide as simple as possible a model to accomplish core bibliographic reference tasks.
Physical Objects, Conceptual Texts
The first distinction that is needed is between the physical carrier of the text, and the text itself. Like the VisualItem
pattern for the artwork's visual content shown by objects, the LinguisticObject
that represents the text of a work can be carried
by many HumanMadeObject
s. In this way, all of the copies of a particular book carry the same information content, that only needs to be described once and can act as a single connection point.
Like other LinguisticObjects, it can have a value
for the actual text of the work, classifications, languages and so forth.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/32",
"type": "HumanMadeObject",
"_label": "Physical Book",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300028051",
"type": "Type",
"_label": "Book",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300435443",
"type": "Type",
"_label": "Type of Work"
}
]
}
],
"carries": [
{
"type": "LinguisticObject",
"_label": "Textual content of the Book",
"content": "Once upon a time, ...",
"language": [
{
"id": "http://vocab.getty.edu/aat/300388277",
"type": "Language",
"_label": "English"
}
]
}
]
}
Core Features
The same core features of all other resources are also applicable to the LinguisticObject
s used to represent texts. They must have an id
and type
, they should have a label
, they should have a classified_as
relationship to a Type
that further describes the sort of object, and so forth. They may also have a language
property, that references a Language resource.
The title of a text is captured using the Name
pattern, and assigned identifiers using the Identifier
pattern, referenced with the identified_by
relationship.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/text/1",
"type": "LinguisticObject",
"_label": "Example Article",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300048715",
"type": "Type",
"_label": "Article"
}
],
"identified_by": [
{
"type": "Name",
"content": "Title of Article"
},
{
"type": "Identifier",
"_label": "DOI of Article",
"content": "10.1000/1011"
}
],
"language": [
{
"id": "http://vocab.getty.edu/aat/300388277",
"type": "Language",
"_label": "English"
}
]
}
Creation and Publication
The production of the physical carriers of texts uses the same model as for other physical objects, and may be of interest for manuscripts, very early printed works (incunabula), letters or other similar documents, however the factory details for a specific modern book are likely of much less importance to capture.
There are two primary text-specific activities that are captured -- the creation of the text, being the conceptual LinguisticObject
and its publication. The text is created by a Creation
activity of the author, but then there is a publishing Activity
(aat:300054686) carried out by the publishing organization, for the same resource.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/text/2",
"type": "LinguisticObject",
"_label": "Example Journal Article",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300048715",
"type": "Type",
"_label": "Article"
}
],
"created_by": {
"type": "Creation",
"_label": "Creation of the Article Content",
"carried_out_by": [
{
"type": "Person",
"_label": "Author"
}
]
},
"used_for": [
{
"type": "Activity",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300054686",
"type": "Type",
"_label": "Publishing"
}
],
"carried_out_by": [
{
"type": "Group",
"_label": "Publishing House"
}
]
}
]
}
Structure
The textual structure can be modeled with the partitioning of LinguisticObject
s via the part_of
property, in the same way that the parts of a physical object can be partitioned. Thus the content of an Article can be part of the containing Issue, which is part of a Volume, which is part of the Journal or other periodical. Similarly Chapters can be part of a Book or Proceedings, particular entries within a catalog, and so forth.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/text/3",
"type": "LinguisticObject",
"_label": "Example Monograph Text",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300060417",
"type": "Type",
"_label": "Monograph"
}
],
"part": [
{
"type": "LinguisticObject",
"_label": "Chapter 1",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300311699",
"type": "Type",
"_label": "Chapter"
}
]
},
{
"type": "LinguisticObject",
"_label": "Chapter 2",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300311699",
"type": "Type",
"_label": "Chapter"
}
]
}
]
}
Pages
Textual content is typically presented on pages or folios. As there might be many physical copies with the same structure, it is common to describe the pagination of the content as it applies to the content in general, rather than the many physical objects that carry that content. Pagination (aat:300200294) or Foliation (aat:300200662) statements are the most common way to represent this, as simple descriptive fields following the core statement pattern. For uncomplicated, machine readable pagination values, it is possible create a pair of start and end Dimensions.
Pagination Statement
The easiest way to describe the page range of a particular section of a larger collection is with a pagination statement. The disadvantage of the approach is that it is not computationally available for processing.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/text/4",
"type": "LinguisticObject",
"_label": "Example 10 page Article",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300048715",
"type": "Type",
"_label": "Article"
}
],
"referred_to_by": [
{
"type": "LinguisticObject",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300435440",
"type": "Type",
"_label": "Pagination Statement",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300418049",
"type": "Type",
"_label": "Brief Text"
}
]
}
],
"content": "125-135"
}
]
}
Abstracts
While the full text of the LinguisticObject
may be either too long to provide, or protected by publication and access restrictions, it is common for an abstract to be published and circulated openly. This abstract might be provided by some other actor than the author of the content, such as via an abstracting and indexing service. In this case, the Abstract would have its own separate Creation
activity from that of the abstracted content.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/text/5",
"type": "LinguisticObject",
"_label": "Abstract of Example Article",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300026032",
"type": "Type",
"_label": "Abstract",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300418049",
"type": "Type",
"_label": "Brief Text"
}
]
}
],
"content": "This is the abstract of the example article, which is excellent.",
"refers_to": [
{
"type": "LinguisticObject",
"_label": "Example Article",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300048715",
"type": "Type",
"_label": "Article"
}
]
}
],
"created_by": {
"type": "Creation",
"carried_out_by": [
{
"type": "Person",
"_label": "Example Abstracter"
}
]
}
}
References to other Resources
Textual content can refer_to
other resources in the overall model. These references might be just that the content discusses the resource, such as a mention of a particular painting. Equally, the reference might be that the content was used as the evidence for the resource, such as a Materials Statement being the evidence for the Materials in the model that the painting is asserted to be made_of
.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/text/6",
"type": "LinguisticObject",
"_label": "Article about Example Painting",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300048715",
"type": "Type",
"_label": "Article"
}
],
"refers_to": [
{
"type": "HumanMadeObject",
"_label": "Example Painting",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300033618",
"type": "Type",
"_label": "Painting",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300435443",
"type": "Type",
"_label": "Type of Work"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
]
}
]
}
Translations
One Linguistic Object, be it captured in the model as a Statement or as the full text content carried by a physical object, can be the translation of another. For example an article can be the translation of an original article in a different language. This is represented using the translation_of
relationship.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/text/7",
"type": "LinguisticObject",
"_label": "The Birth of Artistic Conception in China",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300048715",
"type": "Type",
"_label": "Article"
}
],
"language": [
{
"id": "http://vocab.getty.edu/aat/300388277",
"type": "Language",
"_label": "English"
}
],
"translation_of": [
{
"type": "LinguisticObject",
"_label": "Zhongguo yishu yijing zhi dansheng",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300048715",
"type": "Type",
"_label": "Article"
}
],
"language": [
{
"id": "http://vocab.getty.edu/aat/300388113",
"type": "Language",
"_label": "Chinese"
}
]
}
]
}