forked from github/quartz
511b003da8
Introduces scripts/pipeline/, a Mix project that runs as a post-export transformation pass over content/*.md before Quartz builds the site. Pipeline (scripts/export.exs phase 3): - Compiles and loads the Mix project at export time (cached after first run) - Applies a list of Transform modules sequentially over all .md files - Only rewrites files that were actually changed Citations transform (Pipeline.Transforms.Citations): - Resolves [cite:@key] and bare cite:key syntax produced by ox-hugo/citar - Resolution chain: Zotero BBT JSON-RPC → BibTeX file → DOI/bare-key fallback - Zotero probe uses a no-op JSON-RPC call (cayw endpoint blocks indefinitely) - Zotero resolver fetches PDF attachments via item.attachments, producing zotero://open-pdf/... links; falls back to zotero://select/library/items/... - BibTeX resolver parses .bib files with a simple regex parser (no deps) - DOI resolver is the always-succeeding last resort Configuration via env vars: BIBTEX_FILE — path to .bib file for fallback resolution ZOTERO_URL — Zotero base URL (default: http://localhost:23119) CITATION_MODE — silent | warn (default) | strict Adding future transforms requires only implementing Pipeline.Transform behaviour and appending the module to the transforms list in export.exs.
14 lines
446 B
Org Mode
14 lines
446 B
Org Mode
#+title: Example: Citation Reference
|
|
|
|
This file demonstrates how org-citar citations pass through ox-hugo into
|
|
markdown, where the pipeline transform resolves them.
|
|
|
|
The methodology described in [cite:@podlovics2021journalArticle] provides a
|
|
useful framework for analysis.
|
|
|
|
Multiple citations can appear together:
|
|
[cite:@podlovics2021journalArticle]
|
|
|
|
Older bare-cite style (org-roam v1 / older citar) also works:
|
|
cite:podlovics2021journalArticle
|