كيفية إضافة خطوط مخصصة إلى خادم مستندات ONLYOFFICE

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

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

ما الذي يتغير عند تثبيت خط؟

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

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

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

اختر طريقة التثبيت المناسبة

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

تُظهر أدلة الخطوط المنشورة حاليًا من ONLYOFFICE نفس المسار الرئيسي لإصدار Community Edition على نظامي Linux وDocker، كما تنشر دليلًا منفصلًا لنظام Linux خاصًا بإصدار Enterprise Edition. قد تختلف المسارات والأذونات وتنسيق الحاويات باختلاف الإصدار وطريقة التثبيت، لذا يُنصح باستخدام الإعدادات الحالية لنظامك بدلًا من استبدالها بنموذج من بيئة أخرى.

إضافة خطوط على نظام لينكس

1. قم بإعداد ملفات الخطوط وتثبيتها

احصل على ملفات عائلة الخطوط المطلوبة، بما في ذلك النسختين الغامقة والمائلة إن توفرتا. احتفظ بمجموعة الخطوط في مجلد يحمل اسمًا واضحًا. على سبيل المثال، قد يضع مسؤول النظام عائلة الخطوط في /usr/share/fonts/المسار المذكور في تعليمات برنامج ONLYOFFICE لنظام Linux.

sudo mkdir -p /usr/share/fonts/custom/brand-sans
sudo cp BrandSans-*.ttf /usr/share/fonts/custom/brand-sans/

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

2. إعادة إنشاء قائمة خطوط ONLYOFFICE

قم بتشغيل برنامج توليد الخطوط الخاص بالبائع بعد تثبيت الملفات:

sudo /usr/bin/documentserver-generate-allfonts.sh

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

إضافة خطوط إلى عملية نشر Docker

1. اجعل مجلد الخطوط دائمًا

في حالة النشر المُدار باستخدام Docker Compose، أضف ربطًا مباشرًا لخدمة خادم المستندات الحالية. أنشئ مجلدًا على المضيف للملفات، ثم اربطه بمجلد الخطوط المخصصة للحاوية. تُعرّف صورة Docker الخاصة بـ ONLYOFFICE هذا /usr/share/fonts/truetype/customالمجلد كوحدة تخزين، كما تسمح تعليمات خطوط Docker الخاصة بها بنسخ الخطوط ضمنه /usr/share/fonts/.

services:
  onlyoffice-documentserver:
    image: onlyoffice/documentserver:<your-pinned-version>
    volumes:
      - /srv/onlyoffice/fonts:/usr/share/fonts/truetype/custom

هذا جزءٌ برمجيٌّ يُدمج في ملف Compose الحالي، وليس تكوينًا بديلًا كاملًا. احتفظ بإصدار الصورة الحالي، والشبكات، ومتغيرات البيئة، ووحدات تخزين البيانات، والأسرار، واسم الخدمة. جهّز ملفات الخطوط على المضيف /srv/onlyoffice/fontsوتأكد من قدرة الحاوية على قراءتها.

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

2. أعد إنشاء أو أعد تشغيل التطبيق، ثم أنشئ بيانات تعريف الخط.

قم بتطبيق عملية الربط باستخدام سير عمل Compose المعتاد لنشرك. ثم شغّل برنامج إنشاء الخطوط داخل حاوية خادم المستندات الفعلية. بالنسبة لحاوية تحمل الاسم onlyoffice-documentserver، يكون الأمر كالتالي:

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

استخدم اسم الحاوية أو معرّفها الموضح docker ps. إذا كنت ترغب فقط في التحقق من خط قبل تثبيت الإعداد، فراجع وثائق المورّد حول نسخ ملفات الخطوط إلى حاوية قيد التشغيل باستخدام الأمر `npm run dev` docker cp، ثم تشغيل نفس البرنامج النصي داخلها. اعتبر ذلك اختبارًا: قد تختفي الملفات المنسوخة إلى الحاوية عند استبدالها.

تحقق من نوع الخط في المحرر وفي الناتج

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

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

إذا كان الخط مفقودًا أو تغير التخطيط

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

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

المراجع الرسمية

• إصدار ONLYOFFICE Docs Community: إضافة الخطوط على نظام لينكس
• إصدار ONLYOFFICE Docs Community: إضافة الخطوط على Docker
• إصدار ONLYOFFICE Docs Enterprise: إضافة الخطوط على نظام Linux
• مستودع ONLYOFFICE Docker-DocumentServer