# 💬 Language
Chevereto uses gettext for its translations and the system comes with a lot of languages built-in which you can find in the
# Add new languages
If you want to add a brand new language we encourage you to apply to translation (opens new window), where you can easily contribute a new language. OneSky features a complete suite for translations with no additional software required.
Translations contributed will get added to the software.
.po files at
app/languages folder. The language code must be expressed in ISO format.
Considering using a .po editor software (opens new window) to create the translation file.
# Customizing language strings
All language strings can be customized to fit what you want to show to your visitors. That way, you don't need to touch the theme at all.
The system works by overriding the target translation. For example, replacing
Upload and share your images. to "Upload, do it now!" by doing the following procedure:
# 1. Get the translation string (
- Go to the
- Open the file
en.po(in this example we are overriding English language)
- Find this text:
Upload and share your images.
- Copy the
msgstrlines, you should get something like this:
msgid "Upload and share your images." msgstr ""
msgstr is empty because English is the base language. If you open any other language you will see that value actually translated.
# 2. Override translation string
- Go to the
- Create the file
en.powith these contents:
msgid "Upload and share your images." msgstr "Upload, do it now!"
You only need to replace
msgstr because that is the translation string.
The result is that the system now will display
Upload, do it now! instead of the default
Upload and share your images. and it will only affect that language.
Note: You don't actually need a gettext editor for language overrides, but make sure to use double-quotes. If you need to put a double quote inside
\" (escaped double-quote).
# Cache languages
Chevereto V4 requires to cache translations, to do this you need to run the langs command.
app/bin/legacy -C langs