13.4　Bookdown包的YAML文件头参数设置

与单独的Rmarkdown文件不同,Bookdown包编排的长文档由多个在共同目录下的Rmarkdown文件组成。用户如果要修改YAML文件头参数信息,只需在第一个Rmarkdown文件中修改,其他的Rmarkdown文件都不需要变动。设置Bookdown包的YAML文件头参数时,下列三个关键参数需要特别注意。

(1)site参数。建议把site参数设置为site:＂bookdown::bookdown_site＂,该参数能保证编译时RStudio调用正确的命令。

(2)output参数。output参数规定输出的文档类型,如果设置为output:bookdown::pdf_book,则输出为PDF格式的文档;如果设置为output:bookdown::gitbook,则输出为gitbook风格的HTML页面。

(3)二级参数。如果需要输出中文PDF文档,需要在bookdown::pdf_book下指定两个二级参数:latex_engine:xelatex和template:template file name。latex_engine:xelatex用于设置适合中文的La Tex转换引擎。用户可通过网址https://github.com/yihui/bookdown-chinese/blob/master/latex/template.tex自行下载template文件,将其与Rmarkdown文件放在同一目录下,再将template参数值设为template.tex即可。