Chuyển đến nội dung chính
Bạn có thể mở rộng một image TeX Live sẵn có bằng một Dockerfile mới và cấu hình ứng dụng để sử dụng image mới đó. Dưới đây là một số hướng dẫn để cài đặt gói hoặc phông chữ mới. Các image TeX Live hiếm khi được cập nhật. Chúng tôi khuyên bạn nên build lại các image tùy chỉnh khi nâng cấp Ayakaleaf Pro.
Các phần sau chỉ áp dụng cho Sandboxed Compiles.

Cài đặt và cập nhật gói mới

Bạn có thể dùng các lệnh tlmgr như tlmgr install và tlmgr update để quản lý các gói TeX Live như trong ví dụ sau:

Sử dụng tlmgr trong image TeX Live cũ hơn

Theo mặc định, tlmgr tải tài nguyên từ bản phát hành TeX Live mới nhất. Khi vá một image TeX Live cũ hơn, nguồn tải cần được chuyển sang kho lưu trữ (archive) tương ứng. Xem danh sách tại https://www.tug.org/historic/ để biết các mirror của kho lưu trữ.

Cài đặt phông chữ mới

Có nhiều quy trình khác nhau để cài đặt phông chữ mới trong một bản phân phối TeX Live, và việc cài đặt một phông chữ tùy chỉnh có thể cần nhiều bước. Tham khảo hướng dẫn cài đặt phông chữ TeX trong tài liệu chính thức của TeX Live có lẽ là một điểm khởi đầu tốt. Dockerfile sau đây minh họa việc cài đặt một phông chữ TrueType lên một image TeX Live 2022 sẵn có:

Cấu hình Ayakaleaf Pro để sử dụng image mới

Sử dụng tên ghcr.io/ayaka-notes/texlive-full và một tag tùy chỉnh để build image mới, ví dụ:
Giờ đây ta có thể cấu hình Ayakaleaf Pro để sử dụng image 2023.1-custom mới bằng cách cập nhật các biến môi trường TEX_LIVE_DOCKER_IMAGE, ALL_TEX_LIVE_DOCKER_IMAGES và ALL_TEX_LIVE_DOCKER_IMAGE_NAMES (các tên là tùy chọn và tuân theo thứ tự của các image):
Trong ví dụ trên, các dự án mới được đặt mặc định sử dụng image 2023.1-custom mới, trong khi 2023.1 vẫn sẵn có khi cần. Image tùy chỉnh chỉ tồn tại trên máy chủ (host) của bạn, vì vậy bin/up không thể pull nó. Hãy đặt SIBLING_CONTAINERS_PULL=false trong config/overleaf.rc (tự pull các image khác bằng docker pull), sau đó chạy bin/up -d để áp dụng các thiết lập mới.

Hỏi & Đáp

Trả lời: Không, nếu dùng các image texlive-full. Các image này bao gồm các gói tiếng Trung của TeX Live (ctex, xeCJK) cùng với phông chữ Fandol, và các phông chữ Noto CJK (ví dụ Noto Serif CJK SC). Hãy đặt trình biên dịch của dự án thành XeLaTeX trong phần cài đặt trình soạn thảo, sau đó biên dịch, ví dụ:
Để dùng Noto thay cho Fandol, hãy thêm \setCJKmainfont{Noto Serif CJK SC}. Không cần latexmkrc. Đối với các phông chữ khác, hãy build một image tùy chỉnh như được trình bày trong Cài đặt phông chữ mới.
Lần sửa đổi cuối 2 tháng 11, 2026