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

97 lines
3 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.60
specificity_rationale: >-
Captions are specific to media content, moderately relevant for digital heritage.