Files
paperspec/spec/10-references.md
alexm 4fa326dc76
check / check (push) Successful in 42s
site / site (push) Successful in 3m4s
First implementation (#1)
Reviewed-on: #1
2026-10-15 05:47:05 -04:00

16 lines
923 B
Markdown

# 10. References and citations
Each reference is a `reference` node holding its printed runs, exactly as printed, and its printed number as its `label`.
`references.jsonl` holds, for each reference node in document order, a record with `node`, `label`, an optional parsed `csl` record in CSL-JSON, and its `resolution`:
| Resolution | Means |
| --- | --- |
| `{type: "doi", doi}` | The reference names a DOI. |
| `{type: "document", doc}` | It names a document in the same store, by key. |
| `{type: "none"}` | Nothing yet. |
Every `cite` run links a sentence to one or more references.
The citation graph is therefore sentence-level: for any reference, the format gives every sentence that cites it, which is the citation's context.
The database derives a `citations` table from the runs ([13](13-database.md)).
An article's references and its Supporting Information's are separate documents' references and never mix.