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 # REMOVED: ../slots/xpath - migrated to has_or_had_provenance_path with XPath class (2026-01-15, Rule 53) - ../slots/has_or_had_provenance_path - ./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/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17) - ./SpecificityAnnotation - ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17) - ./TemplateSpecificityType - ./TemplateSpecificityTypes - ../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 - has_or_had_provenance_path # was: xpath - migrated per Rule 53 (2026-01-15) - temporal_extent # was: valid_from + valid_to - specificity_annotation - has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17) slot_usage: id: identifier: true required: 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. has_or_had_provenance_path: range: XPath inlined: true description: >- XPath provenance path documenting the exact location of the link in the source HTML. MIGRATED from xpath slot per slot_fixes.yaml (Rule 53, 2026-01-15). 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_or_had_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" 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