Suppress end of doc bibliography when using biblatex...

[olearydj]

Description

When using biblatex as a citation engine (for backlinks), and generating the bibliographies where required using printbibliography, the rendered pdf is as expected, except that it includes a second copy of the bibliography at the end of the document.

This is the default behavior when using citeproc alternatives, but I can't find a way to disable it and only generate the refs where I want them. The appendix-style: none option only works with citeproc.

Here's my "minimal" example...

_quarto.yaml:

project:
  title: "quarto-tests"
  type: book

bibliography: references.bib

book:
  chapters:
    - index.qmd
    - chapter.qmd
    - refs.qmd

format:
  pdf:
    link-citations: true
    cite-method: "biblatex"
    biblio-style: "apa"
    biblatexoptions: 
      - "backend=biber"
      - "backref=true"
    documentclass: scrbook

index.qmd is empty (which is the source of a future discussion...)

chapter.qmd:

## Chapter

This is my chapter, which includes the now classic insider reference [@vaswani].

refs.qmd, where I need the bib to be included, before appendices (not included in this example):

# References {.unnumbered}

\begingroup
\raggedright
\printbibliography[heading=none]
\endgroup

The resulting pdf includes the expected front-matter, chapter page with citation, and then the references:

Followed by the duplicated, unwanted bibliography:

Quarto version 1.4.550
MacOS 14.3.1

Thanks for any suggestions you might have!

[mcanouil]

Take a look at the LaTeX/PDF partials: https://quarto.org/docs/journals/templates.html#template-partials.
In particular biblio.tex that you can modify to your needs rather than adding RAW LaTeX as you did.
Note that you should enclose your raw code in raw blocks.

```{=latex}
\begingroup
\raggedright
\printbibliography[heading=none]
\endgroup
```

[olearydj]

Derp! I already replace template.tex, so I just commented out $biblio.tex() there and left the raw LaTeX in my references chapter. Fixed it right up. Thank you!

re: raw blocks - I've seen these used but the only place this syntax seems to show up in the docs is on the Docusaurus page. Can you explain why this is preferred for PDF output? Also, unless I misunderstand, It would be good to update these docs:
https://quarto.org/docs/output-formats/pdf-basics.html#raw-latex

[mcanouil]

Raw block ensures that nothing will break the content by trying to perform some pre-processing.

Without it's up to Quarto/Pandoc to determine if they should touch it or not by first "touching"/reading it as if it weren't raw code.

The documentation is correct.
Pandoc allows bare LaTeX, but Pandoc and Quarto do not guarantee the code in question will be as is in the end, thus the more reliable approach using raw code blocks.