كيفية إضافة خطوط مخصصة إلى Collabora Online CODE Docker

لإتاحة استخدام خط مخصص في Collabora Online CODE (إصدار تطوير Collabora Online) المُشغّل في Docker، يجب أن تكون ملفات الخط متاحة لحاوية Collabora نفسها. تثبيتها على مضيف Docker فقط أو في حاوية Nextcloud منفصلة لا يجعلها متاحة لخادم المكتب. بالنسبة لنشر Compose واحد، يُعد ربط وحدة التخزين للقراءة فقط الخيار الأبسط عادةً؛ بينما يسهل إعادة إنتاج صورة مخصصة عبر مجموعة مُدارة، في حين أن تكوين الخط عن بُعد يُمكن أن يُركز عملية التوزيع إذا كان بالإمكان تشغيله بشكل آمن.

قد تختلف مسارات الخطوط الدقيقة باختلاف الصورة والإصدار. يقوم نشر Helm الحالي لـ Collabora بتثبيت الخطوط المخصصة في كل من المسارين `/usr/local/` و`/usr/local/` /usr/share/fonts/custom. /opt/cool/systemplate/usr/share/fonts/customيُعد هذا مرجعًا مفيدًا للموقعين، ولكنه ليس مضمونًا لكل علامة Docker مستقلة. تحقق من المسارات في الصورة التي تُشغّلها فعليًا قبل نشر المثال أدناه.

ما هي طريقة تثبيت الخطوط التي تناسب عملية النشر الخاصة بك؟

اختر بناءً على عدد نسخ CODE التي تحتفظ بها، وكيفية نشر التحديثات، وما إذا كان بإمكانك تشغيل مضيف خطوط آمن.

إذا قمت بتثبيت Collabora باستخدام مخطط Helm الخاص بها، فتحقق أولاً من إعدادات المخطط deployment.customFonts: يوفر المخطط الأصلي خيار ربط خط مخصص. أما في حالة إعداد Docker Compose المستقل، فتابع باستخدام ربط المجلدات إذا كانت مسارات الصور متطابقة.

قم بمراجعة قالب نشر Helm الأصلي وموقعي تثبيت الخطوط الخاصين به، وتحقق من قيم الخطوط المخصصة للمخطط .

قبل تغيير Docker، ما الذي يجب عليك التحقق منه؟

• تنسيق الخط: استخدم ملفات الخطوط التي يدعمها إعداد Collabora الخاص بك. يوثق مشروع خادم الخطوط الرسمي لـ Collabora ملفات TrueType .ttfو OpenType .otf.
• الترخيص: تأكد من أن ترخيص الخط يسمح باستخدامه وتوزيعه على المستخدمين من جانب الخادم. لا تقم بنسخ الخطوط من نظام تشغيل سطح المكتب إلا إذا كان الترخيص يسمح بذلك.
• اسم العائلة: الاسم المعروض في قائمة الخطوط مُستمد من البيانات الوصفية الداخلية للخط، وقد يختلف عن اسم الملف. لذا، يُرجى الاختبار باستخدام اسم العائلة، وليس اسم الملف فقط.
• في جميع الحالات: إذا كان الخادم الوكيل يوجه المستخدمين إلى عدة خوادم Collabora، فقم بتثبيت ملفات الخطوط نفسها على كل خادم. وإلا فقد يتم عرض المستند نفسه بشكل مختلف اعتمادًا على الخادم الذي يفتحه.
• مسارات الصور الدقيقة: تحقق من مجلدات الصورة قيد التشغيل وإعدادات بدء التشغيل. لا تستخدم مسارات قديمة بشكل أعمى، مثل /opt/loolمسارات من حزمة غير ذات صلة.

أنشئ مجلدًا مضيفًا ./fontsبجوار ملف Compose الخاص بك، وضع فيه الملفات المسموح بها .ttf. .otfواحرص على أن يقتصر محتوى هذا المجلد على الخطوط التي تنوي عرضها عبر Collabora.

كيف يمكن إضافة الخطوط باستخدام Docker Compose؟

أضف مدخلي وحدة التخزين للقراءة فقط إلى volumesقائمة خدمة Collabora الحالية. احتفظ بصورة الخدمة الحالية، والمنافذ، ومتغيرات البيئة، والإعدادات الأخرى؛ فهذا إضافة، وليس استبدالًا لملف Compose.

services:
  collabora:
    volumes:
      - ./fonts:/usr/share/fonts/custom:ro
      - ./fonts:/opt/cool/systemplate/usr/share/fonts/custom:ro

يقع مجلد المصدر على اليسار على مضيف Docker. أما المسارات على اليمين فهي داخل الحاوية. :roيجعل اللاحقة الملفات للقراءة فقط داخل الحاوية. تتبع مسارات الوجهة هذه قالب Helm الحالي لـ Collabora؛ بالنسبة لـ CODE Docker المستقل، تحقق من الوسم الخاص بك أولاً. إذا كان أي من الموقعين غير موجود أو كان إصدارك يستخدم مجلدات مختلفة، فاستخدم المسارات التي تدعمها تلك الصورة بدلاً من فرض هذا المثال.

قم بتطبيق تغيير Compose خلال فترة هادئة، لأن إعادة إنشاء خدمة Collabora قد تُقاطع جلسات التحرير النشطة. إذا كانت خدمتك تُسمى collabora، فقم بتشغيل:

docker compose up -d collabora

استخدم اسم خدمة Compose الفعلي إذا كان مختلفًا. تجنب إعادة تشغيل النظام بالكامل إلا إذا كانت هناك خدمات أخرى تحتاج أيضًا إلى تغيير في الإعدادات.

كيف يمكنك التأكد من أن الحاوية تستطيع رؤية الملفات؟

تأكد أولاً من أن المجلدات المُثبّتة تحتوي على ملفات الخطوط. استبدل collaboraاسم الحاوية المستخدمة في إعدادك بما يلي:

docker exec collabora ls /usr/share/fonts/custom
docker exec collabora ls /opt/cool/systemplate/usr/share/fonts/custom

يؤكد الاطلاع على الملفات وجود وحدات Docker المثبتة، لكنه لا يثبت تحميل المحرر للخط. إذا كانت الصورة تتضمن أدوات Fontconfig، فيمكنك فحص أسماء العائلات المكتشفة باستخدام fc-list، على سبيل المثال:

docker exec collabora fc-list : family file

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

كيف تختبر الخط في Collabora Online؟

1. افتح أو أنشئ مستندًا تجريبيًا من خلال التكامل العادي الذي يشغل محرر Collabora الخاص بك.
2. افتح قائمة عائلة الخطوط وابحث عن اسم عائلة الخط الداخلي.
3. حدده، واكتب عينة قصيرة، ثم احفظها، وأغلقها، وأعد فتح المستند.
4. تحقق من نفس المستند من مستخدم آخر أو متصفح آخر إذا كان لديك عدة نسخ من Collabora.

يوضح المثال أدناه نوع الفحص المتوقع: ظهور عائلة خطوط في قائمة المحرر. هذه ليست لقطة شاشة من بيئة تطوير برمجية حقيقية، وقد يختلف شريط الأدوات لديك باختلاف الإصدار أو التكامل.

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

متى تكون خدمة الصور المخصصة أو خدمة الخطوط عن بُعد مجدية؟

قم بإنشاء صورة مخصصة لضمان إمكانية تكرارها

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

استخدم إعدادات الخطوط عن بُعد لكتالوج مشترك

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

راجع مشروع Collabora الرسمي لخادم الخطوط ووثائق تكوين Collabora لمعرفة مدى توفر الخطوط عن بعد قبل اختيار هذا الأسلوب.

أي خيار يجب أن تختار؟

بالنسبة لحاوية CODE واحدة مُدارة باستخدام Docker Compose، ابدأ بربط وحدة تخزين للقراءة فقط: يسهل التراجع عنها ولا تتطلب إنشاءً مخصصًا. أما بالنسبة لمجموعة حاويات تتم صيانتها عبر التكامل المستمر/التسليم المستمر (CI/CD)، فيُفضل استخدام صورة مخصصة عندما ترغب في أن يحمل كل نشر مجموعة خطوط محددة وقابلة للمراجعة. لا تفكر في تكوين الخطوط عن بُعد إلا إذا كان التوزيع المركزي يُمثل فائدة تشغيلية ملموسة، ويمكنك توفير خدمة HTTPS آمنة وموثوقة. في جميع الأحوال، تحقق من المسارات واختبر الخط في مستند فعلي بعد النشر؛ فقائمة الخطوط الخاصة بالمضيف وحدها لا تكفي للتأكد من تحميل Collabora للخط.