Skip to content

Latest commit

 

History

History
79 lines (50 loc) · 3.17 KB

i18n.mdwn

File metadata and controls

79 lines (50 loc) · 3.17 KB
Raw

[[!meta title="Internationalization and localization"]]

<iframe width="560" height="315" src="https://www.youtube.com/embed/n25THKbzSfg" frameborder="0" allowfullscreen></iframe>

We have excellent support for European languages and we will (re)address CJK requirements given the demand to do so.

Choose your locale at boot

  1. By using syslinux [[boot]] menu Languages
  2. Appending your locale by editing the syslinux boot menu, see [[testing]] for a guide

Once booted

  1. By using the customisation service, filling in a form and purchasing a subscription or adding to your control panel

i18n support falls into a couple of areas

  1. Setting up the browser UI using locale= and using a single ISO 639 code
  2. Keyboard options using the xkb= mapping to setxkbmap, for example xkb=-layout%20gb. Spaces are URL encoded.
  3. NOT SUPPORTED ATM: More complex CJK input methods

The first locale setting is also set in the Accept languages in the browser. https://github.com/Webconverger/webc/blob/master/etc/webc/live-config.sh#L194

xkb replaces keyboard-layouts= from Debian Live and now gives you direct and convienant access to setxkbmap.

https://github.com/Webconverger/webc/blob/master/home/webc/webc.sh#L71 is how Webconverger parses and runs the option to setxkbmap.

In [[debug_mode|boot]], this is how to setup a British keyboard and query its settings:

$ setxkbmap -layout gb
$ setxkbmap -query
rules:      evdev
model:      evdev
layout:     gb
options:    "grp:caps_toggle",grp:caps_toggle,ctrl:nocaps

To encode the argument string, simply launch a browser console and use the Javascript function encodeURI. Or you can just replace spaces with %20.

encodeURI("-layout gb")
"-layout%20gb"

Which becomes xkb=-layout%20gb in your Webconverger configuration.

Switching keyboard layouts

Try the default Arabic or Russian Language choices. Alt+Shift toggles between latin based characters and the native language keyboard mapping.

You can switch keyboard layouts using customised special key combinations. For example, in debug mode or in any Linux Xorg terminal:

setxkbmap -layout us,th -option grp:shift_toggle

Allows you to toggle between US and Thai keyboard layouts by pressing both left and right SHIFT keys together.

To configure Webconverger with this preference, you append:

xkb=-layout%20us,th%20-option%20grp:shift_toggle

Caveat: Do not quote your commands.

There are setxkbmap aliases which can be found in /usr/share/X11/xkb/rules

Fonts

Please see [[fonts]] for more information on the fonts we include.

Tested examples