feat: add citations transformer plugin

quartz/plugins/transformers/citations.ts

@@ -0,0 +1,33 @@
+import rehypeCitation from "rehype-citation"
+import { QuartzTransformerPlugin } from "../types"
+
+export interface Options {
+  bibliographyFile: string
+  suppressBibliography: boolean
+}
+
+const defaultOptions: Options = {
+  bibliographyFile: "./bibliography.bib",
+  suppressBibliography: false,
+}
+
+export const Citations: QuartzTransformerPlugin<Partial<Options> | undefined> = (userOpts) => {
+  const opts = { ...defaultOptions, ...userOpts }
+  return {
+    name: "Citations",
+    htmlPlugins() {
+      return [
+        [
+          rehypeCitation,
+          {
+            bibliography: opts.bibliographyFile,
+            suppressBibliography: opts.suppressBibliography,
+            // Until popovers are implemented to not show for citation links, I
+            // don't want to link citations
+            linkCitations: false,
+          },
+        ],
+      ]
+    },
+  }
+}

quartz/plugins/transformers/index.ts

@@ -1,5 +1,6 @@
 export { FrontMatter } from "./frontmatter"
 export { GitHubFlavoredMarkdown } from "./gfm"
+export { Citations } from "./citations"
 export { CreatedModifiedDate } from "./lastmod"
 export { Latex } from "./latex"
 export { Description } from "./description"