4.4 설정

섹션 (usage)에서rmd_files에 대해 언급했으며_bookdown.yml에서 책에 대해 구성할 수있는 더 많은 (선택 사항) 설정이 있습니다:

  • book_filename : 기본 Rmd 파일의 파일 이름, 즉 모든 장에서 병합된 Rmd 파일. 기본적으로 이름은_main.Rmd입니다.
  • delete_merged_file : 책이 성공적으로 렌더링된 후 메인 Rmd 파일을 삭제할지 여부.
  • before_chapter_script : 각 장 앞에서 실행되는 하나 또는 여러 R 스크립트, 예를 들어 각 장을 컴파일하기 전에 작업 공간을 지우고 싶을 수 있습니다.이 경우 R 스크립트에서 rm(list = ls(all = TRUE))를 사용할 수 있습니다.
  • after_chapter_script :before_chapter_script와 유사하며 R 스크립트는 각 장 다음에 실행됩니다.
  • edit : 공동 작업자가 현재 페이지의 Rmd 소스 문서를 편집하기 위해 클릭할 수있는 링크입니다. 다른 사람의 리포지토리에서도 GitHub의 임의의 일반 텍스트 파일을 편집하기 쉽기 때문에 주로 GitHub 리포지토리 용으로 설계되었습니다 (리포지토리에 대한 쓰기 액세스 권한이 없는 경우 파일 편집을 마친 후 GitHub에서 자동으로 포크하고 풀 요청을 제출할 수 있습니다). 이 링크에는%s가 있어야 하며 각 페이지의 실제 Rmd 파일 이름으로 대체됩니다.
  • history : edit와 유사하며 현재 페이지의 편집 / 커밋 히스토리에 대한 링크입니다.
  • view : edit와 유사하며 현재 페이지의 소스 코드에 대한 링크입니다.
  • rmd_subdir : 하위 디렉토리에서 책 소스 Rmd 파일을 검색할 지 여부 (기본적으로 루트 디렉토리 만 검색 됨). 부울 (예 :true는 프로젝트 디렉토리 및 모든 하위 디렉토리에서 책 소스 Rmd 파일을 검색 함)이거나 하위 디렉토리 하위 집합에서 책 소스 Rmd 파일을 검색하려는 경우 경로 목록일 수 있습니다.
  • output_dir : 책의 출력 디렉토리 (기본적으로_book); 이 설정은render_book()에서 읽고 사용합니다.
  • clean :clean_book()함수로 정리할 파일과 디렉토리의 벡터.

_bookdown.yml의 예를 들면 다음과 같다 :

book_filename: "my-book.Rmd"
delete_merged_file: true
before_chapter_script: ["script1.R", "script2.R"]
after_chapter_script: "script3.R"
view: https://github.com/rstudio/bookdown-demo/blob/master/%s
edit: https://github.com/rstudio/bookdown-demo/edit/master/%s
output_dir: "book-output"
clean: ["my-book.bbl", "R-packages.bib"]