glam/schemas/initial/bibliographic.yaml
2025-11-21 22:12:33 +01:00

1001 lines
26 KiB
YAML

id: https://w3id.org/heritage/custodian/bibliographic
name: heritage-custodian-bibliographic
title: Heritage Custodian Bibliographic Schema
description: >-
Bibliographic classes and slots for scholarly publications, journals, conferences,
and research outputs related to heritage institutions. Integrates SPAR Ontologies
(FaBiO, CiTO, BiBO, DoCO, PRO, PSO) with FRBR-aligned patterns for describing
bibliographic resources, citations, and publishing workflows.
license: https://creativecommons.org/publicdomain/zero/1.0/
version: 0.2.1
prefixes:
linkml: https://w3id.org/linkml/
heritage: https://w3id.org/heritage/custodian/
fabio: http://purl.org/spar/fabio/
cito: http://purl.org/spar/cito/
biro: http://purl.org/spar/biro/
doco: http://purl.org/spar/doco/
pro: http://purl.org/spar/pro/
pso: http://purl.org/spar/pso/
datacite: http://purl.org/spar/datacite/
frbr: http://purl.org/vocab/frbr/core#
dcterms: http://purl.org/dc/terms/
schema: http://schema.org/
bibo: http://purl.org/ontology/bibo/
foaf: http://xmlns.com/foaf/0.1/
prism: http://prismstandard.org/namespaces/basic/3.0/
default_prefix: heritage
default_range: string
imports:
- linkml:types
- enums
- provenance
# =============================================================================
# BIBLIOGRAPHIC CLASSES
# =============================================================================
classes:
# =============================================================================
# ONTOLOGY PROXY CLASSES
# =============================================================================
# These proxy classes enable LinkML validation while maintaining RDF semantic
# alignment with external ontologies (FRBR, BiBO).
FRBRWork:
description: >-
Local proxy for frbr:Work (FRBR Work entity).
Represents the abstract intellectual essence of a work, independent of any
specific expression, manifestation, or item. Used as mixin for ScholarlyWork.
class_uri: frbr:Work
abstract: true
notes: >-
Used by: ScholarlyWork
FRBRExpression:
description: >-
Local proxy for frbr:Expression (FRBR Expression entity).
Represents a specific intellectual or artistic realization of a work (e.g.,
the English translation, the revised edition). Used as mixin for Publication.
class_uri: frbr:Expression
abstract: true
notes: >-
Used by: Publication
BiBOJournal:
description: >-
Local proxy for bibo:Journal (Bibliographic Ontology Journal class).
Represents a scholarly journal or periodical publication.
class_uri: bibo:Journal
abstract: true
notes: >-
Used by: Journal
BiBOConference:
description: >-
Local proxy for bibo:Conference (Bibliographic Ontology Conference class).
Represents an academic conference or symposium.
class_uri: bibo:Conference
abstract: true
notes: >-
Used by: Conference
BiBOBibliographicReference:
description: >-
Local proxy for biro:BibliographicReference (BiRO bibliographic reference).
Represents a bibliographic reference or citation.
class_uri: biro:BibliographicReference
abstract: true
notes: >-
Used by: Citation
# =============================================================================
# MAIN BIBLIOGRAPHIC CLASSES
# =============================================================================
ScholarlyWork:
description: >-
Abstract intellectual creation representing a scholarly work (FRBR Work level).
FaBiO concept for the conceptual essence of a publication, independent of
its specific expressions or manifestations.
class_uri: fabio:Work
mixins:
- FRBRWork
slots:
- work_id
- work_title
- work_subject
- work_keywords
- abstract
- discipline
- research_field
- has_expression
- related_institutions
- provenance
Publication:
description: >-
Concrete realization of a scholarly work (FRBR Expression level).
Represents a specific version or edition of a work with authors, publication date,
and citation metadata. FaBiO Expression pattern.
class_uri: fabio:Expression
mixins:
- FRBRExpression
slots:
- publication_id
- title
- alternative_titles
- publication_type
- authors
- editors
- contributors
- publication_date
- publication_year
- abstract
- keywords
- language
- doi
- url
- published_in
- volume
- issue
- page_range
- article_number
- publisher
- place_of_publication
- isbn
- issn
- citations
- cited_by
- related_works
- document_sections
- open_access_status
- publishing_status
- peer_reviewed
- license
- provenance
slot_usage:
publication_id:
required: true
identifier: true
title:
required: true
publication_type:
required: true
Journal:
description: >-
Academic journal or periodical publication.
FaBiO Journal class representing a continuing resource published in serial fashion.
class_uri: fabio:Journal
mixins:
- BiBOJournal
slots:
- journal_id
- journal_title
- alternative_journal_titles
- issn
- eissn
- publisher
- journal_url
- impact_factor
- cite_score
- subject_areas
- open_access_status
- indexing_services
- provenance
slot_usage:
journal_id:
required: true
identifier: true
journal_title:
required: true
Conference:
description: >-
Academic conference or symposium.
FaBiO AcademicProceedings representing a collection of conference papers.
class_uri: fabio:AcademicProceedings
mixins:
- BiBOConference
slots:
- conference_id
- conference_name
- conference_acronym
- conference_date
- conference_location
- conference_url
- proceedings_title
- proceedings_isbn
- proceedings_publisher
- editors
- provenance
slot_usage:
conference_id:
required: true
identifier: true
conference_name:
required: true
Person:
description: >-
Person involved in scholarly publishing (author, editor, reviewer).
FOAF Person with PRO publishing roles.
class_uri: foaf:Person
slots:
- person_id
- person_name
- given_name
- family_name
- orcid
- email
- affiliation
- roles
slot_usage:
person_id:
required: true
identifier: true
person_name:
required: true
Organization:
description: >-
Organization involved in publishing (publisher, institutional affiliation).
Schema.org Organization for bibliographic contexts.
class_uri: schema:Organization
slots:
- organization_id
- organization_name
- organization_type
- location
- homepage
- ror_id
slot_usage:
organization_id:
required: true
identifier: true
organization_name:
required: true
Citation:
description: >-
Citation relationship between two publications.
CiTO Citation characterizing how one work cites another.
class_uri: cito:Citation
mixins:
- BiBOBibliographicReference
slots:
- citation_id
- citing_work
- cited_work
- citation_type
- citation_intent
- citation_context
- page_number
slot_usage:
citation_id:
required: true
identifier: true
citing_work:
required: true
cited_work:
required: true
citation_type:
required: true
DocumentSection:
description: >-
Structural section or component of a document.
DoCO Document Component representing abstract, introduction, methods, etc.
class_uri: doco:Section
slots:
- section_id
- section_title
- section_type
- section_content
- section_order
slot_usage:
section_id:
required: true
identifier: true
PublishingRole:
description: >-
Role of a person or organization in the publishing process.
PRO Publishing Role (author, editor, reviewer, publisher).
class_uri: pro:PublishingRole
slots:
- role_type
- role_holder
- role_context
slot_usage:
role_type:
required: true
role_holder:
required: true
# =============================================================================
# SLOTS
# =============================================================================
slots:
# ScholarlyWork fields
work_id:
description: Unique identifier for this scholarly work (FRBR Work)
range: uriorcurie
identifier: true
slot_uri: dcterms:identifier
work_title:
description: Title of the scholarly work at the Work level
range: string
slot_uri: dcterms:title
work_subject:
description: Subject of the scholarly work
range: string
multivalued: true
slot_uri: dcterms:subject
work_keywords:
description: Keywords describing the work
range: string
multivalued: true
slot_uri: schema:keywords
discipline:
description: Academic discipline (e.g., Computer Science, Library Science)
range: string
multivalued: true
research_field:
description: Specific research field (e.g., Knowledge Graphs, Ontology Engineering)
range: string
multivalued: true
has_expression:
description: Link to specific expressions/publications of this work
range: Publication
multivalued: true
slot_uri: frbr:realization
related_institutions:
description: Heritage institutions mentioned or studied in this work
range: HeritageCustodian
multivalued: true
inlined: false
# Publication fields
publication_id:
description: Unique identifier for this publication (DOI, URI, or generated ID)
range: uriorcurie
identifier: true
slot_uri: dcterms:identifier
title:
description: Title of the publication
range: string
slot_uri: dcterms:title
alternative_titles:
description: Alternative titles or subtitles
range: string
multivalued: true
slot_uri: dcterms:alternative
publication_type:
description: Type of publication
range: PublicationTypeEnum
slot_uri: dcterms:type
authors:
description: Authors of the publication
range: Person
multivalued: true
inlined: true
inlined_as_list: true
slot_uri: dcterms:creator
editors:
description: Editors of the publication
range: Person
multivalued: true
inlined: true
inlined_as_list: true
slot_uri: bibo:editor
contributors:
description: Other contributors to the publication
range: Person
multivalued: true
inlined: true
inlined_as_list: true
slot_uri: dcterms:contributor
publication_date:
description: Full publication date
range: date
slot_uri: dcterms:issued
publication_year:
description: Year of publication
range: integer
slot_uri: prism:publicationDate
abstract:
description: Abstract or summary of the publication
range: string
slot_uri: dcterms:abstract
keywords:
description: Keywords or subject terms
range: string
multivalued: true
slot_uri: prism:keyword
language:
description: Language of the publication (ISO 639-1 or 639-3 code)
range: string
slot_uri: dcterms:language
doi:
description: Digital Object Identifier
range: string
pattern: "^10\\.\\d{4,9}/[-._;()/:A-Za-z0-9]+$"
slot_uri: datacite:doi
url:
description: URL to the publication
range: uri
slot_uri: schema:url
published_in:
description: Journal or venue where published
range: Journal
inlined: false
slot_uri: dcterms:isPartOf
volume:
description: Volume number
range: string
slot_uri: prism:volume
issue:
description: Issue number
range: string
slot_uri: prism:number
page_range:
description: Page range (e.g., "123-145")
range: string
slot_uri: prism:pageRange
article_number:
description: Article number (for journals that use article numbers instead of pages)
range: string
publisher:
description: Publisher of the work
range: Organization
inlined: true
slot_uri: dcterms:publisher
place_of_publication:
description: City or location of publication
range: string
slot_uri: prism:location
isbn:
description: International Standard Book Number
range: string
pattern: "^(97[89])?[0-9]{9}[0-9X]$"
slot_uri: bibo:isbn
issn:
description: International Standard Serial Number
range: string
pattern: "^\\d{4}-\\d{3}[\\dX]$"
slot_uri: bibo:issn
eissn:
description: Electronic ISSN
range: string
pattern: "^\\d{4}-\\d{3}[\\dX]$"
slot_uri: fabio:hasElectronicISSN
citations:
description: Works cited by this publication
range: Citation
multivalued: true
inlined: true
inlined_as_list: true
slot_uri: cito:cites
cited_by:
description: Works that cite this publication
range: Citation
multivalued: true
inlined: false
slot_uri: cito:isCitedBy
related_works:
description: Related publications or works
range: Publication
multivalued: true
inlined: false
slot_uri: dcterms:relation
document_sections:
description: Structural sections of the document
range: DocumentSection
multivalued: true
inlined: true
inlined_as_list: true
open_access_status:
description: Open access availability
range: OpenAccessStatusEnum
slot_uri: fabio:hasOpenAccessStatus
publishing_status:
description: Status in the publishing workflow
range: PublishingStatusEnum
slot_uri: pso:holdsStatusInTime
peer_reviewed:
description: Whether the publication was peer-reviewed
range: boolean
slot_uri: fabio:hasPeerReviewStatus
license:
description: License or rights statement
range: string
slot_uri: dcterms:license
# Journal fields
journal_id:
description: Unique identifier for this journal
range: uriorcurie
identifier: true
slot_uri: dcterms:identifier
journal_title:
description: Official title of the journal
range: string
slot_uri: dcterms:title
alternative_journal_titles:
description: Alternative journal titles or abbreviations
range: string
multivalued: true
slot_uri: dcterms:alternative
journal_url:
description: URL to the journal homepage
range: uri
slot_uri: schema:url
impact_factor:
description: Journal Impact Factor (JIF)
range: float
cite_score:
description: Scopus CiteScore
range: float
subject_areas:
description: Subject areas or disciplines covered by the journal
range: string
multivalued: true
slot_uri: dcterms:subject
indexing_services:
description: Indexing services (e.g., Web of Science, Scopus, DOAJ)
range: string
multivalued: true
# Conference fields
conference_id:
description: Unique identifier for this conference
range: uriorcurie
identifier: true
slot_uri: dcterms:identifier
conference_name:
description: Full name of the conference
range: string
slot_uri: schema:name
conference_acronym:
description: Conference acronym or abbreviation
range: string
conference_date:
description: Date(s) of the conference
range: string
slot_uri: schema:startDate
conference_location:
description: Location where conference was held
range: string
slot_uri: schema:location
conference_url:
description: Conference website URL
range: uri
slot_uri: schema:url
proceedings_title:
description: Title of the conference proceedings
range: string
proceedings_isbn:
description: ISBN of the proceedings volume
range: string
proceedings_publisher:
description: Publisher of the proceedings
range: Organization
inlined: true
# Person fields
person_id:
description: Unique identifier for this person (ORCID, URI, or generated ID)
range: uriorcurie
identifier: true
slot_uri: dcterms:identifier
person_name:
description: Full name of the person
range: string
slot_uri: foaf:name
given_name:
description: Given name or first name
range: string
slot_uri: foaf:givenName
family_name:
description: Family name or surname
range: string
slot_uri: foaf:familyName
orcid:
description: ORCID identifier
range: string
pattern: "^\\d{4}-\\d{4}-\\d{4}-\\d{3}[0-9X]$"
slot_uri: datacite:orcid
# email: defined in core.yaml (slot_uri: schema:email)
# Reusing email slot from core module to avoid slot_uri conflicts
affiliation:
description: Institutional affiliation
range: Organization
inlined: true
slot_uri: schema:affiliation
roles:
description: Publishing roles held by this person
range: PublishingRole
multivalued: true
inlined: true
inlined_as_list: true
# Organization fields
organization_id:
description: Unique identifier for this organization
range: uriorcurie
identifier: true
slot_uri: dcterms:identifier
organization_name:
description: Name of the organization
range: string
slot_uri: schema:name
organization_type:
description: Type of organization
range: string
slot_uri: schema:additionalType
location:
description: Location of the organization
range: string
slot_uri: schema:location
# NOTE: 'homepage' slot removed - duplicate of core.yaml definition
# Use the canonical slot from core.yaml (slot_uri: foaf:homepage)
ror_id:
description: Research Organization Registry (ROR) identifier
range: string
pattern: "^https://ror\\.org/0[a-z0-9]{6}[0-9]{2}$"
# Citation fields
citation_id:
description: Unique identifier for this citation relationship
range: uriorcurie
identifier: true
slot_uri: dcterms:identifier
citing_work:
description: The work that contains the citation
range: Publication
inlined: false
slot_uri: cito:hasCitingEntity
cited_work:
description: The work being cited
range: Publication
inlined: false
slot_uri: cito:hasCitedEntity
citation_type:
description: Type of citation relationship
range: CitationTypeEnum
slot_uri: cito:hasCitationCharacterization
citation_intent:
description: Intent or purpose of the citation
range: string
slot_uri: cito:hasCitationIntent
citation_context:
description: Textual context around the citation
range: string
page_number:
description: Page number where citation appears
range: string
# DocumentSection fields
section_id:
description: Unique identifier for this document section
range: uriorcurie
identifier: true
slot_uri: dcterms:identifier
section_title:
description: Title of the section
range: string
slot_uri: dcterms:title
section_type:
description: Type of document section
range: DocumentSectionTypeEnum
slot_uri: dcterms:type
section_content:
description: Content of the section
range: string
section_order:
description: Sequential order of section in document
range: integer
# PublishingRole fields
role_type:
description: Type of publishing role
range: PublishingRoleTypeEnum
slot_uri: pro:withRole
role_holder:
description: Person or organization holding this role
range: Person
inlined: false
slot_uri: pro:isHeldBy
role_context:
description: Context in which role is held
range: string
# =============================================================================
# ENUMERATIONS
# =============================================================================
enums:
PublicationTypeEnum:
description: Types of scholarly publications
permissible_values:
JOURNAL_ARTICLE:
description: Article published in an academic journal
meaning: fabio:JournalArticle
CONFERENCE_PAPER:
description: Paper presented at a conference
meaning: fabio:ConferencePaper
BOOK:
description: Scholarly book or monograph
meaning: fabio:Book
BOOK_CHAPTER:
description: Chapter in an edited book
meaning: fabio:BookChapter
THESIS:
description: Thesis or dissertation
meaning: fabio:Thesis
TECHNICAL_REPORT:
description: Technical report or white paper
meaning: fabio:TechnicalReport
REVIEW_ARTICLE:
description: Review or survey article
meaning: fabio:ReviewArticle
EDITORIAL:
description: Editorial or opinion piece
meaning: fabio:Editorial
PREPRINT:
description: Preprint or working paper
meaning: fabio:Preprint
DATASET:
description: Research dataset
meaning: fabio:Dataset
SOFTWARE:
description: Software or code
meaning: schema:SoftwareApplication
POSTER:
description: Conference poster
meaning: fabio:Poster
PRESENTATION:
description: Presentation slides
meaning: fabio:Presentation
CitationTypeEnum:
description: Types of citation relationships (CiTO)
permissible_values:
CITES:
description: Generic citation
meaning: cito:cites
CITES_AS_AUTHORITY:
description: Cites as authoritative source
meaning: cito:citesAsAuthority
CITES_AS_EVIDENCE:
description: Cites as evidence
meaning: cito:citesAsEvidence
CITES_AS_METADATA:
description: Cites for metadata or provenance
meaning: cito:citesAsMetadataDocument
DISCUSSES:
description: Discusses the cited work
meaning: cito:discusses
EXTENDS:
description: Extends the cited work
meaning: cito:extends
SUPPORTS:
description: Provides support for claims in cited work
meaning: cito:supports
REFUTES:
description: Refutes or disputes cited work
meaning: cito:disputes
CRITIQUES:
description: Critiques cited work
meaning: cito:critiques
AGREES_WITH:
description: Agrees with cited work
meaning: cito:agreesWith
DISAGREES_WITH:
description: Disagrees with cited work
meaning: cito:disagreesWith
REVIEWS:
description: Reviews the cited work
meaning: cito:reviews
USES_METHOD_IN:
description: Uses methodology from cited work
meaning: cito:usesMethodIn
USES_DATA_FROM:
description: Uses data from cited work
meaning: cito:usesDataFrom
OpenAccessStatusEnum:
description: Open access availability status
permissible_values:
FULLY_OPEN_ACCESS:
description: Freely available to all readers
meaning: fabio:OpenAccess
OPEN_ACCESS_REPOSITORY:
description: Available via institutional or subject repository
meaning: fabio:GreenOpenAccess
HYBRID_OPEN_ACCESS:
description: Published in subscription journal with OA option
meaning: fabio:HybridOpenAccess
CLOSED_ACCESS:
description: Subscription or paywall access only
meaning: fabio:ClosedAccess
EMBARGOED:
description: Will become open access after embargo period
meaning: fabio:EmbargoedAccess
BRONZE_OPEN_ACCESS:
description: Free to read but without clear license
meaning: fabio:BronzeOpenAccess
PublishingStatusEnum:
description: Status in the publishing workflow (PSO)
permissible_values:
SUBMITTED:
description: Submitted to journal/conference
meaning: pso:submitted
UNDER_REVIEW:
description: Under peer review
meaning: pso:under-review
ACCEPTED:
description: Accepted for publication
meaning: pso:accepted
IN_PRESS:
description: In press, awaiting publication
meaning: pso:in-press
PUBLISHED:
description: Published and available
meaning: pso:published
REJECTED:
description: Rejected by publisher
meaning: pso:rejected
WITHDRAWN:
description: Withdrawn by author(s)
meaning: pso:withdrawn
RETRACTED:
description: Retracted by publisher
meaning: pso:retracted
DocumentSectionTypeEnum:
description: Types of document sections (DoCO)
permissible_values:
ABSTRACT:
description: Abstract or summary
meaning: doco:Abstract
INTRODUCTION:
description: Introduction section
meaning: doco:Introduction
METHODS:
description: Methods or methodology section
meaning: doco:Methods
RESULTS:
description: Results section
meaning: doco:Results
DISCUSSION:
description: Discussion section
meaning: doco:Discussion
CONCLUSION:
description: Conclusion section
meaning: doco:Conclusion
ACKNOWLEDGMENTS:
description: Acknowledgments section
meaning: doco:Acknowledgments
BIBLIOGRAPHY:
description: Bibliography or references
meaning: doco:Bibliography
APPENDIX:
description: Appendix or supplementary material
meaning: doco:Appendix
PublishingRoleTypeEnum:
description: Roles in the publishing process (PRO)
permissible_values:
AUTHOR:
description: Author of the work
meaning: pro:author
EDITOR:
description: Editor
meaning: pro:editor
REVIEWER:
description: Peer reviewer
meaning: pro:reviewer
TRANSLATOR:
description: Translator
meaning: pro:translator
ILLUSTRATOR:
description: Illustrator
meaning: pro:illustrator
CONTRIBUTOR:
description: General contributor
meaning: dcterms:contributor
CORRESPONDING_AUTHOR:
description: Corresponding author
meaning: pro:corresponding-author
PUBLISHER:
description: Publisher
meaning: pro:publisher
SERIES_EDITOR:
description: Series editor
meaning: pro:series-editor