SUNScholar/Language

Back to Customisation

Introduction

The language, or international localisation, requires that several parts of the system be configured. Below are details of the individual parts.

For international language standards, see the following:

• ISO 639.2
• UTF-8

For other metadata standards used see:

http://wiki.lib.sun.ac.za/index.php/SUNScholar/Metadata

Default Language

The default language for all services are defined in the "build.properties" and/or "dspace.cfg" files.

https://github.com/DSpace/DSpace/blob/master/build.properties#L50
https://github.com/DSpace/DSpace/blob/master/dspace/config/dspace.cfg#L49
https://github.com/DSpace/DSpace/blob/master/dspace/config/dspace.cfg#L1402

Web UI Locale

Look for the following in the dspace.cfg file and configure accordingly.

webui.supported.locales = en
default.locale = en_ZA

See example below. For each "webui.supported.locales" a language file must exist, see language files customisation below for the XMLUI.

### i18n -  Locales / Language ####
# Default Locale
# A Locale in the form country or country_language or country_language_variant
# if no default locale is defined the server default locale will be used.
default.locale = en_ZA

# All the Locales, that are supported by this instance of DSpace
# A comma-separated list of Locales. All types of Locales country, country_language, country_language_variant
# Note that the appropriate file are present, especially that all the Messages_x.properties are there
# may be used, e. g: webui.supported.locales = en, de
webui.supported.locales = en, de, fr, uk, es, bg, ca, el, et, gl, it, ja, pl, ru, tr

Language files customisation

Click here to modify the language files used by the XMLUI interface.

References

• https://wiki.duraspace.org/display/DSDOC5x/Localization+L10n
• https://wiki.duraspace.org/display/DSDOC4x/Localization+L10n
• https://wiki.duraspace.org/display/DSDOC4x/Localization+L10n#LocalizationL10n-Enablingadditionallocales
• https://wiki.duraspace.org/display/DSDOC3x/Application+Layer#ApplicationLayer-internationalization
• https://wiki.duraspace.org/display/DSDOC3x/XMLUI+Configuration+and+Customization#XMLUIConfigurationandCustomization-MultilingualSupport
• https://wiki.duraspace.org/display/DSDOC18/XMLUI+Configuration+and+Customization#XMLUIConfigurationandCustomization-MultilingualSupport
• http://cocoon.apache.org/2.1/userdocs/i18nTransformer.html
• https://wiki.duraspace.org/pages/viewpage.action?pageId=19006024
• https://wiki.duraspace.org/display/DSPACE/i18n+Improvements+Proposal
• https://github.com/DSpace/DSpace/blob/master/dspace-api/src/main/java/org/dspace/core/I18nUtil.java
• https://github.com/DSpace/DSpace/blob/master/dspace-xmlui/src/main/webapp/i18n/messages.xml