> 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/maintenance/extending-tex-live.md).
# TeX Live 확장
새 Dockerfile을 사용해 기존 TeX Live 이미지를 확장하고 애플리케이션이 새 이미지를 사용하도록 구성할 수 있습니다.
여기서는 새 패키지나 글꼴을 설치하는 몇 가지 지침을 제공하지만, 사용자 지정 이미지의 구성은 지원 약관의 범위에 포함되지 않습니다.
TeX Live 이미지는 업데이트가 드뭅니다. Server Pro를 업그레이드할 때는 사용자 지정 이미지를 다시 빌드하는 것을 권장합니다.
{% hint style="danger" %}
다음 섹션은 Server Pro와 [샌드박스화된 컴파일](broken://pages/c7999a2e39f906d951c2b5ec2f2c14ba192eea5c) 에만 해당됩니다.
{% endhint %}
### 새 패키지 설치 및 업데이트
다음을 사용할 수 있습니다 `tlmgr` 다음과 같은 명령을 `tlmgr install` 그리고 `tlmgr update` 다음 예와 같이 TeX Live 패키지를 관리할 수 있습니다:
```dockerfile
FROM ghcr.io/ayaka-notes/texlive-full:2023.1
RUN tlmgr update --force ebproof
```
### 사용 `tlmgr` 오래된 TeX Live 이미지에서
기본적으로 `tlmgr` 최신 TeX Live 릴리스에서 리소스를 다운로드합니다. 더 오래된 TeX Live 이미지를 패치할 때는 다운로드 대상을 해당 아카이브로 변경해야 합니다. 다음 목록을 참조하세요: 아카이브 미러는 다음에서 확인하세요.
```dockerfile
FROM ghcr.io/ayaka-notes/texlive-full:2022.1
RUN tlmgr option repository /systems/texlive//tlnet-final
# 예: RUN tlmgr option repository ftp://tug.org/historic/systems/texlive/2022/tlnet-final
RUN tlmgr update --force ebproof
```
### 새 글꼴 설치
TeX Live 배포판에 새 글꼴을 설치하는 방법은 여러 가지가 있으며, 사용자 지정 글꼴을 설치하려면 여러 단계가 필요할 수 있습니다. 공식 TeX Live 문서의 [TeX 글꼴 설치 지침을](https://tug.org/fonts/fontinstall.html) 확인해 보는 것이 아마 좋은 출발점일 것입니다.
다음 `Dockerfile` 는 기존 TeX Live 2022 이미지 위에 TrueType 글꼴을 설치하는 예를 보여줍니다:
```dockerfile
FROM ghcr.io/ayaka-notes/texlive-full:2022.1
COPY ./myfonts/*.ttf /usr/share/fonts/truetype/myfont/
# 글꼴 정보 캐시 다시 빌드
RUN fc-cache
```
### Server Pro가 새 이미지를 사용하도록 구성하기
다음 이름을 사용하세요 `ghcr.io/ayaka-notes/texlive-full` 그리고 사용자 지정 태그를 사용해 새 이미지를 빌드합니다. 예:
```bash
docker build -t ghcr.io/ayaka-notes/texlive-full:2023.1-custom
```
이제 Server Pro가 새 `2023.1-custom` 이미지를 사용하도록, 다음을 업데이트하여 구성할 수 있습니다: `TEX_LIVE_DOCKER_IMAGE` 그리고 `ALL_TEX_LIVE_DOCKER_IMAGES` 환경 변수:
{% code overflow="wrap" %}
```
TEX_LIVE_DOCKER_IMAGE: "ghcr.io/ayaka-notes/texlive-full:2023.1-custom"
ALL_TEX_LIVE_DOCKER_IMAGES: "ghcr.io/ayaka-notes/texlive-full:2023.1,ghcr.io/ayaka-notes/texlive-full:2023.1-custom"
```
{% endcode %}
위 예에서 새 프로젝트는 기본적으로 새 `2023.1-custom` 이미지를 사용하도록 설정되며, `2023.1` 필요할 때는 여전히 사용할 수 있습니다.
---
# 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/maintenance/extending-tex-live.md?ask=&goal=
```
`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.