glam/schemas/20251121/linkml/modules/classes/WebLink.yaml
kempersc ca4a54181e Refactor schema files to improve clarity and maintainability
- Updated WorldCatIdentifier.yaml to remove unnecessary description and ensure consistent formatting.
- Enhanced WorldHeritageSite.yaml by breaking long description into multiple lines for better readability and removed unused attributes.
- Simplified WritingSystem.yaml by removing redundant attributes and ensuring consistent formatting.
- Cleaned up XPathScore.yaml by removing unnecessary attributes and ensuring consistent formatting.
- Improved YoutubeChannel.yaml by breaking long description into multiple lines for better readability.
- Enhanced YoutubeEnrichment.yaml by breaking long description into multiple lines for better readability.
- Updated YoutubeVideo.yaml to break long description into multiple lines and removed legacy field name.
- Refined has_or_had_affiliation.yaml by removing unnecessary comments and ensuring clarity.
- Cleaned up is_or_was_retrieved_at.yaml by removing unnecessary comments and ensuring clarity.
- Added rules for generic slots and avoiding rough edits in schema files to maintain structural integrity.
- Introduced changes_or_changed_through.yaml to define a new slot for linking entities to change events.
2026-01-31 00:46:23 +01:00

137 lines
No EOL
4.8 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_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_or_had_description
- ../slots/has_or_had_label # was: title
- ../slots/has_or_had_provenance_path
- ../slots/has_or_had_score # was: template_specificity
- ../slots/has_or_had_url
- ../slots/link_context
- ../slots/link_text
- ../slots/link_type
- ../slots/specificity_annotation
- ../slots/temporal_extent # was: valid_from + valid_to
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ./TimeSpan
- ./URL
- ./XPath
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_or_had_url # was: url - migrated per Rule 53 (2025-01-15)
- link_text
- has_or_had_label # was: title
- has_or_had_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:
has_or_had_url:
range: uri
inlined: true
required: true
link_text:
range: string
has_or_had_label: # was: title
range: string
link_type:
range: LinkTypeEnum
link_context:
range: string
has_or_had_provenance_path:
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_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"
- value:
id: hc:link/external-genealogy-db
url: https://www.wiewaswie.nl
link_text: "WieWasWie"
link_type: EXTERNAL_RESOURCE