191 lines
6.3 KiB
YAML
191 lines
6.3 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
|
|
# 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
|