> 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/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://ayakaleaf-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.