ترقية TeX Live

ترقية TeX Live أو تثبيت الحزم في نشر Overleaf Community Edition.

تنطبق التعليمات التالية فقط على تثبيتات Community Edition. نوصي بشدة مستخدمي Ayakaleaf Pro بتفعيل الترجمة المعزولة (Sandboxed Compiles)، إذ توفّر للمستخدمين الوصول إلى صور TeX Live مطابقة تقريبًا لتلك المستخدمة على overleaf.com، إضافةً إلى توفير العزل بين عمليات ترجمة المشاريع لتعزيز الأمان.

لتوفير عرض النطاق، تأتي صور Overleaf Community Edition و Ayakaleaf Pro مع تثبيت أدنى فقط من TeX Live. يمكنك تثبيت المزيد من الحزم أو الترقية إلى تثبيت كامل لـ TeX Live باستخدام الأمر tlmgr داخل الحاوية sharelatex.

​

الدخول إلى حاوية sharelatex

لبدء صدفة (shell) داخل الحاوية sharelatex، شغّل

bin/shell

سيظهر لك موجّه يبدو هكذا:

root@309b192d4030:/#

في التعليمات التالية، سنفترض أنك داخل الحاوية.

​

تحديد إصدار TeX Live الحالي

يصدر TeX Live كل عام في حوالي شهر أبريل. وتختلف خطوات استخدام tlmgr بحسب ما إذا كنت تستخدم الإصدار الحالي أو إصدارًا أقدم. يمكنك التحقق من إصدار TeX Live الذي تشغّله باستخدام tlmgr --version. على سبيل المثال، يشغّل هذا التثبيت TeX Live 2021:

# tlmgr --version
tlmgr revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr using installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) version 2021

يمكن العثور على الإصدار الحالي من TeX Live في الصفحة الرئيسية لـ TeX Live.

إذا كنت تشغّل إصدارًا أقدم من TeX Live، فلديك خياران. عادةً ما يصدر إصدار جديد من صورة Overleaf Docker بعد فترة قصيرة من إصدار TeX Live، لذا يمكنك إما انتظاره وترقية نشرك باستخدام السكربت bin/upgrade، أو إذا كنت تفضّل الاحتفاظ بإصدار TeX Live الأقدم، فستحتاج أولًا إلى إخبار tlmgr باستخدام مستودع تاريخي. ستجد تعليمات القيام بذلك هنا.

​

تثبيت الحزم

لتثبيت TeX Live كاملًا، شغّل هذا الأمر داخل الحاوية sharelatex:

tlmgr install scheme-full

يمكنك أيضًا تثبيت حزم منفردة يدويًا:

tlmgr install tikzlings tikzmarmots tikzducks

بدءًا من الإصدار 3.3.0 فصاعدًا، أصبح تشغيل tlmgr path add مطلوبًا مجددًا بعد كل استخدام لـ tlmgr install، وذلك لإنشاء الروابط الرمزية لجميع الملفات التنفيذية في مسار النظام بشكل صحيح.

تتوفر أوامر أخرى كثيرة. اعرف المزيد باستخدام:

tlmgr help

عند الانتهاء، اكتب exit أو اضغط Control-D للخروج من الصدفة.

​

حفظ تغييراتك

التغييرات التي أجريتها للتو عدّلت الحاوية sharelatex، لكنها مؤقتة — وستُفقد إذا أعاد Docker Compose إنشاء الحاوية، على سبيل المثال كجزء من تحديث الإعدادات.

لجعلها دائمة، استخدم docker commit لحفظ التغييرات في صورة Docker جديدة:

cat config/version #5.2.1
docker commit sharelatex sharelatex/sharelatex:5.2.1-with-texlive-full
echo 5.2.1-with-texlive-full > config/version

بعد حفظ التغييرات، حدّث config/version وفقًا لذلك. ثم شغّل bin/up لإعادة إنشاء الحاوية sharelatex.

ستحتاج إلى تكرار هذه الخطوات في كل مرة تقوم فيها بالترقية إلى إصدار جديد من Overleaf.