%YAML 1.2
---
lang: en-US

type: structure

uri: https://gedcom.io/terms/v7/SOUR

standard tag: 'SOUR'

specification:
  - Source
  - A description of the relevant part of a source to support the superstructure's
    data. See `SOURCE_CITATION` for more details.
  - |
    A citation indicating that the pointed-to source record supports the claims
    made in the superstructure. Substructures provide additional information about
    how that source applies to the subject of the citation's superstructure:
    
    - `PAGE`: where in the source the relevant material can be found.
    - `DATA`: the relevant data from the source.
    - `EVEN`: what event the relevant material was recording.
    - `QUAY`: an estimation of the reliability of the source in regard to these
      claims.
    - `MULTIMEDIA_LINK`: digital copies of the cited part of the source
    
    It is recommended that every `SOURCE_CITATION` point to a `SOURCE_RECORD`.
    However, a `voidPtr` can be used with the citation text in a `PAGE`
    substructure. The `PAGE` is defined to express a "specific location within the
    information referenced;" with a `voidPtr` there is no information referenced,
    so the `PAGE` may describe the entire source.
    
    A `SOURCE_CITATION` can contain a `NOTE_STRUCTURE`, which in turn can contain a
    `SOURCE_CITATION`, allowing potentially unbounded nesting of structures.
    Because each dataset is finite, this nesting is also guaranteed to be finite.

label: 'Source'

payload: "@<https://gedcom.io/terms/v7/record-SOUR>@"

substructures:
  "https://gedcom.io/terms/v7/NOTE": "{0:M}"
  "https://gedcom.io/terms/v7/OBJE": "{0:M}"
  "https://gedcom.io/terms/v7/PAGE": "{0:1}"
  "https://gedcom.io/terms/v7/QUAY": "{0:1}"
  "https://gedcom.io/terms/v7/SNOTE": "{0:M}"
  "https://gedcom.io/terms/v7/SOUR-DATA": "{0:1}"
  "https://gedcom.io/terms/v7/SOUR-EVEN": "{0:1}"

superstructures:
  "https://gedcom.io/terms/v7/ADOP": "{0:M}"
  "https://gedcom.io/terms/v7/ANUL": "{0:M}"
  "https://gedcom.io/terms/v7/ASSO": "{0:M}"
  "https://gedcom.io/terms/v7/BAPL": "{0:M}"
  "https://gedcom.io/terms/v7/BAPM": "{0:M}"
  "https://gedcom.io/terms/v7/BARM": "{0:M}"
  "https://gedcom.io/terms/v7/BASM": "{0:M}"
  "https://gedcom.io/terms/v7/BIRT": "{0:M}"
  "https://gedcom.io/terms/v7/BLES": "{0:M}"
  "https://gedcom.io/terms/v7/BURI": "{0:M}"
  "https://gedcom.io/terms/v7/CAST": "{0:M}"
  "https://gedcom.io/terms/v7/CHR": "{0:M}"
  "https://gedcom.io/terms/v7/CHRA": "{0:M}"
  "https://gedcom.io/terms/v7/CONF": "{0:M}"
  "https://gedcom.io/terms/v7/CONL": "{0:M}"
  "https://gedcom.io/terms/v7/CREM": "{0:M}"
  "https://gedcom.io/terms/v7/DEAT": "{0:M}"
  "https://gedcom.io/terms/v7/DIV": "{0:M}"
  "https://gedcom.io/terms/v7/DIVF": "{0:M}"
  "https://gedcom.io/terms/v7/DSCR": "{0:M}"
  "https://gedcom.io/terms/v7/EDUC": "{0:M}"
  "https://gedcom.io/terms/v7/EMIG": "{0:M}"
  "https://gedcom.io/terms/v7/ENDL": "{0:M}"
  "https://gedcom.io/terms/v7/ENGA": "{0:M}"
  "https://gedcom.io/terms/v7/FAM-CENS": "{0:M}"
  "https://gedcom.io/terms/v7/FAM-EVEN": "{0:M}"
  "https://gedcom.io/terms/v7/FAM-FACT": "{0:M}"
  "https://gedcom.io/terms/v7/FAM-NCHI": "{0:M}"
  "https://gedcom.io/terms/v7/FAM-RESI": "{0:M}"
  "https://gedcom.io/terms/v7/FCOM": "{0:M}"
  "https://gedcom.io/terms/v7/GRAD": "{0:M}"
  "https://gedcom.io/terms/v7/IDNO": "{0:M}"
  "https://gedcom.io/terms/v7/IMMI": "{0:M}"
  "https://gedcom.io/terms/v7/INDI-CENS": "{0:M}"
  "https://gedcom.io/terms/v7/INDI-EVEN": "{0:M}"
  "https://gedcom.io/terms/v7/INDI-FACT": "{0:M}"
  "https://gedcom.io/terms/v7/INDI-NAME": "{0:M}"
  "https://gedcom.io/terms/v7/INDI-NCHI": "{0:M}"
  "https://gedcom.io/terms/v7/INDI-RELI": "{0:M}"
  "https://gedcom.io/terms/v7/INDI-RESI": "{0:M}"
  "https://gedcom.io/terms/v7/INDI-TITL": "{0:M}"
  "https://gedcom.io/terms/v7/INIL": "{0:M}"
  "https://gedcom.io/terms/v7/MARB": "{0:M}"
  "https://gedcom.io/terms/v7/MARC": "{0:M}"
  "https://gedcom.io/terms/v7/MARL": "{0:M}"
  "https://gedcom.io/terms/v7/MARR": "{0:M}"
  "https://gedcom.io/terms/v7/MARS": "{0:M}"
  "https://gedcom.io/terms/v7/NATI": "{0:M}"
  "https://gedcom.io/terms/v7/NATU": "{0:M}"
  "https://gedcom.io/terms/v7/NMR": "{0:M}"
  "https://gedcom.io/terms/v7/NO": "{0:M}"
  "https://gedcom.io/terms/v7/NOTE": "{0:M}"
  "https://gedcom.io/terms/v7/OCCU": "{0:M}"
  "https://gedcom.io/terms/v7/ORDN": "{0:M}"
  "https://gedcom.io/terms/v7/PROB": "{0:M}"
  "https://gedcom.io/terms/v7/PROP": "{0:M}"
  "https://gedcom.io/terms/v7/RETI": "{0:M}"
  "https://gedcom.io/terms/v7/SLGC": "{0:M}"
  "https://gedcom.io/terms/v7/SLGS": "{0:M}"
  "https://gedcom.io/terms/v7/SSN": "{0:M}"
  "https://gedcom.io/terms/v7/WILL": "{0:M}"
  "https://gedcom.io/terms/v7/record-FAM": "{0:M}"
  "https://gedcom.io/terms/v7/record-INDI": "{0:M}"
  "https://gedcom.io/terms/v7/record-OBJE": "{0:M}"
  "https://gedcom.io/terms/v7/record-SNOTE": "{0:M}"

contact: "https://gedcom.io/community/"
...