Community Documentation

Translating a site interface to different languages (Locale core module)

Last updated January 22, 2012. Created by ghankstef on November 7, 2002.
Edited by Kristen Pol, Fiable.biz, arianek, sylvain_a. Log in to edit this page.

When enabled, the Locale core module allows you to present your Drupal site in a language other than the default English. You can use it to set up a multilingual web site or to replace the elements of the interface text with text which has been customized for your site. Whenever the Locale module encounters text, it tries to translate it into the currently selected language. If a translation is not available, the string is remembered, so you can look up untranslated strings easily.

The Locale module provides two options for providing translations. The first is the integrated web interface, which you can used to search for untranslated strings and to specify their translations. An easier and less time-consuming method is to import existing translations for your language. These translations are available as GNU gettext Portable Object files (.po files for short). You can download translation files from the Drupal translations server.

If an existing translation does not meet your needs, the .po files are easily edited with special editing tools. The Locale module's import feature allows you to add strings from such files into your site's database. The export functionality enables you to share your translations with others, generating Portable Object files from your site strings.

Note: Enabling Locale module itself does not create or add any translations to the site. You need to import translations or create string translations by using Translate Interface option (Content Translation Module from Drupal core for Drupal 6 onwards)

For Drupal 6 and 7, the Localization update module is available to simplify the interface translation process.

Drupal 7

You can:

  • Administer languages http://example.com/admin/config/regional/language
  • Manage strings for localization http://example.com/admin/config/regional/translate
  • Specify how the desired languages are detected http://example.com/admin/config/regional/language/configure
    or Configuration → Regional and language → Detection and selection
  • Translate strings http://example.com/admin/config/regional/translate/translate
  • Import strings http://example.com/admin/config/regional/translate/import
  • Export strings http://example.com/admin/config/regional/translate/export

Drupal 6

You can:

  • Administer languages at Administer > Site configuration > Languages.
  • Manage strings for the localization: Administer > Site building > Translate interface.

Drupal 5

You can:

  • Administer localization at Administer > Localization.
  • Manage strings for the localization Administer > Localization > Manage strings.
  • Add a locale language Administer > Localization > Add language.

Page status

No known problems

Log in to edit this page

About this page

Drupal version
Drupal 5.x, Drupal 6.x, Drupal 7.x
Audience
Developers and coders, Site administrators
Keywords
i18n
Drupal’s online documentation is © 2000-2012 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
nobody click here