Inline Reference Not Available To Typst
Q-21-5 — Inline Reference Not Available To Typst
A citation refers to an entry defined only in the front-matter
references:list, which Typst’s own bibliography does not read.
What this means
By default, Typst output formats citations with Typst’s own
bibliography, not with citeproc. Each citation reaches Typst as
@key, and Typst looks the key up in the files listed in
bibliography:. Entries written directly in the document’s front
matter under references: are not in any of those files, so Typst
cannot find them.
Without this check, typst compile would stop with
label <key> does not exist in the document. Quarto reports the
problem before Typst runs, and points at the citation.
When the render produces Typst source instead of a PDF (an output-ext
other than pdf), Typst does not run, so this is a warning: the source
is still written, but compiling it will fail the same way.
Why this happens
The document lists its references in front matter instead of a bibliography file:
--- format: typst references: - id: smith2020 type: webpage title: A page --- See [@smith2020].The document has a
bibliography:file, but the cited entry is only inreferences:.citation-location: marginis set. Margin citations also use Typst’s own bibliography, in documents and in books.
How to fix
Either of these works:
- Set
citeproc: true. Citeproc then formats the citations and the bibliography, and it readsreferences:as well asbibliography:. The output uses a CSL style instead of a Typst bibliography style. - Move the entry into a bibliography file, BibLaTeX
.bibor Hayagriva.yml, and list that file underbibliography:.