Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Removed Section Translation work in Progress, as it was out of date and never got updated.

Table of Contents
outlinetrue
stylenone

Current Status of Internationalization

...

If you supply new translations, make sure, they correspond to a stable release of DSpace and do not contain English tags nor references to your DSpace instance (e.g. name of your Institution). In partially translated Messages_xx.properties, just omit the untranslated tags. Messages.properties will be used as a fallback anyway and untranslated tags are easiear detectable with tools like the Ecliplse Resource Bundle Editor if omitted.

Here is a list of new tags from DSpace 1.4.2 to DSpace 1.5 NewTags142To15.txt so you might easily update an existing translation.

Translation work in progress

If you are in the progress of translating or upgrading existing translations, please communicate your efforts here and in the dspace lists to avoid redundant work and get feedback on your translations. The more hands join in the tedious work of translation the better.

Language

Locale

Version

UI

contact

translation to review

Arabic

ar

1.4.1

jsp

 

Messages_ar.properties

Basque

eu

1.6.1

xml

Public University of Navarre

 

French

fr

1.5

xml

University of Montreal

 

Persian

fa_IR

1.5

jsp

 

 

Polish

pl

1.6

xml

University of Silesia

galuszkak( at )gmail.com

 

Italian

it

1.5

xml

valerio.minetti AT gmail.com

messages_it.xml

Serbian

sb_RS

1.6

xml, jsp

Bojan Suzij - National Library for the Blind

 

Spanish

es

1.5

jsp

gustavo perosillo

Available for review

Spanish

es

1.5.1

jsp

Guillermo Varela

Available for review

Thai

th

1.5.2

jsp

KIDS-D Project, Asian Institute of Technology

 

Thai

th

1.5.2

xml

KIDS-D Project, Asian Institute of Technology

 

Available translations of Messages.properties for JSP-UI

Language

Locale

initial

1.3.1

1.3.2

1.4

1.4.1

1.4.2

1.5

1.5.1

1.5.2

1.6.0

1.6.1

1.6.2

1.7.0

1.7.1

1.8.0

1.8.1

Basque

eu

 

 

 

 

 

 

 

 

X

 

 

 

 

 

 

 

Bulgarian

bg

 

 

 

 

 

 

 

 

 

X

 

X

X

 

X

X

Catalan

ca

 

x

x

 

X

 

 

ToDo

 

 

 

 

 

 

 

 

Chinese CN

zh_cn

X

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Chinese TW

zh_tw

X

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Czech

cs

X

 

 

 

 

 

X

ToDo

X

X

X

 

X

 

 

 

French

fr

X

 

X

 

X

 

 

ToDo

 

 

 

 

 

 

 

 

Galician

gl

X

 

 

 

 

X

 

ToDo

 

 

 

 

 

 

 

 

German

de

X

 

 

X

X

X

X

X

X

X

X

X

X

X

X

X

Greek

el

X

 

 

X

 

 

 

 

 

 

 

 

 

 

 

 

Hungarian

hu

X

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Indonesian

id

X

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Italian

it

X

 

X

X

 

 

 

 

X

 

 

 

 

 

 

 

Japanese

ja

X

 

X

X

 

 

 

X

 

 

 

 

X

 

 

 

Norwegian

no

X

 

X

 

 

X

 

ToDo

 

 

 

 

 

 

 

 

Polish

pl

X

 

X

X

 

 

 

 

 

 

 

 

 

 

 

 

Portuguese

pt

 

 

 

 

 

 

X

X

 

 

 

 

 

 

 

 

Portuguese PT

pt_PT

X

 

 

X

 

 

X

X

X

 

 

 

 

 

 

 

Portuguese BR

pt_BR

X

 

X

 

 

 

X

 

 

 

 

 

 

 

 

 

Russian

ru

X

 

X

X

 

 

 

 

 

 

 

 

 

 

 

 

Spanish

es

X

 

 

 

X

 

 

X

 

 

 

 

 

 

 

 

Swedish

sv

X

 

 

X

 

 

X

X

 

 

 

 

 

 

 

 

Thai

th

 

 

 

 

 

X

 

X

 

 

 

 

 

 

 

 

Ukrainian

uk

 

 

 

 

X

 

 

ToDo

 

x

 

 

 

 

 

 

Welsh

cy

 

 

 

 

X

X

X

X

 

 

 

 

 

 

 

 

...

Language

Locale

1.5

1.5.1

1.5.2

1.6.0

1.6.1

1.6.2

1.7.0

1.7.1

1.8.0

1.8.1

German

de

x

x

x

x

x

x

x

x

x

x

Greek

el

 

x

 

 

 

 

 

 

 

 

Catalan

ca

x

x

 

 

 

 

 

  

x

 

Catalan (Central)

ca_ES

 

 

x

 

 

 

 

 

 

 

Czech

cs

 

 

x

x

x

 

x

x

x

 

Italian

it

x

 

x

 

 

 

 

 

 

 

Japanese

ja

 

x

 

 

 

 

x

x

 

 

Portuguese

pt_BR

 

x

 

 

 

x

 

 

 

 

Spanish

es

x

x

 

 

 

 

x

x

 

 

Parts of localizations not yet managed at Sourceforge SVN

...

  • include the Standard Tag Library in the JSP - <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
  • define the key you want in config/Messages.properties
  • use the key instead of the text in the JSP, see examples below
    The messages may can now be changed in the appropriate config/Messages_xx.propertiesfile. This must be done at build-time, because it is placed in the dspace.war.

    Example: Basic key use

  • Old JSP

    Code Block
    <h1>Search Results</h1>
  • New JSP

    Code Block
    <h1><fmt:message key="jsp.search.results.title" /></h1>
  • Messages.properties

    Code Block
    jsp.search.results.title = Search Results

...

Phrases may have parameters to be passed in, to make the job of translating easier, reduce the number of 'keys' and to allow translators to make the translated text flow more appropriately for the target language.

  • Old JSP

    Code Block
    <p>Results <%= r.getFirst() %> to <%= r.getLast() %> of <%= r.getTotal() %></p>
  • New JSP

    Code Block
    <fmt:message key="jsp.search.results.text">
    <fmt:param><%= r.getFirst() %></fmt:param>
    <fmt:param><%= r.getLast() %></fmt:param>
    <fmt:param><%= r.getTotal() %></fmt:param>
    </fmt:message>
    
  • Messages.properties

    Code Block
    <p>jsp.search.results.text = Results \{0\}-\{1\} of \{2\}</p>

    (Note: JSTL 1.0 does not seem to allow JSP <%= %> expressions to be passed in as values of attribute in <fmt:param value=""/>)

To Do

  • In the servlet code:
    • In `AuthorizeAdminServlet`, some English is passed for direct display in the title through the attribute `edit_title`. E.g. "Item".
  • `config/dstat.map`
  • Support for easy customisation of UI without needing to fork language bundles.
  • Display dates, numbers etc. according to Locale. (JSTL has tags for this)
  • Searching in non-Western languages such as Chinese; Lucene cannot parse/separate words
  • Multi-lingual metadata. Submission forms do not include language info for metadata. (The "language" DC field relates to the language of the content, i.e. the bitstreams.)
    • HPCLab, University of Patras, has submitted a new patch addressing this issue, against 1.4.2 (including the I18N patch) here. Please test and verify in order to remove from to-do.
  • Author and title ordering.
  • Browse controls ("Jump to" 0-9, A-Z) – support for other characters
  • Use of Collator fixes non-English language sort order problems. Not developed but small. No schema changes. JimDowning
  • i18n of non-Web UI – e.g. command line tools like the import/export tools. Currently the dictionaries are only stored in the .war file, so other parts of code won't have access to them.

...