> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ko/in-depth-articles/37-step-1-setting-up-an-overleaf-project-to-use-variable-fonts.md).

# 1단계: 가변 글꼴을 사용하기 위한 Overleaf 프로젝트 설정

[소개](https://www.overleaf.com/learn/latex/Articles/How_to_use_OpenType_variable_fonts_with_LaTeX?preview=true) [1단계](https://www.overleaf.com/learn/latex/Articles/Step_1:_Setting_up_an_Overleaf_project_to_use_variable_fonts?preview=true) [2단계](https://www.overleaf.com/learn/latex/Articles/Step_2:_An_introduction_to_LaTeX_fonts?preview=true) [3단계](https://www.overleaf.com/learn/latex/Articles/Step_3:_Replacing_LaTeX’s_default_fonts_with_variable_fonts?preview=true) [4단계](https://www.overleaf.com/learn/latex/Articles/Step_4:_How_to_configure_an_italic_variable_font_using_fontspec?preview=true) [5단계](https://www.overleaf.com/learn/latex/Articles/Step_5:_LaTeX_font_weights_and_named_instances_of_variable_fonts?preview=true) [6단계](https://www.overleaf.com/learn/latex/Articles/Step_6:_Using_variable_fonts_to_add_bold_fonts_to_an_Overleaf_project?preview=true) [7단계](https://www.overleaf.com/learn/latex/Articles/Step_7:_Using_Noto_Sans_and_Roboto_Mono_variable_fonts_with_LaTeX?preview=true) [8단계](https://www.overleaf.com/learn/latex/Articles/Step_8:_How_to_create_a_simple_LaTeX_package_to_configure_your_variable_fonts?preview=true) [예제 및 프로젝트](https://www.overleaf.com/learn/latex/Articles/Overleaf_projects_showing_how_to_use_variable_fonts_with_LaTeX?preview=true)

이 튜토리얼을 시작하려면 다음을 여세요 [함께 제공되는 Overleaf 프로젝트](https://www.overleaf.com/8438931911svtqtnmfvsrp#28008d) 다음 변수 글꼴이 포함되어 있습니다:

* [Noto Serif](https://fonts.google.com/noto/specimen/Noto+Serif/tester) (본문 문서 텍스트)
* [Noto Sans](https://fonts.google.com/noto/specimen/Noto+Sans/tester) (산세리프 글꼴)
* [Roboto Mono](https://fonts.google.com/specimen/Roboto+Mono/tester) (고정폭 글꼴)

이 글꼴들은 아직 사용하도록 설정되지 않았습니다. 처음에는 컴파일할 때 [함께 제공되는 Overleaf 프로젝트](https://www.overleaf.com/8438931911svtqtnmfvsrp#28008d), LaTeX의 표준(기본) 텍스트 글꼴이 적용됩니다. 이 튜토리얼 전반에서 기본 글꼴을 프로젝트 폴더 이름 `VariableFonts`.

의 프로젝트 폴더에 제공된 변수 글꼴로 바꾸는 방법을 배우게 됩니다. 다른 변수 글꼴을 사용하고 싶다면 아래 지침을 따르세요. 그렇지 않으면 다음으로 진행하세요 [2단계](https://www.overleaf.com/learn/latex/Articles/Step_2:_An_introduction_to_LaTeX_fonts?preview=true) 이 튜토리얼.

## (선택 사항) 원하는 변수 글꼴을 선택하고 업로드하는 방법

원하는 변수 글꼴을 업로드하려면 다음 단계를 따르세요.

### 1. Google Fonts에서 변수 글꼴을 구하기

[Google Fonts](https://fonts.google.com/) 는 훌륭한 자료입니다. 다음을 제공합니다 [유용한 문서](https://fonts.google.com/knowledge/introducing_type/introducing_variable_fonts) 와 많은 [무료로 사용할 수 있는 변수 글꼴](https://fonts.google.com/?vfonly=true) 을 제공하며, 이를 Overleaf에 업로드하여 프로젝트에서 사용할 수 있도록 설정할 수 있습니다.

* **팁**: Google Fonts 필터를 사용해 변수 글꼴을 찾으세요. 다음을 *Technology* 필터를 *Variable* 로 설정해 변수 글꼴만 표시하세요. 추가 필터를 사용해 검색을 더 세분화할 수도 있습니다. 예를 들어 *Serif* 등을 사용할 수 있습니다.

![Google Fonts 검색 필터를 보여주는 이미지](/files/01eb823fbc2644525f56d6433d14ce0ed852725d)

* **팁**: 지원하는 디자인 축을 기준으로 변수 글꼴을 둘러볼 수 있습니다: <https://fonts.google.com/variablefonts>. Google은 변수 글꼴 디자인 축에 대한 정의도 제공합니다: <https://fonts.google.com/variablefonts#axis-definitions>.
* 사용하려는 변수 글꼴을 찾았다면, 로컬 장치에 다운로드하고 문제가 되는 문자가 포함된 파일 이름은 변경하세요.
* 일부 변수 글꼴은 두 개의 `.ttf` 파일로 구성됩니다: 하나는 직립(일반) 형태용이고, 제공되는 경우 하나는 이탤릭 형태용입니다. 다운로드하는 각 글꼴에 대해 이를 확인하세요.

### 2. 문제가 되는 Google 글꼴 파일 이름 바꾸기

Google의 변수 글꼴 파일 이름 지정 방식에는 글꼴의 디자인 축이 쉼표로 구분되어 포함됩니다. 안타깝게도 이 방식은 LuaLaTeX에서 변수 글꼴을 사용하기 위해 필수적인 패키지인 fontspec과 충돌을 일으킵니다. 예를 들어 Noto Serif는 너비와 굵기 축을 제공하며, 직립 글꼴용 파일 하나와 이탤릭 글꼴용 파일 하나, 이렇게 두 개의 파일로 제공됩니다:

* NotoSerif-VariableFont\_wdth,wght.ttf
* NotoSerif-Italic-VariableFont\_wdth,wght.ttf

이 파일 이름의 쉼표는 fontspec의 `\setmainfont` 명령에서 사용할 때 오류를 일으킵니다. 예를 들어 다음과 같이 쓰면

```
\setmainfont{NotoSerif-VariableFont_wdth,wght.ttf}
[ItalicFont = NotoSerif-Italic-VariableFont_wdth,wght.ttf]
```

다음을 포함한 오류가 발생합니다

```
! Package fontspec Error: The font "NotoSerif-Italic-VariableFont_wdth" cannot
(fontspec)                be found.

! LaTeX Error: The key 'fontspec-opentype/wght.ttf' is unknown and is being
(LaTeX)        ignored.
```

이 문제를 해결하려면 쉼표(및 밑줄 '\_')를 제거하고 대신 하이픈('-') 같은 "안전한" 문자로 바꾸며, 공백 문자가 추가되지 않도록 글꼴 파일의 이름을 바꿔야 합니다. 예를 들어 다음과 같이 이름을 바꿀 수 있습니다:

* NotoSans-VariableFont\_wdth,wght.ttf

을

* NotoSans-VariableFont-wdth-wght.ttf

이 간단한 이름 바꾸기 단계는 충돌을 피하고 LaTeX 문서에서 변수 글꼴을 원활하게 통합하는 데 도움이 됩니다.

### 3. 새 Overleaf 프로젝트 만들기

* 새 Overleaf 프로젝트를 만들고 [컴파일러를 LuaLaTeX으로 설정하세요](/latex/ko/knowledge-base/026-changing-compiler.md) 변수 글꼴을 지원하는 유일한 컴파일러이기 때문입니다.
* 다음을 `fontspec` 패키지를 다음과 같이 문서의 서문에 추가하세요 `\usepackage{fontspec}`.
* 파일 업로드 아이콘( ![Image displaying Overleaf file-upload icon](/files/ad3935efdfc24f0934ec62692cd31cebbed1dcb4) )을 선택하여 로컬에서 이름을 바꾼 변수 글꼴 파일을 새 프로젝트에 추가하세요:

![Overleaf 프로젝트에 파일을 업로드하는 방법을 보여주는 이미지](/files/4b7d78bbf249121034d2cdd773fb3b0047da0f9c)

### 4. (선택 사항) 프로젝트의 글꼴 파일 정리하기

다양한 글꼴을 시험해 보고 싶다면, 예를 들어 문서 디자인을 테스트할 때, 프로젝트 폴더를 사용해 글꼴 파일을 정리하는 것이 도움이 됩니다. 하지만 컴파일 시 LaTeX는 프로젝트 폴더에서 글꼴을 자동으로 검색하지 않으므로, 다음과 같은 로컬 구성 파일을 사용해 LaTeX를 도와줘야 합니다 [latexmkrc](/latex/ko/in-depth-articles/28-how-to-use-latexmkrc-with-overleaf.md). 여기서는 자세히 다루지 않겠지만, 다음 이름의 프로젝트 폴더를 만드는 것을 권장합니다 `VariableFonts` 그리고 다음을 복사합니다 `latexmkrc` 파일을 사용한 [함께 제공되는 프로젝트](https://www.overleaf.com/8438931911svtqtnmfvsrp#28008d).

## 다음 단계에서

2단계에서는 글꼴 선택을 위한 LaTeX의 모델인 새 글꼴 선택 체계(New Font Selection Scheme)를 소개하며, 이 튜토리얼의 나머지 부분에서 사용되는 중요한 배경 정보를 제공합니다.

[소개](https://www.overleaf.com/learn/latex/Articles/How_to_use_OpenType_variable_fonts_with_LaTeX?preview=true) [1단계](https://www.overleaf.com/learn/latex/Articles/Step_1:_Setting_up_an_Overleaf_project_to_use_variable_fonts?preview=true) [2단계](https://www.overleaf.com/learn/latex/Articles/Step_2:_An_introduction_to_LaTeX_fonts?preview=true) [3단계](https://www.overleaf.com/learn/latex/Articles/Step_3:_Replacing_LaTeX’s_default_fonts_with_variable_fonts?preview=true) [4단계](https://www.overleaf.com/learn/latex/Articles/Step_4:_How_to_configure_an_italic_variable_font_using_fontspec?preview=true) [5단계](https://www.overleaf.com/learn/latex/Articles/Step_5:_LaTeX_font_weights_and_named_instances_of_variable_fonts?preview=true) [6단계](https://www.overleaf.com/learn/latex/Articles/Step_6:_Using_variable_fonts_to_add_bold_fonts_to_an_Overleaf_project?preview=true) [7단계](https://www.overleaf.com/learn/latex/Articles/Step_7:_Using_Noto_Sans_and_Roboto_Mono_variable_fonts_with_LaTeX?preview=true) [8단계](https://www.overleaf.com/learn/latex/Articles/Step_8:_How_to_create_a_simple_LaTeX_package_to_configure_your_variable_fonts?preview=true) [예제 및 프로젝트](https://www.overleaf.com/learn/latex/Articles/Overleaf_projects_showing_how_to_use_variable_fonts_with_LaTeX?preview=true)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/ko/in-depth-articles/37-step-1-setting-up-an-overleaf-project-to-use-variable-fonts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
