id: https://nde.nl/ontology/hc/class/WebLink
name: web_link_class
title: WebLink Class
description: >-
  A hyperlink reference to a web resource.
  Generic class for representing web links with their text, URL, type,
  and contextual information. Used as components within Overview collections
  or any context requiring structured link representation.
  **ONTOLOGY ALIGNMENT**:
  - Schema.org: schema:WebPage (web resource reference)
  - Dublin Core: dcterms:URI (uniform resource identifier)
  - FOAF: foaf:Document (document reference)
  **USE CASES**:
  1. Links extracted from finding aid pages
  2. External resource references
  3. Navigation links within heritage custodian websites
  4. Related resource connections
  **MIGRATION NOTE** (2026-01-14):
  Created as part of slot migration from `all_links` to 
  `has_overview` with `Overview` and `WebLink` typed classes.
  See slot_fixes.yaml for migration specification.
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  dcterms: http://purl.org/dc/terms/
  foaf: http://xmlns.com/foaf/0.1/
  skos: http://www.w3.org/2004/02/skos/core#
imports:
  - linkml:types
  - ../enums/LinkTypeEnum
  - ../slots/has_description
  - ../slots/has_label  # was: title
  - ../slots/has_provenance
  - ../slots/has_score  # was: template_specificity
  - ../slots/has_url
  - ../slots/has_context
  - ../slots/has_text
  - ../slots/has_type
  - ../slots/temporal_extent  # was: valid_from + valid_to
default_prefix: hc
# default_range: string
classes:
  WebLink:
    class_uri: schema:WebPage
    description: >-
      A hyperlink to a web resource with associated metadata.
      **DEFINITION**:
      Represents a web link with its URL, display text, type classification,
      and optional contextual information about where and why the link appears.
      **SCHEMA.ORG ALIGNMENT**:
      Maps to `schema:WebPage` as it represents a reference to a web page
      or web resource.
      **TEMPORAL SEMANTICS**:
      Links can change over time:
      - URLs may become invalid (link rot)
      - Link text or context may be updated
      - Links may be added or removed from pages
      **EXAMPLE**:
      ```yaml
      web_link:
        id: hc:link/findingaid-civil-registry
        url: https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/burgerlijke-stand
        link_text: "Burgerlijke Stand"
        link_type: SUB_GUIDE
        link_context: "Related finding aids for family history research"
      ```
    exact_mappings:
      - schema:WebPage
    close_mappings:
      - foaf:Document
      - dcterms:URI
    slots:
      - has_url  # was: url - migrated per Rule 53 (2025-01-15)
      - has_text
      - has_label  # was: title
      - has_description
      - has_type
      - has_context
      - has_provenance  # was: xpath - migrated per Rule 53 (2026-01-15)
      - temporal_extent  # was: valid_from + valid_to
      - has_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    slot_usage:
      has_url:
        range: uri
        inlined: false # Fixed invalid inline for primitive type
        required: true
      has_text:
#         range: string
      has_label:  # was: title
#         range: string
      has_type:
        range: LinkTypeEnum
      has_context:
#         range: string
      has_provenance:
        range: XPath
        inlined: true
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: >-
        Applicable to all heritage custodian types as web links
        are universal navigation elements.
      custodian_types_primary: "*"
      specificity_score: 0.25
      specificity_rationale: >-
        Very low specificity - fundamental web element applicable
        across all contexts.
    comments:
      - Generic web link representation
      - Used within Overview collections
      - Created from slot_fixes.yaml migration (2026-01-14)
      - 'MIGRATION (2026-01-15): Replaced xpath slot with has_provenance_path using XPath class per slot_fixes.yaml'
    see_also:
      - http://schema.org/WebPage
      - http://xmlns.com/foaf/0.1/Document
    examples:
      - value:
          id: hc:link/na-civil-registry
          url: https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/burgerlijke-stand
          link_text: "Burgerlijke Stand"
          link_type: SUB_GUIDE
          link_context: "Related finding aids section"
      - value:
          id: hc:link/external-genealogy-db
          url: https://www.wiewaswie.nl
          link_text: "WieWasWie"
          link_type: EXTERNAL_RESOURCE