Przejdź do głównej treści
Istniejący obraz TeX Live można rozszerzyć za pomocą nowego pliku Dockerfile i skonfigurować aplikację tak, aby używała nowego obrazu. Poniżej przedstawiamy wskazówki dotyczące instalowania nowych pakietów lub fontów. Obrazy TeX Live są aktualizowane rzadko. Zalecamy przebudowywanie niestandardowych obrazów przy aktualizacji Ayakaleaf Pro.
Poniższe sekcje dotyczą wyłącznie Sandboxed Compiles.

Instalowanie i aktualizowanie pakietów

Do zarządzania pakietami TeX Live możesz używać poleceń tlmgr, takich jak tlmgr install i tlmgr update, jak w poniższym przykładzie:

Używanie tlmgr w starszym obrazie TeX Live

Domyślnie tlmgr pobiera zasoby z najnowszego wydania TeX Live. Przy łataniu starszego obrazu TeX Live pobieranie należy przełączyć na odpowiednie archiwum. Listę serwerów lustrzanych archiwów znajdziesz na stronie https://www.tug.org/historic/.

Instalowanie nowych fontów

Istnieją różne procedury instalowania nowych fontów w dystrybucji TeX Live, a instalacja niestandardowego fontu może wymagać kilku kroków. Dobrym punktem wyjścia będzie prawdopodobnie zapoznanie się z instrukcjami instalacji fontów TeX w oficjalnej dokumentacji TeX Live. Poniższy plik Dockerfile pokazuje przykład instalacji fontu TrueType w istniejącym obrazie TeX Live 2022:

Konfigurowanie Ayakaleaf Pro do używania nowych obrazów

Do zbudowania nowego obrazu użyj nazwy ghcr.io/ayaka-notes/texlive-full i niestandardowego tagu, na przykład:
Teraz możemy skonfigurować Ayakaleaf Pro do używania nowego obrazu 2023.1-custom, aktualizując zmienne środowiskowe TEX_LIVE_DOCKER_IMAGE, ALL_TEX_LIVE_DOCKER_IMAGES i ALL_TEX_LIVE_DOCKER_IMAGE_NAMES (nazwy są opcjonalne i odpowiadają kolejności obrazów):
W powyższym przykładzie nowe projekty domyślnie używają nowego obrazu 2023.1-custom, a obraz 2023.1 pozostaje dostępny, gdy jest potrzebny. Niestandardowy obraz istnieje tylko na Twoim hoście, więc bin/up nie może go pobrać. Ustaw SIBLING_CONTAINERS_PULL=false w config/overleaf.rc (pozostałe obrazy pobierz samodzielnie za pomocą docker pull), a następnie uruchom bin/up -d, aby zastosować nowe ustawienia.

Pytania i odpowiedzi

Odpowiedź: Nie, nie w przypadku obrazów texlive-full. Zawierają one chińskie pakiety TeX Live (ctex, xeCJK) z czcionkami Fandol oraz czcionki Noto CJK (na przykład Noto Serif CJK SC). Ustaw kompilator projektu na XeLaTeX w ustawieniach edytora, a następnie skompiluj, na przykład:
Aby używać Noto zamiast Fandol, dodaj \setCJKmainfont{Noto Serif CJK SC}. Plik latexmkrc nie jest potrzebny. W przypadku innych czcionek zbuduj niestandardowy obraz, jak pokazano w sekcji Instalowanie nowych fontów.
Ostatnia modyfikacja 2 listopada 2026