> 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/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 %}

### 구성

템플릿 갤러리 기능은 다음 환경 변수로 제어됩니다:

* `OVERLEAF_TEMPLATE_GALLERY`: 다음으로 설정 `true` 템플릿 갤러리를 활성화하려면.
* `OVERLEAF_TEMPLATE_CATEGORIES`: 0개 이상인 템플릿 카테고리 키의 선택적 공백 구분 목록입니다. 유효한 키에는 다음이 포함됩니다:

  * *`academic-journal`*
  * *`book`*
  * *`presentation`*
  * *`poster`*
  * *`cv`*
  * *`homework`*
  * *`bibliography`*
  * *`calendar`*
  * *`formal-letter`*
  * *`report`*
  * *`thesis`*
  * *`newsletter`*

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

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

  * `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 형식의 링크를 허용합니다.

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

예시는 다음과 같습니다:

{% 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=이력서와 레주메
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의 기본 스키마 버전을 사용하도록 구성되어 있습니다. 이 기본 버전은 가볍지만 LaTeX 패키지의 매우 제한된 하위 집합만 포함하므로, 사용자가 다음의 템플릿을 사용하려 할 때 패키지 누락 오류가 발생할 가능성이 높습니다 [overleaf.com](https://www.overleaf.com/) 로컬 온프레미스 인스턴스에서.

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

다운로드한 템플릿이 온프레미스 Server Pro 인스턴스와 호환되도록 하려면, 다음을 활성화할 것을 강력히 권장합니다 [샌드박스 컴파일](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 논문 템플릿 - 예시 제출본](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. 다음 **템플릿으로 열기** 버튼을 클릭합니다
3. 프로젝트 메뉴를 클릭하고 **소스 다운로드**
4. 를 선택합니다
5. 다음으로, 온프레미스 Server Pro 계정에 로그인합니다 **다음을 클릭합니다** 프로젝트 대시보드의 **프로젝트 업로드**
6. 다음으로, 온프레미스 Server Pro 계정에 로그인합니다 **.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://overleaf-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.
