glam/schemas/20251121/linkml/modules/classes/Caption.yaml

81 lines
2.8 KiB
YAML

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
- ./Label
default_prefix: hc
classes:
Caption:
class_uri: schema: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.'
exact_mappings:
- schema:caption
slots:
- has_or_had_label
- language
slot_usage:
has_or_had_label:
range: Label
required: false
inlined: true
description: Caption text content. Label.has_or_had_text contains the actual caption.
language:
range: string
required: false
description: ISO 639-1 language code for the caption (e.g., "en", "nl", "de").
attributes:
caption_format:
range: string
required: false
description: Caption format (e.g., "SRT", "VTT", "TTML", "closed_caption", "open_caption").
is_available:
range: boolean
required: false
description: Whether captions are available for this media. Replaces simple caption_available boolean/string.
caption_url:
range: uri
required: false
description: URL to external caption file (for SRT, VTT, etc.).
examples:
- value:
is_available: true
language: en
caption_format: closed_caption
description: English closed captions available
- value:
is_available: true
language: nl
caption_format: SRT
caption_url: https://example.org/video/captions_nl.srt
description: Dutch subtitles in SRT format
- value:
has_or_had_label:
has_or_had_text: Video beschrijving voor slechthorenden
language: nl
is_available: true
description: Dutch caption with descriptive text
annotations:
specificity_score: 0.6
specificity_rationale: Captions are specific to media content, moderately relevant for digital heritage.
custodian_types: "['*']"
custodian_types_rationale: Universal utility concept