Publication catalogs
A publication catalog lets templates present works from local BibTeX files,
including works that no page cites. Configure the files in heine.toml:
[publications]
bibliography = ["works.bib"]
extra_fields = ["code"]Place works.bib in the site's citations/ directory. A template can list
the entries in their authored order:
{% for work in publications() %}
<p>{{ work.title }}{% if work.date %} ({{ work.date.text }}){% endif %}</p>
{% endfor %}For a curated list, keep keys in site data and resolve each with
publication(key=key). A BibTeX ids alias resolves to the canonical work.
An unknown key or a call without [publications] fails at the template call.
The full list contains every entry in the selected files, including works by
other authors and parent entries. Use a dedicated bibliography or curated keys
when a page should show only selected works.
Works expose key, type, title, authors, editors, date, year,
journal, book_title, publisher, doi, url, and extra. See the
reference for their shapes. The optional
extra_fields list selects additional lowercase BibTeX fields. Their values
are text, not checked URLs or asset IDs. A template can call asset() when a
field deliberately contains an asset ID. Heine checks that asset when the call
is rendered. The ordinary bibliography url field uses Heine's existing HTTP
and HTTPS checks; template escaping alone does not check a URL scheme.
Heine resolves all selected files together, including cross-references. An
invalid input fails the build even if a template displays only a few entries.
Heine converts common accents and some LaTeX commands, but unsupported
commands can remain in the plain text. It displays BibTeX and others as the
name others. A full build is required after catalog or bibliography changes;
quick builds do not track these changes completely.
An unparsed date, such as date = {forthcoming}, remains available as text.
The legacy year field must contain a year Heine can parse;
year = {forthcoming} causes a mapping error when the work is rendered.
publication(key=...) converts only the selected work. Each publications()
call constructs a view of every entry, so its time and memory grow with the
number and size of entries. Store the result in a template variable when using
it more than once. Sorting or reversing the list can require additional copies.
The starter site's German reading index lists the publication history of Nachtgedanken from the same bibliography used by its citations.