استكشاف أخطاء حزمة اللغة وإصلاحها

يوفر هذا القسم معلومات حول المشكلات الشائعة التي قد تحدث عند إنشاء حزم اللغات وتحريرها ونشرها في Blackboard Learn.

الارتباطات المقطوعة لموارد الوثائق

بعد تحديث "حزمة اللغة" أو تغييرها، يتعذر على المستخدمين الوصول إلى "مساعدة Blackboard" من Learn. وبدلًا من ذلك يتم نقلهم إلى الصفحة Page Not Found (تعذر العثور على الصفحة) الخاصة بالمساعدة ويشاهدوا الرسالة التالية:

عذرًا، ولكن تعذر العثور على الصفحة أو المستند الذي تبحث عنه.

ويشير ذلك إلى انقطاع الارتباطات الموجودة للوثائق عندما تم تحديث حزمة اللغة.

افتح حزمة اللغة المخصصة، وتأكد من إشارة الارتباطات الموجودة في حزم الإعدادات المحلية documentation.properties إلى المواد المناسبة.

مشكلات خادم التفاعل

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

blackboard/apps/collab-server/http/webapps/clientlib/yourlanguagepack-collab-locale.jar

وعلى الرغم من ذلك، لا يتم إنشاء ملف jar الجديد هذا على خادم التفاعل نفسه، مما يؤدي إلى مشكلة.

يوجد حلان لهذه المشكلة:

الحل رقم 1

1. قم بتسجيل الدخول إلى خادم التفاعل.
2. انتقل إلى هذا الموقع: blackboard/content/locale/YOURLANGUAGEPACK/collab/
3. قم بتشغيل البرنامج النصي التالي:

   [root@grimlock collab]# cat BuildCollabLocaleJar.sh
   
   #! /bin/bash
   
   ## يتطلب هذا البرنامج النصي تعيين متغير بيئة JAVA_HOME إلى
   
   ## يأخذ هذا البرنامج النصي معلمة إضافية لـ PATH_TO_COLLAB
   
   ############## BuildCollabLocaleJar.sh
   
   #############################
   
   #
   
   # CHANGE THIS VALUE IF YOU COPY THIS SCRIPT FOR A DIFFERENT
   
   LOCALE
   
   ################################################################
   
   ###
   
   LOCALE=en_US <-------EDIT HERE TO SPECIFY YOUR LANGUAGE PACK
   
   LOCALE
   
   PATH_TO_COLLAB=$1
   
   export LOCALE PATH_TO_COLLAB
   
   if [ "$PATH_TO_COLLAB" != "" ]; then cd $PATH_TO_COLLAB; fi
   
   if [ "$JAVA_HOME" = "" ]; then
   
   echo "JAVA_HOME variable not defined."
   
   exit 1
   
   fi
   
   echo "Using JAVA_HOME: $JAVA_HOME"
   
   echo "PATH_TO_COLLAB: $PATH_TO_COLLAB"
   
   JAR_CMD="$JAVA_HOME/bin/jar -cf"
   
   JAR_DEPLOY_DIR=../../../../apps/collabserver/
   
   http/webapps/client-lib/
   
   export JAR_CMD JAR_DEPLOY_DIR
   
   JAR_CMD="$JAR_CMD $LOCALE-collab-locale.jar images messages"
   
   echo "Building $LOCALE-collab-locale.jar"
   
   $JAR_CMD
   
   echo "Deploying $LOCALE-collab-locale.jar to $JAR_DEPLOY_DIR"
   
   cp $LOCALE-collab-locale.jar $JAR_DEPLOY_DIR
   
   rm $LOCALE-collab-locale.jar
   
   exit

الحل رقم 2

1. قم بتسجيل الدخول إلى خادم التطبيق.
2. انتقل إلى هذا الموقع: blackboard/apps/collab-server/http/webapps/client-lib/
3. انسخ ملف jar الجديد (الذي تم إنشاؤه نتيجة نشر حزمة اللغة المخصصة) من خادم التطبيق.
4. قم بتسجيل الدخول إلى خادم التفاعل.
5. أضف ملف jar الجديد لنفس الموقع في خادم التفاعل.
6. أعد تشغيل خادم التفاعل.

مشكلات عرض الصفحة

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

can't parse argument number module_title

غالبًا يتم مواجهة هذه المشكلة بعد الترقية. يكمن الحل في تطبيق التعديلات المحددة في ملف bundle_diff.txt الذي يصاحب الترقية. بعد اكتمال عملية الترقية الأولية، تأكد من تحديث حزمة اللغة المخصصة بالإصدار الحالي.

افتح الملف bundle_diff.txt، وقم بمراجعته وحّدث حزمة اللغة المخصصة وفقًا لذلك.

المزيد حول صيانة حزم اللغات.

الأشكال

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

يجب تعيين الأشكال كافتراضية بعد التحرير، ويتم ذلك من خلال "لوحة المسؤول".

ينبغي توخي الحذر عند تحرير ملف CSS لأحد الأشكال. يوصى باستخدام محرر نصوص يحتوي على إمكانية التحقق عند تحرير ملفات CSS.

المزيد حول الأشكال