개요

이 책은 bookdown 패키지를 이용하여 한글로 수식, 그림, 표를 포함한 책을 작성할 때 필요한 사항과 유용한 팁을 수록한 안내서입니다.

`bookdown` 패키지를 이용하여 책을 만드는 절차

R 과 Rstudio 를 사용할 수 있는 환경을 만든다.
bookdown 패키지를 포함한 사용할 패키지를 설치한다.
새로운 bookdown 프로젝트를 Rstudio 의 file 메뉴를 통해서 새로운 디렉토리에 생성한다

주의: 메뉴상에서 file -> New project -> new directory -> bookdown project 를 이용해서 프로젝트를 만드는 것이 필요하다. 이렇게 만들면 build 형식도 book으로 나타나고 예제 화일도 생성된다. 먼저 화일을 만들고 이후에 프로젝트를 생성하면 여러 가지 문제가 계속 나타난다.

설정화일(_bookdown.yaml, _output.yaml,..) 등을 포함하여 모든 화일을 원하는 대로 초기화 한다.

_bookdown.yaml 에서 다음과 같이 웹사이트 등 결과가 저장되는 폴더 이름을 지정합니다 (docs 폴더로 결과가 저장되도록 설정) . 아래와 같이 지정하지 않으면 자동으로 _book 폴더가 생성되고 결과가 저장됩니다.

output_dir: "docs"

git 환경을 구성하고 github 의 원격저장소에 올린다

자세한 방법은 여기를 참조하자. 통상적으로 github 에 먼저 저장소를 만들고 clone 하는 것이 정상적 절차지만 bookdown 프로젝트를 초기화하기 위하여 이 방법을 사용한다.)
로컬 저장소를 github 에 push 하는 경우 personal access token을 만들어서 password 에 입력해야 합니다. 자세한 poersonal access token 생성 과정은 여기 를 참조하세요.

github 의 원격저장소에서 웹사이트를 설정한다.

웹사이트를 설정하는 방법은 많지만 여기를 참조하여 만들자.
웹사이트의 branch 를 설정할 때 앞의 과정 4에서 지정한 output_dir 로 폴더를 선택한다.
간단한 웹사이트는 github action 을 사용하는 것이 편하지만 복잡한 방법(예를 들어 xelatex 을 이용하여 한글을 사용하는 경우)으로 책을 만드는 경우 경우 위와 같이 하는 것이 절차가 단순하다.

0.1 `renv` 사용

패키지를 제대로 사용하기 위해서는 renv 패키지를 사용하여 관리하는 것이 좋다.
renv 패키지를 사용하는 경우 다음과 같은 폴더와 화일이 생기므로 git 가 무시하도록 설정한다.

renv/
.Rprofile
renv.lock