org.dspace:dspace-api-lang

DSpace API Language Packs to support multiple languages on backend.


Keywords
dspace, i18n, internationalization, language-packs
License
JasPer-2.0

Documentation

DSpace API Language Packs

This project is for language packs for the dspace-api in https://github.com/DSpace/DSpace.

  • main branch = 7.x Java API language packs (for backend only)
  • dspace-6_x branch = 6.x (and below) API & JSPUI language packs

Layout of the source tree

The Messages.properties files for each language are stored in the src/main/resources directory.

The file naming conventions are as follows:

Messages_<ISO 639-1>_<ISO 3166-1>.properties

  • ISO 639-1: language code, in lower case.
  • ISO 3166-1: codes for country, if required. For example:

For example:

  • `src/main/resources/``
    • Messages.properties - file for default (English)
    • Messages_el.properties - file for Greek
    • Messages_fr_FR.properties - file for French (France)
    • Messages_fr_CA.properties - file for French (Canada)

For languages that can be fully represented using the Latin-1 character set, the appropriate Messages.properties file is placed in the relevant directory:

src/main/resources/Messages_it.properties

For languages that require other encodings, they are stored in this tree in their native encoding for ease of editing, patching and so forth. The filename extension representing the encoding, for example:

src/main/resources/Messages_el.properties.UTF-8

The Maven build process supports native2ascii conversion on packaging of the UTF-8 files prior to packaging the jar.

Release tags

Language packs are versioned according to the main DSpace version, but also include an incrementing sequence-number which allows language packs to be updated more frequently than DSpace releases.

So, DSpace software releases are of the format: [major].[minor] (e.g. 4.0, 4.1, 5.0, 5.1, etc.)

Whereas, DSpace language packs use the format: [major].[minor].[sequence-number] (e.g. 5.0.0, 5.0.1, 5.0.2 for 5.0 releases of the language packs).

Language packs are automatically installed into DSpace via Maven dependencies. In the case of the API and JSPUI language packs, they are installed as a JAR (e.g. dspace-api-lang-[version].jar) dependency.

Other tools

checkkey.pl

This is a handy Perl tool for determining which message keys are present in one properties file versus another. This is useful for determining whether a translation is complete. If you run:

checkkeys.pl Messages.properties Messages_fr.properties

the tool will tell you which keys are missing from Messages_fr.properties, and which (if any) are in Messages_fr.properties but not in the core Messages.properties.

In a complete translation for a particular version, there should be no missing or extra keys.

Documentation

Additional documentation on language packs and I18N (internationalization) may be found at Internationalization Support

Documentation for each release may be viewed online or downloaded via our Documentation Wiki.

Contributing

DSpace is a community built and supported project. We do not have a centralized development or support team, but have a dedicated group of volunteers who help us improve the software, documentation, resources, etc.

We welcome contributions of any type. Here's a few basic guides that provide suggestions for contributing to DSpace:

We also encourage GitHub Pull Requests (PRs) at any time. Please see our Development with Git guide for more info.

In addition, a listing of all known contributors to DSpace software can be found online at: https://wiki.lyrasis.org/display/DSPACE/DSpaceContributors

Getting Help

DSpace provides public mailing lists where you can post questions or raise topics for discussion. We welcome everyone to participate in these lists:

Additional support options are listed at https://wiki.lyrasis.org/display/DSPACE/Support

DSpace also has an active service provider network. If you'd rather hire a service provider to install, upgrade, customize or host DSpace, then we recommend getting in touch with one of our Registered Service Providers.

Issue Tracker

Use GitHub Issues in this project.

License

DSpace source code is freely available under a standard BSD 3-Clause license. The full license is available at http://www.dspace.org/license/