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
-
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.
- Remove
## ddev-generated from the file. This will prevent DDEV from updating it.
Change timezone
- To change timezones, update the
timezone line with the TZ identifier for your desired location. See List of tz database time zones
Change locale
- 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
- English language.
- Australian territory.
UTF-8 code-set.
Components of the repository
config.locale.yaml: the settings that are merging with the project’s configuration.- An install.yaml file that describes how to install the service or other component.
- A test suite in test.bats that makes sure the service continues to work as expected.
- Github actions setup so that the tests run automatically when you push to the repository.
Contributing
PRs are welcome, especially if they contain tests.
Contributed and maintained by @tyler36