انشر كود Collabora على Kubernetes باستخدام Helm
قم بتثبيت مخطط Collabora Helm الرسمي، وقم بتكوين الوصول إلى WOPI وتقارب الدخول، وتحقق من النشر دون أخطاء الإعداد الشائعة.
لتدقيق إملائي لأكثر من لغة في Collabora Online، أضف رمز كل لغة مطلوبة إلى dictionariesإعدادات حاوية CODE، ثم أعد تشغيل الحاوية، وعيّن اللغة الصحيحة لكل فقرة نصية. كلا الجانبين مهمان: يجب أن يوفر الخادم القواميس، ويجب أن يُحدد المستند اللغة الإنجليزية أو الفرنسية أو أي فقرة أخرى بلغتها. إضافة لغة إلى الحاوية وحدها لا تُحدد تلقائيًا جميع اللغات في المستند.
هناك إعدادان منفصلان يجب أخذهما في الاعتبار:
dictionariesويُغيّر متغير بيئتها قائمة لغات القواميس التي تُهيئها CODE. يُوثّق دليل SDK الخاص بـ Collabora 25.04 رموز اللغات المفصولة بمسافات، والتي قد يتبعها رمز الدولة، ويُشير إلى أن تقييد القائمة يُساعد على تجنّب الاستخدام غير الضروري للموارد وعمليات بدء التشغيل.على سبيل المثال، يتطلب مستند يحتوي على نصوص باللغتين الإنجليزية (الولايات المتحدة) والفرنسية تفعيل كلا اللغتين على الخادم، ويجب أن يحمل النص الإنجليزي والفرنسي إعدادات اللغة المناسبة. لا تُعد لغة واجهة المستخدم أو تخطيط لوحة المفاتيح بديلاً عن أي من هذين الإعدادين. راجع دليل Collabora Online 25.04 SDK وموضوع المساعدة الخاص بـ Collabora حول اختيار لغة المستند .
أضف رموز اللغة المطلوبة كسلسلة مفصولة بمسافات في بيئة خدمة Collabora. في هذا المثال، تقتصر القائمة على الإنجليزية الأمريكية والإنجليزية البريطانية والفرنسية.
services:
collabora:
image: collabora/code
restart: unless-stopped
environment:
dictionaries: "en_US en_GB fr_FR"
domain: "cloud\.example\.com"
username: "collabora_admin"
password: "replace-with-a-long-unique-password"
ports:
- "127.0.0.1:9980:9980"
استبدل نمط النطاق، وبيانات الاعتماد، ووسم الصورة، وتعيين المنفذ بما يتوافق مع بيئة النشر الخاصة بك. احتفظ بإعدادات الخادم الوكيل العكسي واتصال Nextcloud الحالية؛ يوضح هذا المقتطف مكان قائمة القاموس فقط. إذا كنت تستخدم ملف Compose بالفعل، فقم بتعديل خدمة Collabora الحالية بدلاً من إنشاء حاوية ثانية.
تتبع رموز اللغات المذكورة أعلاه الرموز الموثقة من قِبل Collabora، حيث يمكن أن تتضمن اللغة رمز الدولة. استخدم رموزًا تتوافق مع لغات المستندات التي يحتاجها المستخدمون. لا تفترض أن كل رمز ممكن له قاموس قابل للاستخدام في كل صورة CODE: يشرح دليل SDK كيفية تغيير القائمة المُكوّنة، بينما يظل الإصدار المُثبّت وقواميسه هما ما يحددان ما هو متاح فعليًا. راجع وثائق إصدار صورة CODE الذي تستخدمه قبل إضافة لغات أقل شيوعًا.
dictionariesالقيمة لتشمل اللغات التي يحتاجها المستخدمون فقط. احتفظ بمتغيرات بيئة Collabora الأخرى.docker compose up -d --force-recreate collaboraمن الدليل الذي يحتوي على ملف Compose.docker compose logs --tail=100 collabora. ابحث عن أخطاء بدء التشغيل أو تحميل القاموس؛ لا تعتبر حالة الحاوية الناجحة وحدها دليلاً على تثبيت قاموس معين.إذا كان النشر الخاص بك يستخدم docker runبدلاً من ذلك، فقم بتحديث وسيطته -e dictionaries="en_US en_GB fr_FR"وأعد إنشاء تلك الحاوية بنفس خيارات الشبكة ووحدة التخزين والوكيل والأمان. تغيير البيئة على حاوية قيد التشغيل لا يغير البيئة التي تم تشغيلها بها.
بعد أن يصبح الخادم جاهزًا، افتح مستندًا في Nextcloud وحدد النص الذي تريد التحقق من لغته. في عناصر تحكم اللغة في Collabora، اختر اللغة للنص المحدد أو الفقرة؛ أما إذا كان المستند مكتوبًا بلغة واحدة، فاستخدم الخيار الذي يطبق اللغة على النص بأكمله. قد تختلف مسميات الأوامر اختلافًا طفيفًا بين الإصدارات وتخطيطات الشاشة، ولكن الأهم هو تحديد لغة نص المستند بدلًا من تغيير لغة واجهة المستخدم فقط. يشرح دليل Collabora أن لغة المستند تحدد القاموس المستخدم للتدقيق الإملائي، وقاموس المرادفات، والوصل.
في المستندات متعددة اللغات، طبّق اللغة على أجزاء. على سبيل المثال، حدّد الفقرة الفرنسية واضبط اللغة على الفرنسية (فرنسا)، ثم حدّد الفقرات الإنجليزية واضبط اللغة على الإنجليزية (الولايات المتحدة). إذا ورث نص جديد اللغة الخاطئة، فضع المؤشر في تلك الفقرة وغيّر لغتها قبل الكتابة، أو حدّد النص وأعد تصنيفه لاحقًا. قد تكون الكلمة التي تبدو بها أخطاء إملائية مجرد نص مُصنّف باللغة الخاطئة.
يمكن أيضًا تعطيل التدقيق الإملائي لنص محدد أو لغة معينة. في قائمة لغات Collabora، يستثني خيار "بلا" النص المحدد من التدقيق الإملائي والوصل. إذا كان النص مكتوبًا باللغة الصحيحة ولكنه لا يتلقى أي علامات إملائية، فتحقق من حالة التدقيق الإملائي لتلك اللغة، وتأكد مما إذا كان النص المحدد مستثنى. تشرح صفحة مساعدة لغات Collabora خيارات اللغة وخيار "بلا".
| ما تراه | ما الذي يجب التحقق منه |
|---|---|
| لغة واحدة فقط تحصل على علامات إملائية | تأكد من وجود جميع الرموز المطلوبة dictionaries، ثم أعد إنشاء CODE، ثم اختبر النص الذي تم وضع علامات عليه بشكل صريح بكل لغة. |
| تتوفر لغة في القائمة، ولكن لم يتم تحديد أي كلمات | قم بتعيين النص المحدد إلى تلك اللغة وتأكد من تفعيل التدقيق الإملائي بدلاً من ضبطه على "لا شيء". إن وجود القائمة وحده لا يثبت أن القاموس يعمل. |
| لا تُطبَّق التغييرات بعد تحرير "إنشاء" | تأكد من أنك قمت بإعادة إنشاء خدمة Collabora وأن الحاوية قيد التشغيل هي الحاوية التي يديرها مشروع Compose الذي تم تعديله. |
| لا يستطيع Nextcloud فتح المستندات بعد إعادة إنشائها | تحقق من سجلات خدمة Collabora وسجلات الوكيل، وتأكد من أن إعدادات Office في Nextcloud لا تزال تشير إلى عنوان URL لخادم Collabora. لا يُصلح تكوين القاموس اتصال WOPI أو اتصال الوكيل العكسي. |
يشرح دليل إدارة Nextcloud عنوان URL لخادم Collabora ضمن إعدادات Office. احتفظ بإعداد التكامل هذا منفصلاً عن تغيير القاموس؛ فإذا كان الاتصال يعمل مسبقًا، فلن تحتاج عادةً إلى تغييره للغات التي تتطلب تدقيقًا إملائيًا. راجع وثائق إعدادات Office الخاصة بـ Nextcloud .
أنشئ أو افتح مستندًا تجريبيًا واكتب كلمة بها خطأ إملائي متعمد في كل لغة من اللغات المتاحة. اضبط كل فقرة تجريبية على لغتها المقصودة، ثم تأكد من أن المدقق الإملائي يُشير إلى الخطأ المتعمد. اكتب أيضًا كلمة مكتوبة بشكل صحيح في كل لغة للتأكد من أنها لا تُعامل كنص أجنبي. كرر العملية مع مستخدم ثانٍ إذا كانت اللغات المتاحة تختلف باختلاف الحساب أو المستند.
إذا استمرت مشكلة اللغة، قلّص الاختبار إلى لغة واحدة في كل مرة، وتحقق من سجلات التعليمات البرمجية، وقارن التعليمات البرمجية بالوثائق لمعرفة إصدار الصورة الدقيق. قد تتغير قائمة اللغات المسموح بها ومحتويات الصور في قاموس Collabora الافتراضي بين الإصدارات؛ لذا لا ينبغي افتراض الإعدادات الافتراضية الموثقة في دليل الإصدار 25.04 لكل علامة لاحقة. بمجرد أن يعمل التدقيق الإملائي في كل فقرة مُعلّمة بشكل صريح، احتفظ بأصغر قائمة لغات تلبي احتياجات المستخدمين.
قم بتثبيت مخطط Collabora Helm الرسمي، وقم بتكوين الوصول إلى WOPI وتقارب الدخول، وتحقق من النشر دون أخطاء الإعداد الشائعة.
استخدم طلبات المتصفح وسجلات WOPI وفحوصات البروكسي المستهدفة لمعرفة سبب فتح Collabora لمستند فارغ - واختر حلاً يتناسب مع الأدلة.
قم بتكوين قواميس CODE Docker ووضع علامات على مقاطع المستندات بشكل صحيح حتى تتلقى اللغات الإنجليزية والفرنسية واللغات الأخرى المدعومة التدقيق الإملائي الصحيح.
قم بضبط عتبة عدم النشاط لكل عرض في coolwsd وميزها عن تعتيم علامات التبويب الخلفية، وإلغاء تحميل المستندات، والحفظ التلقائي، وانتهاء صلاحية تسجيل الدخول.
أوقف عمليات التحقق المجدولة لتحديثات التعليمات البرمجية، وراجع الخدمات البعيدة الاختيارية، واستخدم عناصر التحكم في الشبكة الصادرة دون تعطيل تحرير المستندات.
قم بتمكين تحرير المستندات بشكل آمن في Seafile عن طريق تكوين عنوان URL لاكتشاف Collabora و HTTPS والوصول إلى WOPI لنشرك.
اختبر حافظة النظام، واضبط أذونات المتصفح، وحدد متى يحتاج تكامل Collabora المضمن إلى تغيير سياسة iframe.
قم بتثبيت ملفات الخطوط في Docker ولوحة نظام Collabora بحيث تظهر الخطوط المخصصة في المحرر ويتم عرضها بشكل صحيح في المستندات.
قم بعمل نسخة احتياطية من ملف coolwsd.xml ومصادر النشر الخاصة به، واستعدها بأمان، وتحقق من الكود قبل أن يعود المستخدمون إلى التحرير.
قم بالسماح بمصدر Nextcloud المحدد أو مصدر WOPI آخر في CODE، ثم تحقق من قائمة السماح للمضيف النشط وقم بتمييزها عن تقييد عنوان IP المصدر الخاص بـ Nextcloud.