第一个文档的_bookdown.yml,_output.yml和yaml标头有什么区别?

时间:2018-07-19 13:56:49

标签: r bookdown

使用bookdown创作文档时,我知道有四个用于放置配置选项的选项:

  • _bookdown.yml
  • _output.yml
  • 第一个.Rmd文档的yaml标头
  • 参数已传递给bookdown::render_book()函数。

现在我的问题:

  • 哪些选项可以到哪里,即我可以互换使用所有文件吗?
  • 哪些选项应该去哪里,即放置配置选项的最佳做法是什么?

1 个答案:

答案 0 :(得分:3)

到目前为止,我知道...希望其他人可以完成此操作

首先看看这个高级解释R markdown 接下来使用下面提供的超链接,这些超链接都指向文档详细信息

第一个* .Rmd文件的YAML标头

  • 可以包含here中所述的其他pandoc参数。
  • 它必须包含以下行: site:bookdown :: bookdown_site
  • 可能包含

    指定的多种输出格式
    output: 
      bookdown::gitbook:
      bookdown::pdf_book:
      bookdown::epub_book:  
    

...但是这些也可以位于_output.yml中,如here所述,所有格式都应位于顶层,而不是位于输出字段下。

Example

_bookdown.yml

用于生成图书并保存结果的所有_bookdown.yml参数。

示例

    book_filename: "_book_example"
    repo: https://github.com/<user>/<repo>/ 
    before_chapter_script: ["script1.R"]
    after_chapter_script:  ["script2.R"]
    output_dir: "_book"
    clean: ["deleteme.Rmd"]
    rmd_files: ["index.Rmd", "02-literature.Rmd", "01-intro.Rmd"]
    delete_merged_file: true
    language:
      label: 
        fig: "FIGURE " 
        tab: "TABLE " 
      ui:
        edit: "Edit"
        chapter_name: "Chapter "
    rmd_subdir: ["content/"]