Pandoc insert appendix after bibliography

Question

I'm using the knitr package and pandoc in R to convert a .Rmd file to a PDF. Pandoc is linked to a .bib file and automatically inserts the bibliography at the end of the PDF The entries in my .bib file look like these, taken from http://johnmacfarlane.net/pandoc/demo/biblio.bib:

@Book{item1,
        author="John Doe",
        title="First Book",
        year="2005",
        address="Cambridge",
        publisher="Cambridge University Press"
  }

@Article{item2,
         author="John Doe",
         title="Article",
         year="2006",
         journal="Journal of Generic Studies",
         volume="6",
         pages="33-34"
}

To build my bibliography, I'm using the following function, taken from: http://quantifyingmemory.blogspot.co.il/2013/02/reproducible-research-with-r-knitr.html

knitsPDF <- function(name) {
  library(knitr)
  knit(paste0(name, ".Rmd"), encoding = "utf-8")
  system(paste0("pandoc -o ", name, ".pdf ", name, ".md --bibliography /Users/.../Desktop/test.bib --csl /Users/.../Desktop/taylor-and-francis-harvard-x.csl"))
}

The contents of my .Rmd file is:

This is some text [@item1]

This is more text [@item2]

# References

And outputted PDF looks like this:

enter image description here

If I try to insert an appendix, the references still print at the end of the document, like this:

enter image description here

How do insert an appendix after the references?

score 56 · Answer 1 · answered May 31 '17 at 20:42

56

With newer pandoc versions, you can specify the bibliography's position with <div id="refs"></div> source

This is some text [@item1]

This is more text [@item2]

# References

<div id="refs"></div>

# appendix

answered May 31 '17 at 20:42

scoa

19,359
5
65
80

5

This does not seem to work for me. The output format of my Rmarkdown document is `bookdown::pdf_document2`. – SavedByJESUS Jul 14 '18 at 02:23
1

This should become the accepted answer as it is perfectly straight-forward, I think. – benedikt Aug 31 '18 at 14:43

score 16 · Accepted Answer · answered May 07 '13 at 21:16

16

Eventually reference handling will change to make it possible to put the references wherever you like (https://github.com/jgm/pandoc/issues/771), but right now there's no easy way to do it.

As suggested here, you could put your appendix in a separate file, use pandoc to convert it to a LaTeX fragment, then include that fragment using the --include-after-body flag. It would then come after the bibliography.

answered May 07 '13 at 21:16

John MacFarlane

8,511
39
33

3

Whew glad that's it. I suspected Yihui had put a back end into knitr and was using it to steal people's data. – Tyler Rinker May 07 '13 at 21:41
2

But, as NOON SILK says in the link you cited, "This doesn't work if the Appendix cites a reference." :-( – Tripartio May 18 '17 at 08:31
2

This was now implemented, cf. https://pandoc.org/MANUAL.html#placement-of-the-bibliography You can also refer to https://stackoverflow.com/a/58226766/2657549 for an example. – Clément Nov 19 '20 at 05:43

score 6 · Answer 3 · edited Apr 20 '21 at 06:31

When working in an Rmarkdown document, enter the following text where the citations are to be located. It can be placed in any part of the document allowing other materials, like an appendix, to follow as necessary. The method relies on pandoc's fenced divs which will work in Rmarkdown.

::: {#refs}
:::

The aforementioned code should not be in an R code chunk, rather it should be placed on blank lines by themselves. Once processed by pandoc via knitter, this code will produce the same result as <div id="refs"></div> mentioned in the answer by @soca. The two lines of code do consistently allow for exact placement of the references in any section of the document.

In the example below, references are placed first under a heading of the same name while all of the code chunks in the document are placed afterwards in a code appendix. Here is the pandoc fenced div placed in Rmarkdown that can be used to generate the image that follows.

# References
::: {#refs}
:::

# Appendix A: R Code
```{r ref.label=knitr::all_labels(), echo=TRUE, eval=FALSE}

```

Provided there is a .bib file identified in the yaml frontmatter, the preceding Rmarkdown produces output similar to the following:

Helpful links:

This is excellent advise, just one nitpick: the solution uses pandoc's [fenced divs](https://pandoc.org/MANUAL.html#divs-and-spans), it has nothing to do with R Markdown. — tarleb, Apr 19 '21 at 07:31
I edited the answer with the aim of properly referencing the use of pandoc's fenced divs. Hopefully I have it right. — ncraig, Apr 19 '21 at 16:35

Pandoc insert appendix after bibliography

3 Answers3

Linked