此部分介绍在 Blackboard Learn 中创建、编辑和部署语言包时的常见问题。
文档资源链接中断
更新或更改语言包后,用户无法通过 Learn 访问 Blackboard 帮助。系统会将用户定向到找不到网页这个帮助页面,并会显示以下消息:
抱歉,我们找不到您要查找的页面或文档。
这表示在更新语言包时文档的现有链接发生中断。
打开自定义语言包,验证 documentation.properties“语言环境包”中的链接是否指向相应的资料。
协作服务器问题
在负载平衡的环境中部署自定义语言包可能会导致协作服务器出现问题。此问题仅会影响使用自定义语言包的用户。创建自定义语言包时,也会在应用程序服务器的以下位置上创建新的 jar 文件:
blackboard/apps/collab-server/http/webapps/clientlib/yourlanguagepack-collab-locale.jar
但是,这个新的 jar 文件没有在协作服务器本身上创建,从而导致此问题。
对此问题有两个解决方案:
解决方案 1
- 登录到协作服务器。
- 浏览至此位置: blackboard/content/locale/YOURLANGUAGEPACK/collab/
- 运行以下脚本:
[root@grimlock collab]# cat BuildCollabLocaleJar.sh
#! /bin/bash
## This script requires JAVA_HOME environment variable to be set
## This script takes an optional parameter for 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
- 登录到应用程序服务器。
- 浏览至此位置: blackboard/apps/collab-server/http/webapps/client-lib/
- 从应用程序服务器复制新的 jar 文件(部署自定义语言包时创建的)。
- 登录到协作服务器。
- 将新的 jar 文件添加到协作服务器中的相同位置。
- 重启协作服务器。
页面显示问题
某些门户页面和“系统管理员”面板在显示内容时可能会遇到一些问题。可能会收到以下错误消息:
can't parse argument number module_title
该问题是升级后最常出现的。解决方案是应用升级附带的 bundle_diff.txt 文件中概述的修改。完成初始升级流程后,请确保将自定义语言包更新为当前版本。
打开并查看 bundle_diff.txt 文件,然后相应更新自定义语言包。
主题
正确存储主题对于在 Blackboard Learn 中成功使用这些主题至关重要。确定主题是否位于所有适当应用程序服务器上的正确文件夹中。
进行编辑后,必须将主题设为默认;“管理员面板”完成此操作。
编辑主题的 CSS 文件时务必小心。建议编辑 CSS 文件时使用具有验证功能的文本编辑器。