توسيع TeX Live

توسيع صور TeX Live Docker بالحزم والخطوط لبيئات الترجمة المدعومة.

يمكن توسيع صورة TeX Live موجودة باستخدام Dockerfile جديد، وإعداد التطبيق لاستخدام الصورة الجديدة.

نقدّم هنا بعض الإرشادات لتثبيت حزم أو خطوط جديدة، لكن إعداد صورة مخصصة لا تشمله شروط الدعم الخاصة بنا.

تتلقى صور TeX Live تحديثات غير متكررة. نقترح إعادة بناء الصور المخصصة عند ترقية Server Pro.

تنطبق الأقسام التالية على Server Pro و الترجمة المعزولة (Sandboxed Compiles) فقط.

​

تثبيت الحزم الجديدة وتحديثها

يمكنك استخدام أوامر tlmgr مثل tlmgr install و tlmgr update لإدارة حزم TeX Live كما في المثال التالي:

FROM ghcr.io/ayaka-notes/texlive-full:2023.1

RUN tlmgr update --force ebproof

​

استخدام tlmgr في صورة TeX Live أقدم

افتراضيًا، يقوم tlmgr بتنزيل الموارد من أحدث إصدار من TeX Live. عند ترقيع صورة TeX Live أقدم، يجب تحويل التنزيلات إلى الأرشيف المناسب. راجع القائمة في https://www.tug.org/historic/ للاطلاع على مرايا الأرشيفات.

FROM ghcr.io/ayaka-notes/texlive-full:2022.1

RUN tlmgr option repository <MIRROR>/systems/texlive/<YEAR>/tlnet-final
# e.g. RUN tlmgr option repository ftp://tug.org/historic/systems/texlive/2022/tlnet-final

RUN tlmgr update --force ebproof

​

تثبيت خطوط جديدة

توجد إجراءات مختلفة لتثبيت خطوط جديدة في توزيعة TeX Live، وقد يتطلب تثبيت خط مخصص عدة خطوات. ومن المرجح أن يكون الاطلاع على تعليمات تثبيت خطوط TeX في توثيق TeX Live الرسمي نقطة بداية جيدة.

يوضح الملف Dockerfile التالي مثالًا على تثبيت خط TrueType فوق صورة TeX Live 2022 موجودة:

FROM ghcr.io/ayaka-notes/texlive-full:2022.1

COPY ./myfonts/*.ttf /usr/share/fonts/truetype/myfont/

# rebuild font information cache
RUN fc-cache

​

إعداد Server Pro لاستخدام الصور الجديدة

استخدم الاسم ghcr.io/ayaka-notes/texlive-full ووسمًا (tag) مخصصًا لبناء الصورة الجديدة، كما في:

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:

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"

في المثال أعلاه، يتم تعيين المشاريع الجديدة افتراضيًا لاستخدام الصورة الجديدة 2023.1-custom، بينما تظل 2023.1 متاحة عند الحاجة إليها.