Permit the natbib / biblatex to target refs div

Fixes #2770, #2009

Author: dragonstyle

src/format/pdf/format-pdf.ts

@@ -11,6 +11,7 @@ import { mergeConfigs } from "../../core/config.ts";
 import { texSafeFilename } from "../../core/tex.ts";
 
 import {
+  kBibliography,
   kCapBottom,
   kCapLoc,
   kCapTop,
@@ -318,6 +319,16 @@ function pdfLatexPostProcessor(
       calloutFigureHoldLineProcessor(),
     ];
 
+    if (format.pandoc[kCiteMethod] === "biblatex") {
+      lineProcessors.push(bibLatexBibligraphyRefsDivProcessor());
+    } else if (format.pandoc[kCiteMethod] === "natbib") {
+      lineProcessors.push(
+        natbibBibligraphyRefsDivProcessor(
+          format.metadata[kBibliography] as string[] | undefined,
+        ),
+      );
+    }
+
     const marginCites = format.metadata[kCitationLocation] === "margin";
     const renderedCites = {};
     if (marginCites) {
@@ -633,6 +644,47 @@ const calloutFigureHoldLineProcessor = () => {
   };
 };
 
+const kQuartoBibPlaceholderRegex = "%bib-loc-124C8010";
+const bibLatexBibligraphyRefsDivProcessor = () => {
+  let hasRefsDiv = false;
+  return (line: string): string | undefined => {
+    if (line === kQuartoBibPlaceholderRegex) {
+      if (!hasRefsDiv) {
+        hasRefsDiv = true;
+        return "\\printbibliography[heading=none]";
+      } else {
+        // already seen a refs div, just ignore this one
+        return undefined;
+      }
+    } else if (hasRefsDiv && line.match(/^\\printbibliography$/)) {
+      return undefined;
+    } else {
+      return line;
+    }
+  };
+};
+
+const natbibBibligraphyRefsDivProcessor = (bibs?: string[]) => {
+  let hasRefsDiv = false;
+  return (line: string): string | undefined => {
+    if (line === kQuartoBibPlaceholderRegex) {
+      if (bibs && !hasRefsDiv) {
+        hasRefsDiv = true;
+        return `\\renewcommand{\\bibsection}{}\n\\bibliography{${
+          bibs.join(",")
+        }}`;
+      } else {
+        // already seen a refs div, just ignore this one
+        return undefined;
+      }
+    } else if (hasRefsDiv && line.match(/^\s*\\bibliography{.*}$/)) {
+      return undefined;
+    } else {
+      return line;
+    }
+  };
+};
+
 // Removes the biblatex \printbibiliography command
 const suppressBibLatexBibliographyLineProcessor = () => {
   return (line: string): string | undefined => {
@@ -656,7 +708,6 @@ const suppressNatbibBibliographyLineProcessor = () => {
 
 // {?quarto-cite:(id)}
 const kQuartoCiteRegex = /{\?quarto-cite:(.*?)}/g;
-
 const bibLatexCiteLineProcessor = () => {
   return (line: string): string | undefined => {
     return line.replaceAll(kQuartoCiteRegex, (_match, citeKey) => {

src/resources/filters/main.lua

@@ -74,6 +74,7 @@ import("./quarto-post/reveal.lua")
 import("./quarto-post/tikz.lua")
 import("./quarto-post/pdf-images.lua")
 import("./quarto-post/cellcleanup.lua")
+import("./quarto-post/bibliography.lua")
 
 import("./quarto-finalize/dependencies.lua")
 import("./quarto-finalize/book-cleanup.lua")
@@ -227,6 +228,7 @@ local quartoPost = {
   { name = "post-cell-cleanup", filter = cell_cleanup() },
   { name = "post-cites", filter = indexCites() },
   { name = "post-foldCode", filter = foldCode() },
+  { name = "post-bibligraphy", filter = bibliography() },
   { name = "post-figureCleanupCombined", filter = combineFilters({
     latexDiv(),
     responsive(),

src/resources/filters/quarto-post/bibliography.lua

@@ -0,0 +1,13 @@
+-- bibliography.lua
+-- Copyright (C) 2020-2022 Posit Software, PBC
+
+function bibliography() 
+  return {
+    Div = function(el)
+      local citeMethod = param('cite-method', 'citeproc')
+      if _quarto.format.isLatexOutput() and el.attr.identifier == "refs" and citeMethod ~= 'citeproc' then
+        return pandoc.RawBlock("latex", '%bib-loc-124C8010')
+      end
+    end
+  }
+end