feat: add Bibliography dataset model (V3 glossarist dataset syntax)#58
Merged
Conversation
bibliography.yaml is a single-key YAML mapping (bibliography:) whose value is an array of typed BibliographyEntry items — the V3 glossarist dataset syntax for a collection file. Each entry carries its own id; the collection is not keyed by reference string and is not a stray top-level array. - models/concepts/BibliographyEntry.lutaml: typed entry (id, reference, title, link, type). - models/concepts/BibliographyData.lutaml: the file wrapper (bibliography: BibliographyEntry [0..*]). - schemas/v3/bibliography.yaml: JSON schema (validated). - README.adoc: documents the format.
…VerbRep parity Aligns concept-model with the glossarist-ruby non-verbal refactor. Two-level hierarchy above the leaves: - NonVerbalEntity (abstract): 4 shared a11y/provenance fields (caption, description, alt, sources). No id, no identifier. - SharedNonVerbalEntity < NonVerbalEntity: adds id + identifier for dataset-shared entities. Figure, Table, Formula now extend SharedNonVerbalEntity (was NonVerbalEntity directly). NonVerbRep extends NonVerbalEntity directly — concept-local, positional, no dataset identity. NonVerbRep reshape (parity with Figure): - was: image/table/formula as 3 separate BasicDocument refs + sources - now: type discriminator + images[] (FigureImage variants) + inherited caption/description/alt/sources New files: - SharedNonVerbalEntity.lutaml - NonVerbalType.lutaml (enum: image, table, formula) README: new "Non-verbal entities" section documents both coexistence levels (concept-local NonVerbRep, dataset-shared Figure/Table/Formula) and the two-level hierarchy.
ffceec3 to
5218239
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds the
bibliography.yamldataset model to the concept model, using the V3 glossarist dataset syntax: a single-key YAML mapping (bibliography:) whose value is an array of typedBibliographyEntryitems. No stray top-level array, no keyed map — each entry carries its ownid.Changes
models/concepts/BibliographyEntry.lutaml— typed entry (id, reference, title, link, type).models/concepts/BibliographyData.lutaml— the file wrapper (bibliography: BibliographyEntry [0..*]).schemas/v3/bibliography.yaml— JSON Schema (validated withjsonschema: sample passes, negative test rejected).README.adoc— new== Bibliographysection.Companion PR: glossarist/glossarist-ruby#186 (implementation).