id: https://nde.nl/ontology/hc/class/Caption
name: caption_class
title: Caption Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  dcterms: http://purl.org/dc/terms/
imports:
  - linkml:types
  - ../slots/has_or_had_label
  - ../slots/language
default_prefix: hc
classes:
  Caption:
    class_uri: hc:Caption
    description: 'Represents accessibility caption/subtitle information for media
      content. **PURPOSE**: Caption provides structured representation of video/audio
      captions for: - WCAG accessibility compliance - Multilingual subtitle support
      - Caption metadata (language, format, availability) **ONTOLOGY ALIGNMENT**:
      | Ontology | Mapping | Rationale | |----------|---------|-----------| | Schema.org
      | schema:caption | Media caption/subtitle | **USE CASES**: - Video captions
      for hearing accessibility - Subtitles for multilingual content - Closed captions
      vs. open captions distinction MIGRATED 2026-01-22: Created per slot_fixes.yaml
      feedback to replace simple caption_available string with structured class.'
    close_mappings:
    - schema:caption
    slots:
    - has_or_had_label
    - language
    slot_usage:
      has_or_had_label:
#         range: string
        required: false
        inlined: false # Fixed invalid inline for primitive type
      language:
#         range: string
        required: false
    examples:
    - value:
        language: en
    - value:
        language: nl
        caption_url: https://example.org/video/captions_nl.srt
    - value:
        has_or_had_label:
          has_or_had_text: Video beschrijving voor slechthorenden
        language: nl
    annotations:
      specificity_score: 0.6
      specificity_rationale: Captions are specific to media content, moderately relevant
        for digital heritage.
      custodian_types: '[''*'']'