quarto tip!

quarto

Author

김경환

Published

September 17, 2023

quarto를 사용하면서 알아낸 tip 정리

코드 작성

qmd에서 코드블럭을 작성할 때 ```로 감싸서 작성

```
code
```

언어를 지정하여 언어에 맞는 디자인을 적용할 수 있다. 140가지 언어를 지원.

defalut를 사용하면 지원하지 않는는 언어도 유사하게 처리를 해준다.

``` r
code <- 1
```

``` defalut
code = 1
```

만약 코드의 파일명 또는 프로그램명을 명시하고싶다면,

input	``` {.r filename="tmp.r"} code = 1 ```
output	tmp.r `code = 1`

Callout Blocks

Callout blocks는 글에서 강조를 하거나 보충, 주의를 표현할 수 있도록 합니다.

input

:::{.callout-note}
Callout blocks에는 5가지 옵션을 사용할 수 있습니다.
: `note`, `tip`, `warning`, `caution`, and `important`.
:::

output

Note

Callout blocks에는 5가지 옵션을 사용할 수 있습니다.: note, tip, warning, caution, and important.

단축키 표시

input

{{< kbd Shift-Ctrl-P >}}

output

Shift-Ctrl-P

Publishing

quarto 문서를 만들었다면 다양한 루트로 Publishing이 가능하다.

github pages

github pages는 docs라는 디렉토리에서 렌더링 되기때문에 _quarto.yml에 다음 코드를 추가해줘야 한다.

_quarto.yml

project:
  type: website
  output-dir: docs

그리고 .nojekyll도 추가, window11에서 Rstudio terminal를 이용 시 copy가 실행되지 않았는데 오히려 touch는 잘 작동되었다.

Mac/Linux	Terminal `touch .nojekyll`
Windows	Terminal `copy NUL .nojekyll`

github pages에 Publishing할때 필요 없는 디렉토리는 .gitignore에 추가하는 것이 좋다. github pages에서 _site, _book등 디렉토리는 모두 docs에서 render되기 때문이다.

.gitignore

/.quarto/
/_site/

만약 이미 push했다면,

Terminal

git rm -r _site

이후 render 후 git에 push

Terminal

quarto render
git push

--- title: "quarto tip!" author: "김경환" date: 2023-09-17 categories: - quarto --- [quarto](https://quarto.org/)를 사용하면서 알아낸 tip 정리 ## 코드 작성 qmd에서 코드블럭을 작성할 때 ```` ``` ````로 감싸서 작성 ```` markdown ``` code ``` ```` 언어를 지정하여 언어에 맞는 디자인을 적용할 수 있다. [140가지 언어를 지원.](https://github.com/jgm/skylighting/tree/master/skylighting-core/xml) `defalut`를 사용하면 지원하지 않는는 언어도 유사하게 처리를 해준다. ```` markdown ``` r code <- 1 ``` ```` ```` markdown ``` defalut code = 1 ``` ```` 만약 코드의 파일명 또는 프로그램명을 명시하고싶다면, +----------------+-----------------------------+ | input | ```` markdown | | | ``` {.r filename="tmp.r"} | | | code = 1 | | | ``` | | | ```` | +----------------+-----------------------------+ | output | ``` {.r filename="tmp.r"} | | | code = 1 | | | ``` | +----------------+-----------------------------+ ## Callout Blocks Callout blocks는 글에서 강조를 하거나 보충, 주의를 표현할 수 있도록 합니다. > input ``` markdown :::{.callout-note} Callout blocks에는 5가지 옵션을 사용할 수 있습니다. : `note`, `tip`, `warning`, `caution`, and `important`. ::: ``` > output ::: callout-note Callout blocks에는 5가지 옵션을 사용할 수 있습니다. : `note`, `tip`, `warning`, `caution`, and `important`. ::: ## 단축키 표시 > input ``` markdown {{{< kbd Shift-Ctrl-P >}}} ``` > output {{< kbd Shift-Ctrl-P >}} ## Publishing quarto 문서를 만들었다면 다양한 루트로 Publishing이 가능하다. ### github pages github pages는 docs라는 디렉토리에서 렌더링 되기때문에 \_quarto.yml에 다음 코드를 추가해줘야 한다. ``` {.yaml filename="_quarto.yml"} project: type: website output-dir: docs ``` 그리고 `.nojekyll`도 추가, window11에서 Rstudio terminal를 이용 시 `copy`가 실행되지 않았는데 오히려 `touch`는 잘 작동되었다. +---------------+---------------------------------+ | Mac/Linux | ``` {.bash filename="Terminal"} | | | touch .nojekyll | | | ``` | +---------------+---------------------------------+ | Windows | ``` {.bash filename="Terminal"} | | | copy NUL .nojekyll | | | ``` | +---------------+---------------------------------+ github pages에 Publishing할때 필요 없는 디렉토리는 `.gitignore`에 추가하는 것이 좋다. github pages에서 `_site`, `_book`등 디렉토리는 모두 `docs`에서 render되기 때문이다. ``` {.bash filename=".gitignore"} /.quarto/ /_site/ ``` 만약 이미 push했다면, ``` {.bash filename="Terminal"} git rm -r _site ``` 이후 render 후 git에 push ``` {.bash filename="Terminal"} quarto render git push ```