Raised: $0
0% of monthly goal Help us cross the finish line!
Goal: $12,000
Raised: $0 Goal: $12,000
0% of monthly goal Help us cross the finish line!
Sponsor DDEV

add-on registry tests last commit release

ddev-locale

What is ddev-locale?

DDEV-locale is design to setup the DDEV web container for a specific locale. In additional, it serves as documentation for DDEV internationalization.

DDEV has 2 related locale settings:

This addon, by default, sets both of these to Japan (Japanese). Why Japan? Japan has a single timezone and a single encoding locale. It is also where my team is based.

Why ddev-locale?

DDEV allows encoding to be set globally (via web-environment). Timezone, however, is a per-project setting.

As of writing, DDEV includes all language files which significantly inflates the web server container size. If/when the language files are removed, this addon will be updated to install the language pack.

Getting started

  1. Install this addon.

     ddev add-on get tyler36/ddev-locale
     ddev restart
    

Configuration

To change either setting, you need to update .ddev/config.locale.yaml.

  1. Remove ## ddev-generated from the file. This will prevent DDEV from updating it.

Change timezone

  1. To change timezones, update the timezone line with the TZ identifier for your desired location. See List of tz database time zones

Change locale

  1. To update the language, update the web_environment line.

This contains up to 3 parts:

A 3rd code-set value (separated with .) is optional.

For example: LANG=en_AU.UTF-8

Components of the repository

Contributing

PRs are welcome, especially if they contain tests.

Contributed and maintained by @tyler36