버그 신고

Quarto에 대한 실행 가능한 버그 리포트를 작성하는 방법

우리는 Quarto 버그에 대해 듣고 싶고, 그 버그들을 수정하고 싶습니다! 다음 가이드를 따르면 우리가 가능한 한 효율적으로 작업할 수 있습니다.

규칙 0: 어쨌든 버그 리포트를 제출해 주세요!

아래 지침을 따르면 코드를 더 빨리 수정할 수 있는 가능성이 높아집니다. 그러나 이것이 작업이 필요하고 항상 가능한 것은 아니라는 것을 알고 있습니다.

우리는 문제에 대해 알지 못하는 것보다는 기록을 갖고 있는 것이 낫습니다.

다음 단계 중 일부 또는 전부를 수행할 수 없더라도 버그 리포트를 제출해 주시면 감사하겠습니다:

작은 것이 아름답습니다: 약 10줄의 단일 문서를 목표로 하세요

우리를 돕기 위해 할 수 있는 가장 유용한 일은 최소한의, 독립적이고, 재현 가능한 예제를 제공하는 것입니다.

최소한: 이것은 종종 대규모 웹사이트 프로젝트를 단일 작은 문서가 있는 프로젝트로, 그리고 크고 긴 .qmd 파일을 작은(이상적으로 총 10-20줄의 코드) 예제로 만드는 것을 의미합니다. 이렇게 함으로써 문제가 무엇인지 더 구체적으로 배울 수도 있습니다.
독립적: 우리가 이해하고 설치해야 하는 소프트웨어 종속성이 많을수록 버그를 추적하기가 더 어렵습니다. 코드를 줄이면서 가능한 한 많은 종속성을 제거하세요.
재현 가능: 예제를 실행할 수 없으면 버그를 추적할 수 없습니다. 제출한 파일이 자체적으로 버그를 트리거하기에 충분한지 확인하십시오.

형식: GitHub의 마크다운이 우리를 위해 작동하도록 만들기

최소한의 독립적인 재현 가능한 Quarto 문서를 다음 마크다운 구문을 사용하여 공유할 수 있습니다. 즉, 문서에 있는 것보다 더 많은 백틱(일반적으로 4개 ````)을 사용하여 코드 셀을 고려합니다.

````qmd
---
title: "재현 가능한 Quarto 문서"
format: html
engine: jupyter
---

이것은 `format: html`과 `jupyter` 엔진을 사용하는 최소한의 독립적인 재현 가능한 Quarto 문서입니다.
마크다운으로 작성되었으며 임베디드 Python 코드가 포함되어 있습니다.

```{python}
print("Hello, world!")
```

![이미지]({{< placeholder 600 400 >}}){#fig-placeholder}

{{< lipsum 1 >}}

@fig-placeholder에 대한 참조.

끝.
````

````qmd
---
title: "재현 가능한 Quarto 문서"
format: html
engine: knitr
---

이것은 `format: html`과 `knitr` 엔진을 사용하는 최소한의 독립적인 재현 가능한 Quarto 문서입니다.
마크다운으로 작성되었으며 임베디드 R 코드가 포함되어 있습니다.

```{r}
print("Hello, world!")
```

![이미지]({{< placeholder 600 400 >}}){#fig-placeholder}

{{< lipsum 1 >}}

@fig-placeholder에 대한 참조.

끝.
````

주저하지 마세요: 차이를 만들 수 있다고 생각하는 모든 것을 알려주세요

.qmd 파일이 작기를 원하지만, 여전히 여러분이 기꺼이 공유하고자 하는 만큼의 정보를 사용할 수 있습니다. 다음을 포함하여 모든 것을 알려주세요:

실행 중인 Quarto 버전
실행 중인 운영 체제
사용 중인 IDE와 그 버전

확인

환경을 이해하는 데 도움이 되도록 다음 명령의 출력(코드 블록 내)을 제공할 수 있습니다:

quarto check

예를 들어, 제공할 마크다운 코드는 다음과 같을 수 있습니다:

```bash
Quarto 1.5.42
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.2.0: OK
      Dart Sass version 1.70.0: OK
      Deno version 1.41.0: OK
      Typst version 0.11.0: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 1.5.42
      Path: /Applications/quarto/bin

[✓] Checking tools....................OK
      TinyTeX: v2024.03.13
      Chromium: (not installed)

[✓] Checking LaTeX....................OK
      Using: TinyTex
      Path: /Users/username/Library/TinyTeX/bin/universal-darwin
      Version: 2024

[✓] Checking basic markdown render....OK

[✓] Checking Python 3 installation....OK
      Version: 3.12.1
      Path: /.venv/bin/python3
      Jupyter: 5.7.2
      Kernels: julia-1.10, python3

[✓] Checking Jupyter engine render....OK

[✓] Checking R installation...........OK
      Version: 4.3.3
      Path: /Library/Frameworks/R.framework/Versions/4.3-arm64/Resources
      LibPaths:
        - /Users/username/Library/R/arm64/4.3/library
        - /Library/Frameworks/R.framework/Versions/4.3-arm64/Resources/library
      knitr: 1.45
      rmarkdown: 2.26

[✓] Checking Knitr engine render......OK
```

스택 출력

Quarto에서 오류가 발생하는 경우, QUARTO_PRINT_STACK 환경 변수를 정의하여 추가 진단 정보를 제공할 수도 있습니다.

예를 들어 Unix에서:

export QUARTO_PRINT_STACK=true
quarto render document.qmd

또는 Powershell 터미널의 Windows에서:

$ENV:QUARTO_PRINT_STACK="true"
quarto render document.qmd