id: https://nde.nl/ontology/hc/class/SubGuideReference
name: sub_guide_reference_class
title: SubGuideReference Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  rico: https://www.ica.org/standards/RiC/ontology#
  dcterms: http://purl.org/dc/terms/
default_prefix: hc
default_range: string
imports:
  - linkml:types
  - ../metadata
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScores
  - ../enums/SubGuideTypeEnum
  - ../slots/is_or_was_access_restricted
  - ../slots/note
  - ../slots/slug
  - ../slots/specificity_annotation
  - ../slots/sub_guide_description
  - ../slots/sub_guide_temporal_coverage
  - ../slots/sub_guide_type
  - ../slots/template_specificity
  - ../slots/title_en
  - ../slots/title_nl
  - ../slots/url

classes:
  SubGuideReference:
    class_uri: rico:FindingAid
    description: |
      Reference to a sub-guide or related finding aid within the same repository.

      Sub-guides are more specific finding aids linked from a repository guide.
      For example, a "Family History" repository guide links to specific sub-guides
      for "Civil Registry", "Notarial Records", etc.
    slots:
      - is_or_was_access_restricted
      - note
      - slug
      - specificity_annotation
      - sub_guide_description
      - sub_guide_temporal_coverage
      - sub_guide_type
      - template_specificity
      - title_en
      - title_nl
      - url
    slot_usage:
      slug:
        description: URL slug identifier
        required: true
      title_nl:
        description: Dutch title
        required: true
      title_en:
        description: English title
      url:
        description: Relative or absolute URL to sub-guide
        required: true
      sub_guide_temporal_coverage:
        description: Time period covered (free text, e.g., "1811-1935", "before 1811")
      sub_guide_description:
        description: Brief description of the sub-guide content
      sub_guide_type:
        description: Type of sub-guide reference
        range: SubGuideTypeEnum
      is_or_was_access_restricted:
        description: Whether access to this sub-guide is restricted
        range: boolean
      note:
        description: Additional notes about this sub-guide reference
      specificity_annotation:
        range: SpecificityAnnotation
        inlined: true
      template_specificity:
        range: TemplateSpecificityScores
        inlined: true
    exact_mappings:
      - rico:isOrWasPartOf

slots:
  title_nl:
    slot_uri: dcterms:title
    description: Dutch title
    range: string
  title_en:
    slot_uri: dcterms:title
    description: English title
    range: string
  sub_guide_temporal_coverage:
    slot_uri: dcterms:temporal
    description: Time period covered by sub-guide (free text)
    range: string
    examples:
      - value: "1811-1935"
      - value: "before 1811"
      - value: "1811-present"
  sub_guide_description:
    slot_uri: dcterms:description
    description: Brief description of sub-guide content
    range: string
  sub_guide_type:
    slot_uri: dcterms:type
    description: Type of sub-guide reference
    range: SubGuideTypeEnum
  is_or_was_access_restricted:
    slot_uri: dcterms:accessRights
    description: Whether access is restricted
    range: boolean