Note

The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.

Difference between revisions of "Funtoo Linux Localization"

From Funtoo
Jump to navigation Jump to search
 
(→‎Set Default Language: Complete overhaul)
Line 42: Line 42:
== Set Default Language ==
== Set Default Language ==


Suppose you are able to read your languages and you want to go further to set the default Languages for your apps, such as xfce4.
Now that you are able to read your language specific characters, you can go even further and set up the default language for your applications.
 
<tt>/etc/locale.gen</tt> and <tt>/etc/env.d/02locale</tt> are used to support your local language. The following are examples for French Canadian. You can look in '''/usr/share/i18n/SUPPORTED''' for the default list of supported combinations or look in '''/usr/share/i18n/locales''' to determine values to use.


On Funtoo, there are two configuration files responsible for your language settings: <code>/etc/locale.gen</code> and <code>/etc/env.d/02locale</code>.
The following steps will guide you through the process of setting up the default system language, using French Canadian as an example.
First you will need to edit <code>/etc/locale.gen</code>:
<console>
<console>
# ##i##nano -w /etc/locale.gen
# ##i##nano -w /etc/locale.gen
</console>
</console>
 
Specify your preferred locale with the accompanying character format (you will mostly want UTF-8):
Copy this value to your file (French Canadian)
{{fancynote|It is recommended to keep the preconfigured en_US.UTF-8 locale as a fallback.}}
 
{{file|name=/etc/locale.gen|body=
<pre>
en_US.UTF-8 UTF-8
fr_CA.UTF-8 UTF-8
fr_CA.UTF-8 UTF-8
</pre>
}}
To determine an appropriate locale for your system, you should take a look into <code>/usr/share/i18n/SUPPORTED</code> for the default list of supported combinations or check the <code>/usr/share/i18n/locales/</code> directory for a list of valid values.
{{fancywarning|You are strongly advised to use ''at least one'' UTF-8 locale since some applications may require it.}}


To set the default language globally:
Now, those locales need to be generated:
<console>
# ##i##locale-gen
##g##*##!g## Generating 2 locales (this might take a while) with 1 jobs
*  (1/2) Generating en_US.UTF-8 ... [ ok ]
*  (2/2) Generating fr_CA.UTF-8 ... [ ok ]
##g##*##!g## Generation complete
</console>


Once done, you can apply your locale settings system-wide. First display all available options:
<console>
<console>
# ##i##nano -w /etc/env.d/02locale  
$ ##i##eselect locale list
##g##Available targets for the LANG variable:
  ##b##[1]##!b##  C
  ##b##[2]##!b##  POSIX
  ##b##[3]##!b##  fr_CA.utf8
  ##b##[4]##!b##  en_US.utf8 ##bl##*
  ##b##[ ]##!b##  (free form)
</console>
The blue star indicates the current default system locale. You can now change it according your wishes:
<console>
# ##i##eselect locale set 3
Setting LANG to fr_CA.utf8 ...
Run ". /etc/profile" to update the variable in your shell.
</console>
Alternatively, you can set the default locale manually:
{{file|name=/etc/env.d/02locale|body=LANG="fr_CA.utf8"}}
You can verify your actions using:
<console>
$ ##i##eselect locale show
##g##LANG variable in profile:
  ##b##fr_CA.utf8
</console>
</console>


Copy this to your file (French Canadian)
For an immediate effect it is required to reload the environment:
 
<pre>
LANG="fr_CA.UTF-8"
LANGUAGE="fr_CA.UTF-8"
</pre>
 
After editing the files, generate a localized environment:
 
<console>
<console>
# ##i##locale-gen && env-update && source /etc/profile
# ##i##env-update && source /etc/profile
>>> Regenerating /etc/ld.so.cache...
</console>
</console>
 
Congratulations! You have successfully set up your default language on Funtoo.
You can also set the default language per user by set the LANG and LANGUAGE environment variable in <tt>~/.profile</tt>, and then logout and login.


== Keymap ==
== Keymap ==

Revision as of 21:55, September 13, 2014

Read Your Language

A newly installed Funtoo Linux does not able to read all the languages. You want to read the stuff, say, in Mozilla Firefox. You need to install fonts - A good sign that you have not installed the proper fonts is that the following characters appear as boxes with numbers inside: 日本語フォント

Check if you have your language installed (Chinese) by using the fc-list command from the media-libs/fontconfig ebuild:

root # fc-list :lang=zh

A easier way to get the correct font installed is copy this to /etc/portage/make.conf (Simplified Chinese)

root # LANGUAGE="en_US zh_CN"

After editing the file, run emerge:

root # emerge -avuDN world

If you are lucky, the right font will be installed, and your apps will also be able to use Chinese as the default language. But in case you not have the right font installed in this way, you need to install them manually.

For Japanese:

root # emerge media-fonts/kochi-substitute

For Chinese:

root # emerge media-fonts/arphicfonts

For Korean:

root # emerge media-fonts/baekmuk-fonts

Set Default Language

Now that you are able to read your language specific characters, you can go even further and set up the default language for your applications.

On Funtoo, there are two configuration files responsible for your language settings: /etc/locale.gen and /etc/env.d/02locale. The following steps will guide you through the process of setting up the default system language, using French Canadian as an example. First you will need to edit /etc/locale.gen:

root # nano -w /etc/locale.gen

Specify your preferred locale with the accompanying character format (you will mostly want UTF-8):

   Note

It is recommended to keep the preconfigured en_US.UTF-8 locale as a fallback.

   /etc/locale.gen
en_US.UTF-8 UTF-8
fr_CA.UTF-8 UTF-8

To determine an appropriate locale for your system, you should take a look into /usr/share/i18n/SUPPORTED for the default list of supported combinations or check the /usr/share/i18n/locales/ directory for a list of valid values.

   Warning

You are strongly advised to use at least one UTF-8 locale since some applications may require it.

Now, those locales need to be generated:

root # locale-gen
 * Generating 2 locales (this might take a while) with 1 jobs
 *  (1/2) Generating en_US.UTF-8 ... [ ok ]
 *  (2/2) Generating fr_CA.UTF-8 ... [ ok ]
 * Generation complete

Once done, you can apply your locale settings system-wide. First display all available options:

user $ eselect locale list
root ##g##Available targets for the LANG variable:
  [1]   C
  [2]   POSIX
  [3]   fr_CA.utf8
  [4]   en_US.utf8 *
  [ ]   (free form)

The blue star indicates the current default system locale. You can now change it according your wishes:

root # eselect locale set 3
Setting LANG to fr_CA.utf8 ...
Run ". /etc/profile" to update the variable in your shell.

Alternatively, you can set the default locale manually:

   /etc/env.d/02locale
LANG="fr_CA.utf8"

You can verify your actions using:

user $ eselect locale show
root ##g##LANG variable in profile:
  fr_CA.utf8

For an immediate effect it is required to reload the environment:

root # env-update && source /etc/profile
>>> Regenerating /etc/ld.so.cache...

Congratulations! You have successfully set up your default language on Funtoo.

Keymap

Funtoo Linux defaults to a US English keyboard. If you are using another type of keyboard, edit /etc/conf.d/keymaps and set keymap to your keyboard model. For example, cf for French Canadian keyboard, fr for French Azerty.

root # nano -w /etc/conf.d/keymaps

Input Method

ibus is an Intelligent Input Bus for Linux.

root # emerge -av ibus

You also need to install language table for ibus (Chinese)

root # emerge -av ibus-table-chinese