有没有办法使用bookdown添加章节参考书目?

时间:2017-07-11 07:57:03

标签: r latex bookdown bibliography

我正在尝试用书籍来写我的博士论文,主要是使用pdf输出。我在文档末尾很容易添加了一个参考书目,但在每一章的末尾都有一个参考书目。我已经尝试用允许这样的LaTeX软件包来调整.tex输出,但是这会与bookownown默认值进行斗争。有没有办法调整.yaml选项来启用它?

2 个答案:

答案 0 :(得分:6)

对于HTML输出,默认使用每章参考书目。对于PDF输出,我发现最好将LaTeX包biblatexbiber一起使用。由于RStudio不了解biber,因此最好安装latexmk之类的工具并配置RStudio以通过Sys.setenv(RSTUDIO_PDFLATEX = "latexmk")使用它。这些程序可能必须单独安装,例如在Debian / Ubuntu / ...

sudo apt-get install texlive-bibtex-extra biber latexmk

要配置biblatexhttps://tex.stackexchange.com/questions/199336/biblatex-reference-both-by-chapter-and-at-the-end-of-the-book提供的解决方案是合适的。

最后,_output.yml中需要进行以下设置:

bookdown::pdf_book:
  citation_package: biblatex

Index.Rmd

biblio-style: authoryear
biblatexoptions: [refsegment=chapter]

每章末尾:

\printbibliography[segment=\therefsegment,heading=subbibliography]

无需转义此原始LaTeX命令,因为pandoc会忽略其他输出格式的此类命令。

可以在

看到整个解决方案

原始解决方案

我设法通过以下步骤获得PDF输出的章节参考书目:

  • https://github.com/rstudio/bookdown-demo
  • 的副本开始
  • <R-library-path>/rmarkdown/rmd/latex/default-1.17.0.2.tex复制为book.tex到工作目录
  • 更新book.tex以使用LaTeX软件包bibunits(下面的差异)
  • 更新_output.ymlbook.textemplate(下面的差异)
  • index.Rmd(下面的差异)
  • 中设置YAML选项
  • 将代码添加到某些Rmd文件以编写\putbib命令(下面的差异)

在这些更改之后,可以生成PDF文件,但所有缺少的引用都会生成,因为bookdown不知道生成的bu?.aux文件。执行bibtex bu1bibtex bu2后,通过bookdown复制PDF文件会生成带有章节参考书目的PDF。最好使用Makefile自动执行此步骤。

这里是模板之间的差异:

$ diff -u /usr/local/lib/R/site-library/rmarkdown/rmd/latex/default-1.17.0.2.tex  book.tex
--- /usr/local/lib/R/site-library/rmarkdown/rmd/latex/default-1.17.0.2.tex  2017-12-11 19:14:54.643867696 +0100
+++ book.tex    2018-01-16 11:43:46.182542634 +0100
@@ -93,8 +93,11 @@
 \fi
 $endif$
 $if(natbib)$
-\usepackage{natbib}
+\usepackage[$natbiboptions$]{natbib}
 \bibliographystyle{$if(biblio-style)$$biblio-style$$else$plainnat$endif$}
+\usepackage{bibunits}
+\defaultbibliographystyle{$if(biblio-style)$$biblio-style$$else$plainnat$endif$}
+\defaultbibliography{$for(bibliography)$$bibliography$$sep$,$endfor$}
 $endif$
 $if(biblatex)$
 \usepackage$if(biblio-style)$[style=$biblio-style$]$endif${biblatex}
@@ -235,6 +238,7 @@
 $endfor$

 \begin{document}
+\bibliographyunit[\chapter]
 $if(title)$
 \maketitle
 $endif$

来自bookdown-sample的文件差异:

$ git diff
diff --git a/01-intro.Rmd b/01-intro.Rmd
index 6b16e73..1a5f9de 100644
--- a/01-intro.Rmd
+++ b/01-intro.Rmd
@@ -19,3 +19,5 @@ knitr::kable(
 ```

 You can write citations, too. For example, we are using the **bookdown** package [@R-bookdown] in this sample book, which was built on top of R Markdown and **knitr** [@xie2015].
+
+`r if (knitr:::is_latex_output()) '\\putbib'`
diff --git a/02-literature.Rmd b/02-literature.Rmd
index 00745d0..983696e 100644
--- a/02-literature.Rmd
+++ b/02-literature.Rmd
@@ -1,3 +1,6 @@
 # Literature

 Here is a review of existing methods.
+[@R-knitr]
+
+`r if (knitr:::is_latex_output()) '\\putbib'`
diff --git a/_output.yml b/_output.yml
index 342a1d6..cc8afb1 100644
--- a/_output.yml
+++ b/_output.yml
@@ -14,4 +14,5 @@ bookdown::pdf_book:
   latex_engine: xelatex
   citation_package: natbib
   keep_tex: yes
+  template: book.tex
 bookdown::epub_book: default
diff --git a/index.Rmd b/index.Rmd
index 4e21b9d..2fdb813 100644
--- a/index.Rmd
+++ b/index.Rmd
@@ -7,6 +7,8 @@ output: bookdown::gitbook
 documentclass: book
 bibliography: [book.bib, packages.bib]
 biblio-style: apalike
+natbiboptions: sectionbib
+graphics: yes
 link-citations: yes
 github-repo: rstudio/bookdown-demo
 description: "This is a minimal example of using the bookdown package to write a book. The output format for this example is bookdown::gitbook."

答案 1 :(得分:5)

对于特定于乳胶的解决方案,请参阅this post,即使用sectionbib的{​​{1}}选项并加载natbib包。您需要编辑bookdown模板以设置chapterbib所需的选项,并告诉bookdown在yaml中使用自定义模板。有关预订模板的详细信息,请参阅this post

我发誓我在书籍记录中看到了使用gitbook格式进行此操作的说明,但我似乎无法找到它......

编辑我去看了我的旧书记项目。对于natbib输出,请在gitbook中指定以下内容:

_output.yml

哪一个(你猜对了)按章分割了参考书目。我实际上有点惊讶的是,bookdown并不支持bookdown::gitbook: split_by: chapter split_bib: yes yaml选项的等效选项,但应该很容易设置bookdown::pdf_book / sectionbibLaTeX preamble