glam/schemas/20251121/linkml/modules/classes/WebLink.yaml
kempersc 6c3fa6b5a3 Remove deprecated slots and add new slot definitions for enhanced data modeling
- Deleted obsolete slot definitions for work_location and workshop_space.
- Introduced new TaxonName class to represent scientific taxonomic names with detailed attributes.
- Archived existing slots related to surname_prefix, target_name, taxon_name, terminal_count, text_region_count, title, title_proper, total_chapter, total_characters_extracted, total_connections_extracted, track_name, transcript_format, traveling_venue, type_label, type_status, typical_responsibility, unesco_domain, unesco_inscription_year, unesco_list_status, uniform_title, unit_name, used_by_custodian, uv_filtered_required, valid_from_geo, valid_to_geo, validation_status, variant_of_name, verification_date, viability_status, within_auxiliary_place, and within_place.
- Updated slot descriptions and structures to improve clarity and compliance with standards.
2026-01-15 11:42:35 +01:00

176 lines
5.2 KiB
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
- ../slots/url
- ../slots/has_or_had_label # was: title - migrated per Rule 53
- ../slots/link_text
- ../slots/link_type
- ../slots/link_context
- ../slots/xpath
- ../slots/valid_from
- ../slots/valid_to
- ../slots/specificity_annotation
- ../slots/template_specificity
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
- ../enums/LinkTypeEnum
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
- url
- link_text
- has_or_had_label # was: title
- description
- link_type
- link_context
- xpath
- valid_from
- valid_to
- specificity_annotation
- template_specificity
slot_usage:
id:
identifier: true
range: uriorcurie
url:
range: uri
required: true
description: >-
The URL of the web resource.
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