id: https://nde.nl/ontology/hc/class/Language
name: Language
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  dct: http://purl.org/dc/terms/
  rdf: http://www.w3.org/1999/02/22-rdf-syntax-ns#
  schema: http://schema.org/
  dcterms: http://purl.org/dc/terms/
  prov: http://www.w3.org/ns/prov#
  crm: http://www.cidoc-crm.org/cidoc-crm/
  skos: http://www.w3.org/2004/02/skos/core#
  rdfs: http://www.w3.org/2000/01/rdf-schema#
  org: http://www.w3.org/ns/org#
  xsd: http://www.w3.org/2001/XMLSchema#
imports:
  - linkml:types
  - ../slots/has_code
  - ../slots/has_text
  - ../slots/has_label
classes:
  Language:
    class_uri: dct:LinguisticSystem
    description: 'A language with ISO codes and optional text content.


      **Purpose**:

      Represents a language entity that can identify the language of text content.

      Used for language-tagged text where the language code and content are bundled together.


      **Use Cases**:

      1. Language identification only (just codes, no content)

      2. Language-tagged text (codes + text_content for multilingual data)


      **Migration Support**:

      This class supports migration from language-specific text slots (fr, de, en, nl)

      to a unified `has_language` + `Language` pattern per slot_fixes.yaml.


      **Ontological Alignment**:

      - **Primary**: `dct:LinguisticSystem` - Dublin Core linguistic system

      - **Close**: `schema:Language` - Schema.org language

      '
    exact_mappings:
    - dct:LinguisticSystem
    close_mappings:
    - schema:Language
    slots:
    - has_code
    - has_language
    - has_language
    - has_text
    - has_label
    slot_usage:
      has_label:
        description: 'Human-readable name of the language (e.g., "English", "Dutch", "French"). Parsed from raw string, not authoritative. Use ISO codes for formal identification.'
      has_text:
        description: "Text content in this language. Used when bundling language identification with the actual text content."
    examples:
    - value: 'has_iso_code639_1: "fr"

        has_label: "French"

        has_text: "archives universitaires"

        '
      description: French language-tagged text for multilingual label
    - value: 'has_iso_code639_1: "en"

        has_label: "English"

        '
      description: English language identifier (without text content)
    - value: 'has_iso_code639_1: "nl"

        has_label: "Dutch"

        has_text: "universitair archief"

        '
      description: Dutch language-tagged text
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: "['*']"