Help Center

Install Language Pack

 

DocCare online business document management software supports multipul interface languages. By default, DocCare installation package has English, Chinese (Simplified) and Chinese (Traditional) languages installed.
You are allowed to add further customized language packs to DocCare.

Install DocCare Language Pack

DocCare language pack is a jar file which has a name formatted as doccare-lan-<language>.jar. For example, English (US) language pack should be named as doccare-lan-en_US.jar, Chinese (Simplified) language pack should be named as doccare-lan-zh_CN.jar.
In the DocCare language pack, there is a language resource file named applicaiton_<language>.properties. The name translations of DocCare interface components are stored in this file. For example, English (US) language pack contains a resource file named application_en_US.properties. Chinese (Simplified) language pack contains a resource file named application_zh_CN.properties.
DocCare language packs are stored in ${BURGEONSOFT_HOME}/share/lib directory as well as ${BURGEONSOFT_HOME}/webapps/doccare/WEB-INF/lib directory by default.
You are allowed to modify the translation of DocCare interface components. To modify the translation, you can modify the resource file packaged in the doccare-lan-<language>.jar. You can use jar command to extract the resource file from doccare-lan-<language>.jar, edit the resource file, 编辑资源文件,then use lanpack tool to install the new language pack. Steps below:

Step 1, get the language resource file

You can use the following methods to get the DocCare language resource file template.

  • Download the language resource template file from Burgeonsoft web site.
  • Using jar command to extract ${BURGEONSOFT_HOME}/share/lib/doccare-lan-<language>.jar. Get a copy of the .properties file in the resources/language directory.
    For example, c:\>jar xvf doccare-lan-en_US.jar
    By running this command, you will extract the language resource file name applicaiton_en_US.properties to directory \resources\language.

You can rename the language resource file to applicaiton_<new_language>.properties. For exmaple, if you want to create a French language pack, you can rename the resource file to application_fr.properties.

Step 2, create new language resource file

DocCare language resource file is made up of a collection of key=value pairs. The key is the name of a language item used by DocCare and the value is the translation. You can edit the value or translate the value in a new language. See figure below:
English language resource fileChinese language resource file
Note:DO NOT change the key.

Step 3, package and install the resource file

After you editing the new language resource file, you can package and install it with lanpack tool. You can find it in ${BURGEONSOFT_HOME}/bin.
If you are using Windows OS, you can use the command below:
${BURGEON_HOME}\bin\lanpack.bat install -f c:\application_fr.properties -l fr -d Français
If you are using Linux/Unix OS, you can use the command below:
[burgeonsoft][~]$ bin/lanpack.sh install -f /var/tmp/application_fr.properties -l fr -d Français
By running the command, lanpack tool will do a native character conversion of application_fr.properties, package it in doccare-lan_fr.jar, and copy the jar file to both ${BURGEON_HOME}/share/lib and ${BURGEON_HOME}/webapps/doccare/WEB-INF/lib. Also, lanpack will modify ${BURGEON_HOME}/webapps/doccare/WEB-INF/conf/installed_languages.xml, add a new item for French language.

Uninstall DocCare Language Pack

To uninstall a language pack, you can use ${BURGEONSOFT_HOME}/bin/lanpack tool. For example, if you want to remove French language pack,
If you are using Windows OS, you can use the command below:
${BURGEON_HOME}\bin\lanpack.bat uninstall -l fr
If you are using Linux/Unix OS, you can use the command below:
[burgeonsoft][~]$ bin/lanpack.sh uninstall -l fr
By running the command, lanpack tool will remove doccare-lan_fr.jar from ${BURGEON_HOME}/share and ${BURGEON_HOME}/webapps/doccare/WEB-INF/lib. Also, lanpack will modify ${BURGEON_HOME}/webapps/doccare/WEB-INF/conf/installed_languages.xml, remove the France language item.