> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/ko/configuration/overleaf-toolkit/templates.md).

# 템플릿

{% hint style="info" %}
이 기능은 처음에 개발되었습니다 [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), 그리고 수정 및 최적화되었습니다 [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}

{% columns %}
{% column %}

<figure><img src="/files/3b910047a1b32fef2610def9481ea8512f82a977" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/bfcc8a2450a5bea1938cee85363c863e332aec77" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### 설정

Template Gallery 기능은 다음 환경 변수로 제어됩니다:

* `OVERLEAF_TEMPLATE_GALLERY`: 다음으로 설정 `true` 하여 Template Gallery를 활성화합니다.
* `OVERLEAF_TEMPLATE_CATEGORIES`: 선택 사항인 공백으로 구분된 0개 이상의 템플릿 카테고리 키 목록입니다. 유효한 키는 다음과 같습니다:

  * *`학술지`*
  * *`책`*
  * *`프레젠테이션`*
  * *`포스터`*
  * *`이력서`*
  * *`과제`*
  * *`참고문헌`*
  * *`달력`*
  * *`공식 서신`*
  * *`보고서`*
  * *`학위논문`*
  * *`뉴스레터`*

  특수 키 *`모두`* 는 자동으로 추가됩니다. 이 키는 모든 템플릿을 포함하는 카테고리를 나타냅니다.

  각 카테고리 키마다 다음 선택적 환경 변수를 설정할 수 있습니다:

  * `TEMPLATE_<KEY>_NAME`: 템플릿 카테고리의 표시 이름입니다.
  * `TEMPLATE_<KEY>_DESCRIPTION`: 카테고리의 짧은 설명입니다.

  카테고리 키에 하이픈(`-`), 이를 밑줄(\_)로 바꾸세요(`_`)를 환경 변수 이름에 사용합니다.
* `ENABLE_CONVERSIONS`: 다음으로 설정해야 합니다 `true` 하여 템플릿의 썸네일 및 미리보기 생성을 활성화합니다.

### 게시 권한

관리자는 템플릿을 게시할 수 있습니다. 또한 비관리자 사용자를 지정하여 로컬 갤러리의 다음 위치에 표시되는 선별된 템플릿을 관리하게 할 수 있습니다: `/templates`.

이렇게 하려면 환경 변수 `OVERLEAF_TEMPLATES_USER_ID` 의 `toolkit/config/variables.env` 를 `ID` 를 해당 인스턴스에서 템플릿 관리를 담당할 사용자의 것으로 설정해야 합니다. 예:

```dotenv
OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959
```

### 템플릿 게시

업로드하려는 각 템플릿에 대해:

1. 템플릿의 소스 코드를 포함한 프로젝트를 만들고, 컴파일되는지 확인합니다.
2. 편집기 왼쪽 메뉴에서 다음을 선택하세요: **템플릿으로 게시**.
3. 표시되는 양식에 템플릿 세부 정보를 입력하세요:
   * 다음 *제목* 는 고유해야 합니다.
   * 다음 *설명* 필드는 Markdown 형식을 지원합니다.
   * 다음 *작성자* 필드는 Markdown 형식의 링크를 허용합니다.

제출 후에는 템플릿 세부 정보를 수정하거나 Template Gallery 페이지에서 템플릿을 삭제할 수 있습니다. 사용자는 자신의 템플릿을 관리할 수 있으며, 관리자는 모든 템플릿을 관리할 수 있습니다.

다음은 예시입니다:

{% code overflow="wrap" expandable="true" %}

```dotenv
#################
#   템플릿   #
#################

ENABLE_CONVERSIONS=true

OVERLEAF_TEMPLATE_GALLERY=true
OVERLEAF_TEMPLATE_CATEGORIES=academic-journal book presentation poster cv homework bibliography calendar formal-letter report thesis newsletter

TEMPLATE_ACADEMIC_JOURNAL_NAME=학술지 논문
TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=주요 출판사와 프리프린트 서버의 형식을 포함한 학술지 제출용 템플릿입니다.

TEMPLATE_BIBLIOGRAPHY_NAME=참고문헌
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=BibTeX 또는 BibLaTeX로 참고문헌을 작성하고 관리하기 위한 스타일입니다. 학술 논문, 학위논문, 보고서에 사용하기 적합합니다.

TEMPLATE_BOOK_NAME=책
TEMPLATE_BOOK_DESCRIPTION=장 구성, 서문, 색인 등을 포함한 책이나 장문 문서를 작성하기 위한 템플릿입니다.

TEMPLATE_CALENDAR_NAME=달력
TEMPLATE_CALENDAR_DESCRIPTION=연간, 월간 또는 주간 달력을 만드는 템플릿입니다. 개인 플래너나 일정 관리에 유용합니다.

TEMPLATE_CV_NAME=CV 및 이력서
TEMPLATE_CV_DESCRIPTION=학술, 산업, 창작 분야의 다양한 직무에 맞는 CV 및 이력서 템플릿입니다.

TEMPLATE_FORMAL_LETTER_NAME=공식 서신
TEMPLATE_FORMAL_LETTER_DESCRIPTION=커버 레터, 추천서, 공식 서신과 같은 전문 서신용 템플릿입니다.

TEMPLATE_HOMEWORK_NAME=과제
TEMPLATE_HOMEWORK_DESCRIPTION=과제, 수업 과제, 문제 세트용 템플릿입니다. 학생과 교육자를 위해 깔끔하고 잘 구조화되도록 설계되었습니다.

TEMPLATE_NEWSLETTER_NAME=뉴스레터
TEMPLATE_NEWSLETTER_DESCRIPTION=학술, 기업 또는 커뮤니티 커뮤니케이션에 맞는 형식의 뉴스레터 작성용 템플릿입니다.

TEMPLATE_POSTER_NAME=포스터
TEMPLATE_POSTER_DESCRIPTION=컨퍼런스와 연구 발표에서 주로 사용되는 과학 및 학술 포스터용 템플릿입니다.

TEMPLATE_PRESENTATION_NAME=프레젠테이션
TEMPLATE_PRESENTATION_DESCRIPTION=학술 발표와 강의에 맞춘 Beamer 및 기타 발표 형식용 템플릿입니다.

TEMPLATE_REPORT_NAME=보고서
TEMPLATE_REPORT_DESCRIPTION=기술 보고서, 실험실 보고서 또는 프로젝트 보고서용 템플릿입니다. 그림, 표, 참고문헌 섹션을 포함합니다.

TEMPLATE_THESIS_NAME=학위논문
TEMPLATE_THESIS_DESCRIPTION=기관의 서식 및 인용 지침을 따르는 학위논문 및 디서테이션 작성용 템플릿입니다.

TEMPLATE_ALL_NAME=모든 템플릿
TEMPLATE_ALL_DESCRIPTION=문서 유형, 스타일, 목적별로 분류된 사용 가능한 모든 LaTeX 템플릿 모음을 살펴보세요.

```

{% endcode %}

### overleaf.com에서 템플릿 이전 <a href="#transferring-templates-from-overleaf.com" id="transferring-templates-from-overleaf.com"></a>

Overleaf Pro는 오프라인에서 작동하도록 설계되었기 때문에 자동으로 통합할 방법은 없습니다 [overleaf.com](https://www.overleaf.com/) 하지만 템플릿별로 수동으로 온프레미스 설치에 갤러리 템플릿을 통합하는 것은 가능합니다.

기본적으로 Overleaf Pro는 컴파일에 TeXLive의 basic scheme 버전을 사용하도록 구성되어 있습니다. 이 기본 버전은 가볍고 LaTeX 패키지의 매우 제한된 하위 집합만 포함하므로, 사용자가 다음의 템플릿을 사용하려고 할 때 패키지 누락 오류가 발생할 가능성이 큽니다: [overleaf.com](https://www.overleaf.com/) 로컬 온프레미스 인스턴스에서.

안타깝게도 누락된 패키지를 자동으로 설치할 방법은 없지만, Server Pro에는 사용자가 더 많은 패키지에 접근하여 더 안전한 방식으로 프로젝트를 컴파일할 수 있게 하는 구성 가능한 설정이 있습니다. 이 기능은 다음과 같습니다: [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) (Sibling Containers라고도 함).

다운로드한 템플릿이 온프레미스 Server Pro 인스턴스와 호환되도록 하려면 다음 기능을 활성화하는 것을 강력히 권장합니다: [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) 이 기능은 사용자에게 다음과 동일한 TeX Live 환경에 대한 접근 권한을 제공하기 때문입니다 [overleaf.com](https://www.overleaf.com/). 이러한 이미지에는 가장 많이 사용되는 패키지와 글꼴이 포함되어 있으며, 이미 우리의 갤러리 템플릿에 대해 테스트되었습니다.

사용자가 프로젝트 내에서 선택할 수 있는 TeX Live 버전을 구성하는 방법과 새 프로젝트의 기본 TeX Live 이미지 버전을 설정하는 방법에 대한 추가 정보는 다음에서 확인할 수 있습니다: [TeX Live 이미지 변경](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image) 문서의 해당 섹션을 참조하세요.

1. 다음으로 이동하세요: [템플릿 갤러리](https://www.overleaf.com/latex/templates) 에서 [overleaf.com](https://www.overleaf.com/) 그리고 필요한 템플릿을 찾으세요. 예: [IEEE Photonics Journal Paper Template - Example Submission](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. 다음을 클릭하세요: **템플릿으로 열기** 버튼
3. 프로젝트 메뉴를 클릭하고 다음을 선택하세요: **소스 다운로드**
4. 다음으로 온프레미스 Server Pro 계정에 로그인하세요
5. 다음을 클릭하세요: **새 프로젝트** 프로젝트 대시보드의 버튼을 클릭하고 다음을 선택하세요: **프로젝트 업로드**
6. 다음을 클릭하세요: **.zip 파일 선택** 버튼을 누르고 다운로드한 템플릿 zip 파일을 선택하세요

그런 다음 사용자는 새로 업로드된 템플릿을 자신의 계정에서 사용할 수 있으며, 템플릿 사용자로서 이를 다른 사용자가 사용할 수 있도록 게시할 수도 있습니다.

### Q\&A

<details>

<summary>해당 템플릿을 게시한 후 프로젝트를 삭제해도 되나요?</summary>

**답변:** 네, 하지만 그렇게 하는 것은 권장하지 않습니다. 템플릿을 게시하면 프로젝트의 스냅샷을 찍어 게시 시점의 프로젝트를 zip 파일로 저장합니다. 이렇게 하면 템플릿에 해당하는 프로젝트를 삭제하더라도 템플릿은 영향을 받지 않습니다.

하지만 이 템플릿과 연결된 ProjectID도 기록하므로, 나중에 템플릿을 쉽게 업데이트할 수 있습니다.

해당 프로젝트를 삭제하면 템플릿 세부 정보 페이지에서 "Admin: Source Project" 버튼이 표시되지 않습니다(아래 이미지 참조).

<figure><img src="/files/baa999b0b5ff94606d8de8a15a692a04a4999d82" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>일부 프로젝트에서 템플릿 게시에 왜 이렇게 오래 걸리나요?</summary>

**답변:** 템플릿을 게시하면 프로젝트를 zip 및 pdf 파일로 저장하는데, 이는 보통 빠릅니다. 하지만 템플릿 세부 정보에 표시할 수 있도록 PDF용 썸네일도 생성해야 합니다.

썸네일 생성 시간은 일반적으로 PDF 첫 페이지의 내용에 따라 달라집니다. 표시 품질과 변환 시간의 균형을 맞추기 위해 중간값을 너비로 선택합니다.

하지만 PDF의 첫 페이지에 텍스트가 많으면 썸네일 변환에 40초 또는 그 이상 걸릴 수 있으니 기다려 주세요. 여기에 큰 포스터의 예가 있으며, 더 오래 걸립니다.

<figure><img src="/files/ea92a91caeca3028d00a793abe70881f425e8363" alt="" width="188"><figcaption><p>큰 포스터</p></figcaption></figure>

</details>


---

# 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://ayakaleaf-pro.ayaka.space/on-premises/ko/configuration/overleaf-toolkit/templates.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.
