### Navigation

- index
- modules |
- next |
- previous |
- Dev's documentation »
- SoL modules »

# `sol.i18n` – Internationalization utilities

`sol.i18n.``DOMAIN` = 'sol-server'

  The translation domain of the server side

`sol.i18n.``gettext`(s, **kw)

  Immediately translate the given string with current request locale

  Parameters: | s – either a string or a TranslationString instance just_subst – by default False, True to disable the actual translation and perform only mapping substitution

`sol.i18n.``ngettext`(s, p, n, **kw)

  Immediately translate the singular or plural form with current request locale

  Parameters: | s – either a string or a TranslationString instance with the singular form p – either a string or a TranslationString instance with the plural form n – an integer

`sol.i18n.``setAcceptedLanguagesLocale`(event, _available_languages=[])

  Recognize the user preferred language.

  Parameters: | event – a Pyramid event _available_languages – the list of available languages (this is used as a cache, computed at the first call to this function)

  This function is automatically executed at each new request, and sets the `_LOCALE_` attribute of the request itself.

`sol.i18n.``translatable_string`(msgid, mapping=None, default=None)

  A function to make a translatable string.

`sol.i18n.``translator`(request)

  Return a function that translates a given string in the specified request

  Parameters: | request – either None or a Pyramid request instance

  This is an helper function that handle the case when the request does not exist, for example while testing:

      >>> t = translator(None)
      >>> t('$first $last', mapping=dict(first='Foo', last='Bar'))
      'Foo Bar'

### Navigation

- index
- modules |
- next |
- previous |
- Dev's documentation »
- SoL modules »