glam/schemas/20251121/linkml/modules/classes/WebLink.yaml
kempersc d37a120ef2 Refactor schema definitions across multiple classes to improve clarity and consistency
- Removed unnecessary aliases and adjusted slot definitions in Timestamp, Topic, TopicType, TransferEvent, TransferPolicy, and others.
- Enhanced descriptions and added alternative language descriptions for TradeUnionArchiveRecordSetType and UnescoIchElement.
- Updated slot usage for various archive-related classes to use `equals_string` instead of `equals_expression`.
- Streamlined VideoChapter class by refining descriptions and restructuring slot usage for better navigation and organization.
- General cleanup of comments and annotations to ensure clarity and maintainability.
2026-02-16 11:17:33 +01:00

149 lines
5.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_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_description
- ../slots/has_label # was: title
- ../slots/has_provenance
- ../slots/has_score # was: template_specificity
- ../slots/has_url
- ../slots/has_context
- ../slots/has_text
- ../slots/has_type
- ../slots/temporal_extent # was: valid_from + valid_to
default_prefix: hc
# default_range: string
classes:
WebLink:
class_uri: schema:WebPage
description: >-
A hyperlink to a web resource with associated metadata.
alt_descriptions:
nl: Een hyperlink naar een webbron met bijbehorende metadata.
de: Ein Hyperlink zu einer Webressource mit zugehörigen Metadaten.
fr: Un hyperlien vers une ressource web avec des métadonnées associées.
es: Un hipervínculo a un recurso web con metadatos asociados.
ar: ارتباط تشعبي إلى مورد ويب مع بيانات وصفية مرتبطة.
id: Tautan ke sumber web dengan metadata terkait.
zh: 带有关联元数据的网页资源超链接。
structured_aliases:
- literal_form: weblink
in_language: nl
- literal_form: Web-Link
in_language: de
- literal_form: lien web
in_language: fr
- literal_form: enlace web
in_language: es
comments:
- Represents web link with URL, display text, type classification, and context.
- Links can change over time (link rot, text updates).
broad_mappings:
- schema:WebPage
close_mappings:
- foaf:Document
- dcterms:URI
slots:
- has_url # was: url - migrated per Rule 53 (2025-01-15)
- has_text
- has_label # was: title
- has_description
- has_type
- has_context
- has_provenance # was: xpath - migrated per Rule 53 (2026-01-15)
- temporal_extent # was: valid_from + valid_to
- has_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
slot_usage:
has_url:
range: uri
inlined: false # Fixed invalid inline for primitive type
required: true
has_text:
# range: string
has_label: # was: title
# range: string
has_type:
range: LinkTypeEnum
has_context:
# range: string
has_provenance:
range: XPath
inlined: true
temporal_extent:
description: 'Validity period for this link (legacy: valid_from/valid_to).'
has_score:
notes:
- |
Preserved from prior description (commit 2c9d3598):
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**:
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.
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
- value: |
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"