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