문서 언어

개요

문서 언어는 대부분의 형식을 처리할 때 Pandoc에 영향을 주며, LaTeX( babel, polyglossia 사용) 또는 ConTeXt로 PDF를 만들 때 하이픈 처리를 제어합니다.

또한 Quarto, Pandoc, LaTeX는 때때로 지역화가 필요한 텍스트 출력을 생성합니다. 예를 들어 상호 참조의 “Figure”, “List of Figures”, 콜아웃 캡션의 “Note”, “Warning”, 접을 수 있는 코드 청크의 “Code” 캡션 등이 해당합니다.

lang 옵션

lang 문서 옵션은 문서의 주요 언어를 IETF 언어 태그( BCP 47 표준)를 사용해 지정합니다(예: en, en-GB). Language subtag lookup 도구로 태그를 조회하거나 확인할 수 있습니다.

예를 들어 아래 문서는 프랑스어를 사용하도록 지정합니다.

---
title: "My Document"
lang: fr    
---

이렇게 하면 프랑스어 번역이 사용되고, 문서 처리에도 해당 언어 규칙이 적용됩니다. 현재 전체 번역이 제공되는 언어는 다음과 같습니다.

  • English (en, 기본값)
  • Chinese (zh)
  • Spanish (es)
  • French (fr)
  • Japanese (ja)
  • German (de)
  • Portuguese (pt)
  • Russian (ru)
  • Czech (cs)
  • Finnish (fi)
  • Dutch (nl)
  • Italian (it)
  • Polish (pl)
  • Korean (ko)

대체 언어

문서의 특정 부분에서 기본 언어가 마음에 들지 않는다면 language 키(문서 또는 프로젝트 수준)를 사용해 다른 언어 값을 지정할 수 있습니다. 예를 들어 제목 블록의 “Author”, “Published” 캡션을 바꾸려면 다음과 같이 설정합니다.

---
title: "My Document"
author: "Norah Jones"
date: 5/22/2022
language: 
  title-block-author-single: "Writer"
  title-block-published: "Updated"
---

아래에 설명하듯이, 이러한 번역을 별도의 YAML 파일에 작성한 뒤 다음과 같이 참조할 수도 있습니다.

---
title: "My Document"
author: "Norah Jones"
date: 5/22/2022
language: custom.yml
---

사용 가능한 모든 language 키는 https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/language/_language.yml에서 확인할 수 있습니다.

언어별 대체값

대체값을 특정 대상 언어에만 적용하려면 language의 하위 키를 사용합니다. 이 방식으로 언어마다 서로 다른 값을 정의할 수 있습니다. 예를 들어 “Published” 캡션의 영어·프랑스어 버전을 동시에 변경하려면 다음과 같이 지정합니다.

---
title: "My Document"
author: "Norah Jones"
date: 5/22/2022
lang: fr
language:
  en:
    title-block-published: "Updated"
  fr:
    title-block-published: "Mis à jour"
---

위 예시에서는 lang이 fr이므로 프랑스어 “Mis à jour”가 사용됩니다.

이러한 언어별 대체값도 별도의 YAML 파일로 제공할 수 있습니다. 예를 들어 아래 파일을 만든 뒤 메타데이터에서 language: custom-language.yml로 지정하면 됩니다.

custom-language.yml
en:
  title-block-published: "Updated"
fr:
  title-block-published: "Mis à jour"

사용자 정의 번역

아직 Quarto에서 지원하지 않는 언어를 직접 번역하려면 다음 절차를 따르면 됩니다.

  1. 기본 _language.yml 파일을 복사합니다(https://github.com/quarto-dev/quarto-cli/blob/main/src/resources/language/_language.yml).

  2. 기본 영어 값을 원하는 언어로 번역합니다.

  3. language 옵션으로 사용자 정의 번역 파일을 지정합니다. 예를 들어 다음과 같습니다.

    ---
language: custom.yml
---

language 옵션은 프로젝트나 문서 수준 어디에서나 지정할 수 있습니다. 또한 프로젝트 루트의 _quarto.yml과 같은 위치에 _language.yml 파일을 두면 자동으로 사용됩니다.

언어 번역 파일을 만들었다면 다른 사용자도 사용할 수 있도록 기여해 주세요. 자세한 내용은 언어 번역 기여 문서를 참고하세요.