Tapestry

h1. Internationalization

Tapestry uses the standard "Rails Internationalization (I18N) API":http://guides.rubyonrails.org/i18n.html.

Not every page has been converted yet to use the I18N API. Patches are welcome. Translations to new languages are also welcome!

h2. Setting the default locale for an installation

In the config/config.yml file, make sure to add the locale lines to the default section (or the section for your environment). For example, to add Dutch and make it the default locale:

<pre>

  available_locales: [:en, :de, :nl]

  default_locale: :nl

</pre>

h2. Viewing a page in a different locale

You can pass the 'locale' URL query parameter to force a specific locale. Please note that the locale must be listed in the available_locales configuration variable.

h2. Adding/editing translations

The locale files live under

<pre>

  config/locales/defaults

  config/locales/views

</pre>

View-specific locales should be defined under views. Please follow the established naming pattern for files and directories.

h2. Using translations in a view

Where possible, we use "Lazy loading":http://guides.rubyonrails.org/i18n.html#overview-of-the-i18n-api-features (see section 4.1.4). 

For example, in 

<pre>

  app/views/users/index.html.erb

</pre>

we write

<pre>

  <h2><%= t('.participant_profiles') %></h2>

</pre>

which maps to a yml file 

  config/locales/views/users/en.yml

with this structure

<pre>

en:

  users:

    index:

      participant_profiles: "Participant Profiles"

</pre>

We could also write the lookup explicitly, like so:

<pre>

  <h2><%= t('users.index.participant_profiles') %></h2

</pre>