توفير خطوط مخصصة في Collabora CODE Docker

لإنشاء عرض خط مخصص في Collabora Online CODE المُشغّل داخل Docker، احتفظ بملفات الخط على الجهاز المضيف، وقم بتثبيت نفس المجلد في كلٍ من مجلد خطوط النظام الخاص بالحاوية ولوحة نظام المستندات. تُزوّد ​​لوحة النظام عمليات المستندات المعزولة بالملفات؛ إذ /usr/share/fontsيُمكن أن يؤدي تثبيت الخطوط في هذا المجلد فقط إلى ظهور عائلة الخطوط في قائمة الخطوط دون عرضها في المستند. يستخدم هذا الدليل Docker Compose ومسار صورة CODE الحالي /opt/cool/systemplate؛ تحقق من المسار إذا كنت تستخدم صورة أخرى.

اختر مصدر خط يمكنك صيانته

يُعدّ ربط المجلد للقراءة فقط الخيار الأبسط عادةً لمضيف Docker واحد. فهو يحافظ على ملفات الخطوط عند إعادة إنشاء حاوية CODE أو ترقيتها، ويتيح لك مراجعة الملفات التي يمكن للحاوية قراءتها بدقة. استخدم ملفات الخطوط التي لديك صلاحية تثبيتها وإعادة توزيعها على الخادم. لا تنسخ مجلد الخطوط الخاص بنظام سطح المكتب بالكامل إلا بعد التحقق من تراخيصه والتأكد من حاجتك لتلك الملفات.

استخدم ملفات خطوط غير مضغوطة بتنسيقات يدعمها نظامك، مثل TrueType .ttfأو OpenType .otf. أضف الأنماط التي تحتاجها مستنداتك، مثل العادي، والغامق، والمائل، والغامق المائل. حافظ على وضوح أسماء العائلات وأسماء الملفات، وتأكد من قدرة مستخدم الحاوية على قراءة جميع المجلدات والملفات. قد يتسبب استخدام خط يحتوي على نمط واحد فقط في استبدال Collabora لنمط آخر عند طلب المستند للنمط الغامق أو المائل.

قم أولاً بإنشاء دليل مضيف مخصص وانسخ الملفات المصرح بها إليه:

sudo mkdir -p /srv/collabora/fonts
sudo cp BrandSans-Regular.ttf BrandSans-Bold.ttf /srv/collabora/fonts/
sudo chmod -R a+rX /srv/collabora/fonts

استبدل أسماء الملفات النموذجية بأسماء ملفات الخطوط الفعلية لديك. تُعدّ صلاحية القراءة مهمة لأن عملية CODE تعمل بحساب غير مميز في الصور الحالية. حافظ على ثبات مسار المجلد؛ إذ ستشير إليه عمليات الربط في Compose.

قم بتثبيت الخطوط في كل من شجرة الخطوط المضيفة ولوحة النظام

collaboraأضف إدخالات وحدة التخزين هذه إلى خدمتك الحالية docker-compose.yml. احتفظ بالصورة والمنافذ وقائمة النطاقات المسموح بها وإعدادات SSL والأسرار وسياسة إعادة التشغيل الحالية؛ يوضح المقتطف أدناه فقط عمليات تحميل الخطوط.

services:
  collabora:
    volumes:
      - /srv/collabora/fonts:/usr/share/fonts/truetype/more:ro
      - /srv/collabora/fonts:/opt/cool/systemplate/usr/share/fonts/truetype/more:ro

يُتيح الهدف الأول إمكانية الوصول إلى الخطوط من خلال نظام اكتشاف الخطوط الخاص بالحاوية. أما الهدف الثاني، فيضعها داخل القالب المُستخدم لإعداد بيئات المستندات المعزولة. يُوثّق دليل حزمة تطوير البرمجيات (SDK) الخاصة بـ Collabora نمط وحدة التخزين ثنائية الموقع هذا لـ Docker. تجنّب التثبيت فوق الدليل الكامل /usr/share/fontsأو دليل لوحة النظام، فقد يُخفي ذلك الخطوط المُضمّنة مُسبقًا في الصورة.

مسار قالب النظام حساس للإصدار. تُعرّف بيانات تعريف صورة CODE 26.04 الحالية /opt/cool/systemplateمسار قالب النظام، وتستخدم وثائق Collabora الحالية هذا الموقع. إذا كنت تستخدم صورة أقدم أو إصدارًا خاصًا بمورد معين، فراجع وثائق تلك الصورة أو إعدادات بدء التشغيل قبل تعديل المسار المستهدف.

أعد إنشاء الحاوية وتأكد من اكتشاف الخط

بعد حفظ ملف Compose ووضع ملفات الخطوط على المضيف، أعد إنشاء خدمة CODE حتى يقوم Docker بتطبيق عمليات الربط:

docker compose up -d --force-recreate collabora
docker compose exec -T collabora fc-list

في المخرجات، ابحث عن اسم عائلة الخط أو مسار الملف المُثبَّت. لتضييق نطاق القائمة، مرِّر المخرجات grepمع اسم العائلة الذي يُظهره الخط نفسه، على سبيل المثال:

docker compose exec -T collabora fc-list | grep -i "Brand Sans"

إذا لم يُظهر الأمر أي تطابق، فتحقق من مسار المضيف، وأذونات الملفات، ومسافة الربط، وسجلات الحاوية. يمكنك فحص عمليات الربط الفعلية باستخدام الأمر docker inspectعلى الحاوية قيد التشغيل، أو استخدام الأمر docker compose configلاكتشاف أخطاء مسافة الربط في YAML. docker compose downلا يلزم عادةً تشغيل الأمر لتطبيق تغيير وحدة التخزين؛ فإعادة إنشاء الخدمة كافية.

تأكد من أن الخط يظهر بشكل صحيح داخل المستند الفعلي

افتح مستندًا تجريبيًا عبر التكامل المعتاد مع Nextcloud أو WOPI، وحدد عينة نصية قصيرة، ثم اختر نوع الخط المخصص من منتقي الخطوط. اكتب سطرًا جديدًا بهذا الخط، واحفظ الملف، وأغلقه، ثم أعد فتحه. تحقق من النص العادي والغامق، وقارن فواصل الأسطر أو تخطيط الصفحة مع المستند الأصلي. يُعد ظهور نوع الخط في القائمة مجرد فحص مبدئي؛ أما النص المرئي بعد إعادة فتح المستند فهو الفحص المفيد لعرض النص.

• يظهر الخط في القائمة ولكن النص يختفي أو يعود إلى وضعه السابق: تأكد من أن عملية التحميل الثانية تستهدف دليل خط النظام وأنها تحتوي على نفس الملفات.
• الخط مفقود من القائمة: تأكد من أن الملفات صالحة وقابلة للقراءة، ثم افحص fc-listالمخرجات وسجلات بدء تشغيل الحاوية.
• يعمل الخط حتى يتم تحديث الصورة: تحقق من بقاء كلا المثبتين في Compose وأن دليل المضيف الخاص بك ليس داخل مسار حاوية مؤقتة.
• لا تظهر جميع الأحرف: قد لا يحتوي الخط المُختار على هذه الرموز. أضف خطًا يدعم النصوص المطلوبة أو استخدم خطًا بديلًا مناسبًا.

يُبقي الربط المباشر الخطوط مستقلة عن صورة CODE، ولكنه لا يضمن تطابق التنسيق على جميع الأجهزة أو في جميع المستندات. قد يؤدي استبدال الخطوط، أو فقدان بعض الأحرف، أو اختلاف إصدارات الخطوط، أو التنسيق الخاص بكل مستند إلى تغيير التفاف الأسطر. لمزيد من تفاصيل التكوين، يُرجى مراجعة وثائق تثبيت الخطوط الخاصة بـ Collabora ، ودليل صورة CODE Docker ، ودليل Collabora Online SDK . يُنصح بمراجعة مثال Docker في الدليل ووثائق الصورة الحالية عند تغيير إصدارات CODE.