~openerp-community/openobject-doc/6.1

* Get your module in the next distribution/version of Open ERP (if accepted by the editor) so that you do not have to manage migrations, testing per version, ...

Open Forge

----------

Here is the process of publishing a module or patch:

1. Create a project on http://OpenForge.com

2. Upload your work on your Open Forge project

3. Create an entry on the module repository of Open ERP's website

The Open Forge has tools to help your team collaborate, like message forums, tasks tracker and mailing lists; tools to create and control access to Source Code Management repositories. It is the central repository of collaborative developments for Open ERP.

Translations

============

Open ERP is multilingual. You can add as many languages as you wish. Each user may work with the interface in his own language. Moreover, some resources (the text of reports, product names, etc.) may also be translated.

This section explains how to change the language of the program shown to individual users, and how to add new languages to Open ERP.

Nearly all the labels used in the interface are stored on the server. In the same way, the translations are also stored on the server. By default, the English dictionary is stored on the server, so if the users want to try Open ERP in a language other than English, then you have to store these languages definitions on the server.

However, it is not possible to store "everything" on the server. Indeed, the user gets some menus, buttons, etc... that must contain some text *even before* being connected to the server. These few words and sentences are translated using GETTEXT. The chosen language by default for these is the language of the computer from which the user connects.

The translation system of Open ERP is not limited to interface texts; it also works with reports and the "content" of some database fields. Obviously, not all the database fields need to be translated. The fields where the content is multilingual are marked thus by a flag :

.. figure:: images/field_flag.png

:scale: 120

:align: left

How to change the language of the user interface ?

--------------------------------------------------

The language is a user preference. To change the language of the current user, click on the menu: User > Preferences.

.. figure:: images/trans_user_pref.png

:scale: 120

:align: left

An administrator may also modify the preferences of a user (including the language of the interface) in the menu: Administration > Users > Users. He merely has to choose a user and toggle on "preferences".

.. figure:: images/menu_bar_pref.png

:scale: 120

:align: left

Store a translation file on the server

--------------------------------------

To import a file having translations, use this command:

./openerp_server.py --i18n-import=file.csv -l **LANG**

where **LANG** is the language of the translation data in the CSV file.

Note that the translation file must be encoded in **UTF8!**

Translate to a new language

---------------------------

**Please keep in mind to use the same translation string for identical sources** . Launchpad Online Translation may give helpful hints.

More information on accelerators on this website: http://translate.sourceforge.net/wiki/guide/translation/accelerators

To translate or modify the translation of a language already translated, you have to:

1. Export all the sentences to translate in a CSV file

+++++++++++++++++++++++++++++++++++++++++++++++++++++++

To export this file, use this command:

./openerp_server.py --i18n-export=file.csv -l**LANG**

where **LANG** is the language to which you want to translate the program.

2. Translate the last column of the file

++++++++++++++++++++++++++++++++++++++++

You can make a translation for a language, which has already been translated or for a new one. If you ask for a language already translated, the sentences already translated will be written in the last column.

For example, here are the first lines of a translation file (Dutch):

+--------+------------------------+---------+----------------+--------------------+

+--------+------------------------+---------+----------------+--------------------+

100

101

+--------+------------------------+---------+----------------+--------------------+

102

103

+--------+------------------------+---------+----------------+--------------------+

104

105

+--------+------------------------+---------+----------------+--------------------+

106

107

+--------+------------------------+---------+----------------+--------------------+

108

109

+--------+------------------------+---------+----------------+--------------------+

110

111

3. Import this file into Open ERP (as explained in the preceding section)

112

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

113

114

**Notes**

115

116

* You should perform all these tasks on an empty database, so as to avoid over-writing data.

117

118

To create a new database (named 'terp_test'), use these commands:

119

120

createdb terp_test --encoding=unicode

121

terp_server.py --database=terp_test --init=all

122

123

Alternatively, you could also delete your current database with these:

124

125

dropdb terp

126

createdb terp --encoding=unicode

127

terp_server.py --init=all

128

129

4. Using Launchpad / Rosetta to translate modules and applications

130

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

131

132

A good starting point is here https://launchpad.net/openobject

133

134

**Online**

135

136

Select the module translation section and enter your translation.

137

138

**Offline**

139

140

Use this, if you want to translate some 100 terms.

141

142

It seems mandatory to follow theses steps to successfully complete a translation cycle. (tested on Linux)

143

144

1. Download the <po file> from Launchpad

145

2. Get the message template file <pot file> from bzr branches

146

1. keep in mind that the <pot file> might not always contain all strings, the <pot files> are updated irregularly.

147

2. msgmerge <pot file> <po file> -o <new po file>

148

3. translate <new po file> using poedit, kbabel (KDE)

149

1. some programs (like kbabel) allow using dictionaries to create rough translations.

150

2. It is especially useful to create a complete dictionary from existing translations to reuse existing terms related to the application.

151

1. In OpenERP load most/all of the modules

152

2. Load your language

153

3. export all modules of your language as po file and use this one as dictionary. Depending on context of the module this creates 30-80% exact translations.

154

4. the <new po file> must not contain <fuzzy> comments inserted by kbabel for rough translation

155

1. grep -v fuzzy <new po file> > <po file>

156

5. check for correct spelling

157

1. msgfmt <po file> -o <mo file>

158

6. check your translation for correct context

159

1. import the <po file> (for modules)

160

2. install the <mo file> and restart the application (for applications)

161

7. adjust the translation Online in OpenERP

162

1. check context

163

2. check length of strings

164

3. export <po file>

165

8. upload <po file> to Launchpad

166

1. keep in mind that Launchpad / Rosetta uses some tags (not sure which) in the header section of the exported <po file> to recognize the imported <po file> as valid.

167

2. after some time (hours) you will receive a confirmation E-Mail (success / error)

168

169

Using context Dictionary for Translations

170

-----------------------------------------

171

172

The context dictionary is explained in details in section "The Objects - Methods - The context Dictionary". If an additional language is installed using the Administration menu, the context dictionary will contain an additional key : lang. For example, if you install the French language then select it for the current user, his or her context dictionary will contain the key lang to which will be associated the value *fr_FR*.

173

174

175

Older »