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

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_or_had_comprehensive_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
  - ../slots/id
  - ../slots/description
  # REMOVED: ../slots/url - migrated to has_or_had_url with URL class (2025-01-15, Rule 53)
  - ../slots/has_or_had_url
  - ./URL
  - ../slots/has_or_had_label  # was: title - migrated per Rule 53
  - ../slots/link_text
  - ../slots/link_type
  - ../slots/link_context
  - ../slots/xpath
  # ARCHIVED: ../slots/valid_from - use temporal_extent instead
  # ARCHIVED: ../slots/valid_to - use temporal_extent instead
  - ../slots/temporal_extent  # was: valid_from + valid_to
  - ../slots/specificity_annotation
  - ../slots/template_specificity
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScores
  - ../enums/LinkTypeEnum
  - ./TimeSpan

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:
      - id
      - has_or_had_url  # was: url - migrated per Rule 53 (2025-01-15)
      - link_text
      - has_or_had_label  # was: title
      - description
      - link_type
      - link_context
      - xpath
      - temporal_extent  # was: valid_from + valid_to
      - specificity_annotation
      - template_specificity
    
    slot_usage:
      id:
        identifier: true
        range: uriorcurie
      has_or_had_url:
        range: URL
        inlined: true
        required: true
        description: >-
          The URL of the web resource.
          MIGRATED from url slot per slot_fixes.yaml (Rule 53, 2025-01-15).          
      link_text:
        range: string
        description: >-
          The visible text of the hyperlink.          
      has_or_had_label:  # was: title
        range: string
        description: >-
          Title attribute of the link (if available).          
      description:
        range: string
        description: >-
          Human-readable description of the link's purpose or destination.          
      link_type:
        range: LinkTypeEnum
        description: >-
          Classification of the link type.          
      link_context:
        range: string
        description: >-
          The surrounding text or context where the link appears.          
      xpath:
        range: string
        description: >-
          XPath location of the link in the source HTML (for provenance).          
    
    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)
    
    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"
        description: Link to a sub-guide within the same repository
      
      - value:
          id: hc:link/external-genealogy-db
          url: https://www.wiewaswie.nl
          link_text: "WieWasWie"
          link_type: EXTERNAL_RESOURCE
          description: "Dutch genealogical database"
        description: External resource link