# How Chronicle's terms relate to schema.org's. Not part of the vocabulary:
# only the documentation site and its tests read this file.
#
# chronicle.ttl points each term to the closest schema.org term with SKOS, as
# a hint for mapping data between them. This file holds what those mappings
# cannot say:
#
# - doc:note explains how a Chronicle term differs from the schema.org term
#   it maps to. Write notes by the rules in WRITING.md.
# - doc:unlike marks a schema.org term that has the same name as a Chronicle
#   term but a different meaning. The site's build fails when a Chronicle term
#   shares a name with a schema.org term and neither maps to it nor is unlike
#   it.
#
# The vocabulary node names the schema.org release the mappings were checked
# against. schemaorg.terms.json lists that release's terms; regenerate it with
# scripts/snapshot-vocabulary.js.

@prefix : <https://schema.chronicle.app/> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix doc: <https://schema.chronicle.app/docs/> .
@prefix schemaorg: <https://schema.org/> .

schemaorg: rdfs:label "schema.org";
  doc:prefix "schemaorg";
  doc:release "30.1";
  rdfs:seeAlso <https://schema.org/docs/releases.html#v30.1> .

# Classes

:DateTime doc:note "A :DateTime can also be a date at year, month, or day precision, a date with unspecified digits, or an uncertain date. An instant is always in UTC. A schemaorg:DateTime is a date and a time, and a schemaorg:Date is a date." .
:DeleteAction doc:note "The agent removed the entity itself, such as by moving it to the trash. A schemaorg:DeleteAction edits something by removing one of its objects, such as an item from a list." .
:FindAction doc:unlike schemaorg:FindAction;
  doc:note "A schemaorg:FindAction is finding something, which a search can lead to. Searching is a schemaorg:SearchAction." .
:MoveAction doc:note "A :MoveAction can be a step through an information space, such as following a link from one web page to another. A schemaorg:MoveAction is relocating to a place, from its schemaorg:fromLocation to its schemaorg:toLocation." .
:MonetaryAmount doc:note "One sum. A schemaorg:MonetaryAmount can also be a range, from its schemaorg:minValue to its schemaorg:maxValue." .
:Note doc:note "A :Note is the text itself. A schemaorg:NoteDigitalDocument is a file that holds a note." .
:PayAction doc:note "How much was paid and to whom are on the :FinancialTransaction that is its :result. A schemaorg:PayAction carries them itself, as its schemaorg:price and schemaorg:recipient." .
:PaymentCard doc:note "One card, as issued with its number. A schemaorg:PaymentCard is a way of paying, and can stand for every card of a kind." .
:Project doc:unlike schemaorg:Project;
  doc:note "A schemaorg:Project is an enterprise, a kind of schemaorg:Organization." .
:QuoteAction doc:unlike schemaorg:QuoteAction;
  doc:note "A schemaorg:QuoteAction is giving a price for something, a kind of schemaorg:TradeAction." .
:Thread doc:note "A :Thread can be a chat with a software assistant. A schemaorg:Conversation is between people or organizations." .
:TradeAction doc:note "What was exchanged is on the action's :result. A schemaorg:TradeAction carries its schemaorg:price itself." .
:TravelAction doc:note "The :object is where the travel began, and the :target is where it ended. schema.org gives these as schemaorg:fromLocation and schemaorg:toLocation." .

# Properties

:amount doc:note "On a :FinancialPosting, the :value is signed. schemaorg:amount can also be a plain number, and what a schemaorg:PayAction paid is its schemaorg:price." .
:artist doc:unlike schemaorg:artist;
  doc:note "schemaorg:artist is the primary artist of a comic or a visual artwork. The artist of a recording or an album is its schemaorg:byArtist." .
:attendee doc:note "Includes agents who declined or did not reply. A schemaorg:attendee is someone attending the event." .
:contentPath doc:note "A filesystem path. schemaorg:contentUrl is a URL." .
:contentSize doc:note "A number of bytes. schemaorg:contentSize is text with a unit, such as `2.8 MB`." .
:currency doc:note "An ISO 4217 code. schemaorg:currency also takes a cryptocurrency ticker, and the currency of a schemaorg:PayAction is its schemaorg:priceCurrency." .
:dateCovered doc:note "A date or an interval. schemaorg:temporalCoverage can also be text that names a period, or a URL." .
:distance doc:note "A number of meters, on the :Journey. schemaorg:distance is on the schemaorg:TravelAction and includes a unit, such as `5 km`." .
:exifData doc:note "An object of EXIF tag names and values. schemaorg:exifData is a list of schemaorg:PropertyValue name and value pairs, or text." .
:height doc:note "A number of pixels. schemaorg:height can also be a distance with a unit, such as `5 cm`." .
:isPartOf doc:note "A record can also give the parts of a whole under the inverse name `hasPart`, which schema.org has as schemaorg:hasPart." .
:mimeType doc:note "A MIME type. schemaorg:encodingFormat can also be the URL of a page that defines the format." .
:performer doc:note "A schemaorg:performer is someone who performed at a schemaorg:Event." .
:sameAs doc:note "Links two references to one entity: another entity, or a text reference such as `@me`. schemaorg:sameAs is the URL of a page that identifies the item, such as its Wikipedia article." .
:series doc:note "schemaorg:partOfSeries links an episode, a clip, or a season to its series. Other works, such as a book in a schemaorg:BookSeries, are part of their series through schemaorg:isPartOf." .
:source doc:unlike schemaorg:source;
  doc:note "schemaorg:source is the source or cause of an event." .
:target doc:unlike schemaorg:target;
  doc:note "schemaorg:target is an entry point for carrying out an action, such as a URL template. schema.org names the collection an object is added to its schemaorg:targetCollection, and where a movement ended its schemaorg:toLocation." .
:value doc:note "A number. schemaorg:value can also be text, a boolean, or a structured value." .
:width doc:note "A number of pixels. schemaorg:width can also be a distance with a unit, such as `5 cm`." .
