إضافة الخطوط إلى خادم مستندات ONLYOFFICE: دوكر مقابل لينكس

لإضافة خطوط مخصصة إلى خادم مستندات ONLYOFFICE، ضع ملفات الخطوط المرخصة في دليل يمكن للخادم الوصول إليه، ثم شغّل الأمر /usr/bin/documentserver-generate-allfonts.sh. في عمليات النشر باستخدام Docker، يُفضّل عادةً استخدام دليل خطوط مُثبّت على الخادم بدلاً من نسخ الملفات إلى حاوية قيد التشغيل، لأنها تبقى محفوظة حتى بعد إعادة إنشاء الحاوية.

تعتمد طريقة التثبيت الصحيحة على مكان تشغيل ONLYOFFICE Docs، وعدد مرات إعادة بنائه، وما إذا كان بإمكانك قبول انقطاع قصير في الخدمة أثناء تحديث كتالوج الخطوط الخاص به.

اختر طريقة تثبيت الخط

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

قم بإعداد ملفات الخطوط وتأكيد الخادم المستهدف

1. تحديد عملية نشر ONLYOFFICE النشطة

قم بتشغيل البرنامج docker psعلى مضيف Docker إذا كان المحرر يعمل داخل حاويات. ابحث عن اسم حاوية خادم المستندات في NAMESالعمود؛ تستخدم الأمثلة أدناه اسمًا مختلفًا onlyoffice-documentserver. استبدل هذه القيمة إذا كانت مختلفة لديك. لا يؤثر تكامل Nextcloud أو ownCloud عادةً على حقيقة أنه يجب تثبيت الخطوط على خادم ONLYOFFICE Docs، وليس فقط على خادم التخزين أو الكمبيوتر الذي يعرض المستند.

docker ps

2. جمع ملفات الخطوط المرخصة

اختر عائلات خطوط كاملة ومرخصة بشكل صحيح، بما في ذلك الأوزان والأنماط المستخدمة فعليًا في مستنداتك. تُدرج ONLYOFFICE تنسيقات TrueType وOpenType مثل .ttfو .otf، بالإضافة إلى امتدادات الخطوط الأخرى المدعومة، في وثائق خطوط Linux الخاصة بها . لضمان عملية نشر أولية سلسة، استخدم ملفات TTF أو OTF عادية، وتحقق من الاستخدام المسموح به على الخادم والعميل في ترخيص الخط.

في مثال Docker، قم بتهيئة الملفات /srv/onlyoffice/custom-fontsعلى مضيف Docker. أسماء الملفات المذكورة Inter-Regular.ttfهي Inter-Bold.ttfأمثلة توضيحية فقط؛ استخدم الملفات التي لديك صلاحية تثبيتها.

sudo mkdir -p /srv/onlyoffice/custom-fonts
sudo cp Inter-Regular.ttf Inter-Bold.ttf /srv/onlyoffice/custom-fonts/
sudo chmod 644 /srv/onlyoffice/custom-fonts/*.ttf

نفّذ هذه الأوامر من المجلد الذي يحتوي على ملفات الخطوط. تحقق من محتويات المجلد قبل المتابعة. في الأنظمة المُدارة، عدّل ملكية المجلد وأذونات الوصول وفقًا لسياسة الأمان الخاصة بك، بدلاً من جعله قابلاً للكتابة للجميع.

يُنصح باستخدام Docker: تثبيت مجلد الخطوط بشكل دائم

3. أضف ربطًا إلى خدمة Compose الحالية

في ملف Compose الحالي، ابحث عن الخدمة التي تُشغّل صورة خادم مستندات ONLYOFFICE. أضف الإدخال التالي إلى قائمتها الحالية volumes؛ مع الاحتفاظ بوحدات التخزين والمنافذ وبيانات الاعتماد ومتغيرات البيئة الأخرى التي تم تكوينها مسبقًا:

services:
  onlyoffice-documentserver:
    volumes:
      - /srv/onlyoffice/custom-fonts:/usr/share/fonts/truetype/custom:ro

يوجد مسار المصدر على مضيف Docker، بينما توجد الوجهة داخل الحاوية. :roيقيّد اللاحقة عمليات الكتابة داخل الحاوية إلى دليل الخطوط. يُنصح بتثبيت customالدليل المخصص بدلاً من استبدال /usr/share/fontsالشجرة بأكملها، مما قد يخفي الخطوط المُضمّنة في الصورة. يُعرّف ملف Dockerfile الرسمي الخاص بـ ONLYOFFICE دليل خطوط TrueType المخصص كوحدة تخزين في مرحلتي صورتي Community وEnterprise.

راجع إعدادات Compose المُعدّلة، ثم طبّقها docker compose up -dمن مجلد المشروع. قد يؤدي هذا إلى إعادة إنشاء الخدمة: لذا، جدوِل التغيير عندما يتمكن المحررون من إغلاق المستندات بأمان. إذا كنت تستخدم docker runنشرًا عاديًا، فأضف وسيطة القراءة فقط --mount type=bind,src=/srv/onlyoffice/custom-fonts,dst=/usr/share/fonts/truetype/custom,readonlyالمكافئة عند إعادة إنشاء الحاوية.

4. تأكد من أن الحاوية يمكنها رؤية ملفات الخطوط

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

docker exec onlyoffice-documentserver ls -l /usr/share/fonts/truetype/custom
docker exec onlyoffice-documentserver fc-list | grep -i 'Inter'

بالنسبة لخطوط Inter التجريبية، يجب أن يُظهر الأمر الثاني عائلة الخطوط المطابقة إذا اكتشفها برنامج fontconfig. إذا كانت الملفات موجودة ولكن عائلة الخطوط غير ظاهرة، فتحقق من الأذونات وشغّل الأمر docker exec onlyoffice-documentserver fc-cache -f، ثم تحقق fc-listمرة أخرى. لا يؤدي اكتشاف برنامج fontconfig وحده إلى ملء قائمة محرر ONLYOFFICE.

5. إعادة إنشاء كتالوج خطوط ONLYOFFICE

بعد وجود الملفات داخل الحاوية، قم بتشغيل برنامج إنشاء الخطوط الخاص بخادم المستندات:

docker exec onlyoffice-documentserver /usr/bin/documentserver-generate-allfonts.sh

يستخدم برنامج ONLYOFFICE هذه الخطوة لتحديث بيانات اختيار الخطوط ومواردها. قد تؤثر هذه الخطوة على خدمات التحرير النشطة، لذا يُنصح بتشغيلها خلال فترة صيانة مناسبة. GENERATE_FONTSكما أن متغير بيئة Docker الموثق مُعيّن افتراضيًا على true، مما يُعيد إنشاء بيانات الخطوط عند بدء تشغيل الحاوية؛ وهذا مفيد بعد إعادة التشغيل، ولكنه لا يُغني عن تثبيت الملفات في موقع دائم.

لا تقم بتغيير الإعدادات GENERATE_FONTSأو إعادة تشغيل النظام لمجرد إخفاء وحدة تخزين مفقودة. تحقق أولاً من أن الملفات المتوقعة مثبتة بالفعل.

البدائل: نسخة مؤقتة من Docker أو نظام Linux أصلي

6. استخدم نسخة حاوية مباشرة لاختبار قصير الأجل

إذا تعذر عليك تغيير Compose فورًا، فانسخ ملفًا إلى الحاوية الحالية وأعد بناء الكتالوج. يتبع هذا النهج الموثق من ONLYOFFICE والمُعتمد في Docker، ويتجنب إعادة بناء الحاوية لإجراء اختبار سريع.

docker cp ./Inter-Regular.ttf onlyoffice-documentserver:/usr/share/fonts/truetype/custom/
docker exec onlyoffice-documentserver /usr/bin/documentserver-generate-allfonts.sh

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

7. التثبيت مباشرة على خادم مستندات لينكس غير مُحَوَّل إلى حاوية

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

sudo install -d -m 755 /usr/share/fonts/truetype/custom
sudo install -m 644 Inter-Regular.ttf /usr/share/fonts/truetype/custom/
sudo /usr/bin/documentserver-generate-allfonts.sh

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

8. تحقق من نوع الخط في مستند فعلي

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

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

هناك ملاحظة هامة خاصة بإصدار المتصفح: تنص تعليمات الخطوط في ONLYOFFICE على مسح ذاكرة التخزين المؤقت للمتصفح وإعادة فتح المحرر في الإصدار 8.1.3 أو الإصدارات الأقدم . أما في الإصدارات الأحدث، فلا داعي لهذه الخطوة الإضافية. إذا كان إصدارك أقدم، فاستخدم خطوة مسح ذاكرة التخزين المؤقت الموثقة قبل البحث عن أسباب أكثر تعقيدًا.

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