This answer will demonstrate how to fully customize a locale, optionally using an existing locale as a base. The type of locale that will be used in this answer is the i18n
type; such type of locale will be implied in every mention of the word "locale" in the body of the answer.
Find a guide
The first thing you need to customize a locale, is get to know the format of the locale. This web locale editor has a comprehensive description of every field in a locale, despite not being usable by just anyone in a right-away manner. This will be the guide to use.
Needed tools
The only tools you need to work with locales are
- A text editor. Any will do, though VIM will excell.
- A text-to-unicode converter. It would be most expected that you didn't have one, so I will provide you with a simple one. Read the next subsection to obtain it.
I recommend you to create a directory and save everything related with the work you will do on the locale to it.
Text-to-unicode converter (encodestr)
NOTE: if you are using non-common characters you may have problems with the script I write below; you might want to take a look at the alternative scripts linked by nass.
Save the following code to a file. This file will be identified by your system as a python script, which is alright because it is one. This guide assumes you called the script encodestr
.
#!/usr/bin/env python3
import sys
def main():
if len(sys.argv) != 2:
exit(f'Usage: {sys.argv[0]} <string to encode>')
print(encode(sys.argv[1]))
def encode(s):
return ''.join(f"<U{ord(c):04X}>" for c in s)
if __name__ == '__main__':
sys.exit(main())
After you have saved it, give the file execution permission - this will come in handy. You can do that using nautilus, or by running from a terminal the following command, on the directory in which you saved the script: chmod +x encodestr
.
You can now test this script by running on the same directory: ./encodestr hello
. You should get an output equal to <U0068><U0065><U006C><U006C><U006F>
.
Modify an existing locale
Modifying an existing locale is the easiest case, as ideally you will pick a locale that fits your needs almost totally, in which case you need to make only small modifications. To tailor it, you can use the guide to know which of the sections are the ones you want to change, and how you can change them. All the installed locales reside in /usr/share/i18n/locales
, however the guide contains pretty much every locale ever created.
However, the first thing you will notice when you open a locale is that you will read english words as much as weird <UXXXX>
codes. You will need to be able to create these codes - this is where the encodestr
script comes.
When you know which sections you have to change, you need to know each field contained in the section.
For example, the LC_TIME
section contains the field t_fmt
, and many others. Each field has its own description on the guide.
Now that you know which fields to modify, use the guide again to find out what values does the field accept.
For example, the field t_fmt
accepts text and the common strfmt variables.
Just when you know what to write on the fields you want to modify, run the text through the encodestr
script to get its encoded equivalent.
NOTE: Not every field needs to be encoded, use an existing locale as a reference if needed.
For example, if you want to have the time format Time: %T
in the t_fmt
field, run ./encodestr "Time: %T"
; this will return <U0054><U0069><U006D><U0065><U003A><U0020><U0025><U0054>
and so you will have the line t_fmt <U0054><U0069><U006D><U0065><U003A><U0020><U0025><U0054>
in your locale (in it's respective section, of course).
After you have modified every field you wanted to, you will need to proceed to install the locale to the system, so it can be used. Proceed to the installation section for this.
Creating a locale from scratch
As opposed to modifying one, the other method you can use to create your custom locale is working on it from scratch. This is not very difficult if - again - you use the guide. Here's a useful tip though: you can copy sections from other locales without actual copy and paste methods. You just have to follow this format:
LC_SECTION
copy "locale"
END LC_SECTION
Where LC_SECTION
is the section you want to modify, and locale
is the locale you want to copy that section from.
For example, if you want to copy the time format in the English locale, you would have this text your custom locale file:
LC_TIME
copy "en_GB"
END LC_TIME
And that saves you a lot of work and assures that any change made to the referenced locale will be mirrored to yours.
Installing your custom locale
The steps I am going to show below may not be optimal, but work.
Compile your locale. Don't panic! This takes no time. Just run the command sudo localedef -i custom -f UTF-8 custom.UTF-8 -c -v
where custom
is the name of your locale.
Copy your locale to the /usr/share/i18n/locales/
directory. You will definitely need sudo priviledges to do this, and you can do it with the command sudo cp locale /usr/share/i18n/locales/
where locale
is the filename of your custom locale.
Specify your locale in /var/lib/locales/supported.d/
. For example, create a file name /var/lib/locales/supported.d/asd
and add the line custom UTF-8
, where custom is the name of your locale.
Run the magic command. I actually don't know what exactly this command does, but it is crucial. Run sudo locale-gen
. It is most probable it generates references to the available locales where needed.
Tell your system to use the locale. If you want the locale to be used on a system-wide manner, modify the /etc/environment
file. If not, you can modify your ~/.profile
file, or any other one that is sourced at startup. If you don't know what the latter means don't worry, just use the ~/.profile
file. To know what you have to write in it, first run the locale
command. It should issue a list with items like LANGUAGE
, LC_MESSAGES
, LC_CTYPE
and many others. You will write, for each of the sections you want (listed by the previous command), on separate lines, this SECTION="locale"
where SECTION
is the section and locale
the name of your custom locale.
For example, if you want to use the time format from the Netherlands, but the english language, write:
LANGUAGE="en_GB:en"
LC_TIME="nl_NL"
NOTE: If you want to use one locale for every locale setting, write LC_ALL="locale"
where locale
is the name of your custom locale. If you want to use a locale for everything but for the language, you can write LANG="locale"
and (on another line, of course) LANGUAGE="locale":XX
where XX
is the 2 letter code for the language you want.
For example, if you want to use the Dutch locale and the English language, you could use:
LANG="nl_NL"
LANGUAGE="nl_NL:en"
You have finished
The next time you log in, your locale should be in use. You can test this by running the locale
command again.
Please comment about inconsistencies or false statements in this guide!
Best Answer
The environment variables to override with the locale you wish to use are
LANG
,LC_ALL
, andLANGUAGE
. Some apps will handle some of these differently, but generally just settingLANG
should work. You can run a command in the terminal with it, likeLANG=es_ES locale
. Thelocale
command will show the current environment variable settings for your locale.