Localizing Orbeon Forms
See these 2 files:
Each file has as series of
<resource>
elements each with an xml:lang
attribute. You need to add your own element. Say you want to localize to Italian:<resource xml:lang="it">
You can start by copying an existing
<resource>
element (for example French).Starting 2014-03-21, we are marking placeholder resources for existing languages with
todo="true"
.NOTE: You must not translate the
<value>
part of item definitions, for example:<required>
<label>Richiesto</label>
<hint>Se è necessario immettere i dati</hint>
<item>
<label>Sì</label>
<value>true</value>
</item>
<item>
<label>No</label>
<value>false</value>
</item>
</required>
For Form Builder, starting with Orbeon Forms 4.0, you also need to update the following property in your
properties-local.xml
:<property
as="xs:string"
name="oxf.fr.available-languages.orbeon.builder"
value="en fr it"/>
By default, Orbeon Forms 4.0 sets it to
en fr
. The updated property at least needs to include the new language or languages that you are adding, in this case, it
. For more details on this, see this Stack Overflow question.Similar idea here, but this is in JavaScript, for client-side calendar support.
Orbeon Forms XBL components are located as subdirectories here:;
- https://github.com/orbeon/orbeon-forms/tree/master/form-runner/jvm/src/main/resources/xbl/orbeon
Each subdirectory has a .xbl file with some metadata. For example:
As of Orbeon Forms 2016.1, the following controls need help:
In there, you will notice the localization in English, French, etc. Add your own language.
To get started search for the English version in all files for both:
lang="en"
xml:lang="en"
Then add the corresponding resources for the new language.
- https://github.com/orbeon/orbeon-forms/blob/master/form-builder/jvm/src/main/resources/forms/orbeon/builder/xbl
These files are used by the Form Builder toolbox for built-in XForms controls.
As of Orbeon Forms 2018.2, the following files need help:
- UNTIL Orbeon Forms 2018.1
- SINCE Orbeon Forms 2018.2
TODO: more files,
For formatting of dates and times, a Java class usually needs to be added. See the example for Norwegian:
You can go about this in various ways.
- 1.Localize the files
- 2.Send them to us
- 1.with a github pull request
- 2.by sending the files to us separately
- 3.
But you will want to see the results yourself first. Here you can either work with
- or a binary build
If working with the source, build Orbeon Forms, localize the files, and test as you go.
If working with a binary build, you can override built-in files by creating your own files under the WAR file's WEB-INF/resources directory:
WEB-INF/resources/apps/fr/i18n/resources.xml
WEB-INF/resources/forms/orbeon/builder/form/resources.xml
WEB-INF/resources/ops/javascript/orbeon/xforms/control/CalendarResources.js
WEB-INF/resources/xbl/orbeon/*/*.xbl
WEB-INF/resources/forms/orbeon/builder/xbl/*/*.xbl
Last modified 4mo ago