diff --git a/src/content/docs/en/usage/l10n.mdx b/src/content/docs/en/usage/l10n.mdx index bc80dc96..a452bf7e 100644 --- a/src/content/docs/en/usage/l10n.mdx +++ b/src/content/docs/en/usage/l10n.mdx @@ -9,13 +9,13 @@ Localization (l10n) and internationalization (i18n) support in Ultramarine Linux half of the project team speaks something other than English natively. This page contains details on how i18n works and how it can be set up on Ultramarine. -# Fonts +## Fonts Ultramarine should come with fonts for most if not all languages by default. Fonts for CJKV, Thai, Indic languages are installed out of the box. If you find any glyphs supported by Unicode not rendered correctly, [file a bug report]. -## Font Priorities +### Font Priorities Chinese users might experience issues where Japanese fonts are preferred over Chinese ones simply because the locale code `ja_JP` is before `zh_*` when sorted alphabetically. To solve this issue, @@ -44,12 +44,12 @@ edit `~/.config/fontconfig/fonts.conf` (or `/etc/fonts/local.conf` for global ch ``` -# Inputting in another language +## Inputting in another language You may change your key maps / keyboard layout in the settings applet. Refer to documentations for your chosen Desktop Environment (DE) or Window Manager (WM) for more details. -## IMFs, IMEs and IMs +### IMFs, IMEs and IMs Special tools are required to type in CJKV (Chinese, Japanese, Korean and Vietnamese) and other specific languages. @@ -75,7 +75,7 @@ support for the Jyutping IM and Cangjie IM, while libhangul IME provides support In most typical cases, only 1 IMF is installed in a system. However, multilingual users may choose to install multiple IMEs so that they can type in multiple languages. -## Fcitx5 vs IBus +### Fcitx5 vs IBus **IBus** (Intelligent Input Bus) is an IMF usually used in GTK-based desktop environments. If you are using GNOME/Budgie, you most likely will choose IBus over Fcitx5 due to GNOME Desktop's tight @@ -93,7 +93,7 @@ and you can also install IBus on a KDE system. Things come down to personal pref IBus will not work inside Window Managers. -## Setting up Fcitx5 on KDE +### Setting up Fcitx5 on KDE 1. Install your chosen IMEs (see the table below) alongside `kcm-fcitx5` and `fcitx5-configtool`. @@ -112,7 +112,7 @@ and you can also install IBus on a KDE system. Things come down to personal pref 3. Head to _Settings > Regional Settings > Input Method_, then start configuring Fcitx 5. -## Setting up Fcitx5 on other DEs/WMs +### Setting up Fcitx5 on other DEs/WMs 1. Install your chosen IMEs (see the table below) alongside `fcitx5-configtool`, `fcitx5-autostart`. - Install `fcitx5-qt` and `fcitx5-gtk` for Qt/GTK support. @@ -128,7 +128,7 @@ and you can also install IBus on a KDE system. Things come down to personal pref 3. When Fcitx 5 is running, right click on the new "en" icon on the system tray > Settings. 4. Start configuring Fcitx5. -## Setting up IBus +### Setting up IBus 1. Install your chosen IMEs (see the table below). 2. On GNOME, Budgie/Flagship and similar DEs, go into Settings > Keyboard. @@ -141,7 +141,7 @@ and you can also install IBus on a KDE system. Things come down to personal pref QT_IM_MODULE=ibus ``` -## List of IMEs and IMs +### List of IMEs and IMs Credits to Arch Wiki contributors for a [complete list of IMs]. The table is filtered and amended such that it better represents Ultramarine's support on different IMs: @@ -216,7 +216,7 @@ such that it better represents Ultramarine's support on different IMs: 4. See [#Compose Key](#compose-key). There is also LaTeX support in `fcitx5-m17n`. 5. See below for more IMs supported by `fcitx5-table-extra`. -### List of IMs supported by `fcitx5-table-extra` +#### List of IMs supported by `fcitx5-table-extra` - boshiamy - cangjie-large @@ -242,7 +242,7 @@ such that it better represents Ultramarine's support on different IMs: - zhengma-pinyin - zhengma -### List of packages for `ibus-table*` +#### List of packages for `ibus-table*` - `ibus-table-code`: Ibus-Tables for Latex, CNS11643 & Emoticons - `ibus-table-cyrillic`: Ibus-Tables for Cyrillic @@ -268,7 +268,7 @@ such that it better represents Ultramarine's support on different IMs: - `ibus-table-chinese-wubi-jidian`: Jidian Wubi 86 input method, JiShuang 6.0 - `ibus-table-chinese-yong`: YongMa input method -### Rime +#### Rime [Rime](https://rime.im/) is an input method engine / IME for typing Chinese. It supports a wide range of IMs and is highly customizable. @@ -283,12 +283,12 @@ you are using Fcitx5: rime_frontend=fcitx-rime bash rime-install rime-aca/rime-cangjie6 ``` -## Compose Key +### Compose Key See [Compose Key on Wikipedia](https://en.wikipedia.org/wiki/Compose_key) and [on ArchWiki](https://wiki.archlinux.org/title/Compose_key). -# Translations +## Translations Users that speak less popular languages might face issues where their system shows text in English even though the language settings are configured properly. Do not report this issue to us. This is @@ -296,7 +296,7 @@ due to lack of translation efforts from upstream (either the DE/WM or the app in help by visiting the translation platform provided by upstream and be a translator. Your contributions would improve the entire Linux ecosystem experience for minorities. -## Ultramarine Components +### Ultramarine Components If projects / software provided by Ultramarine (such as the Readymade installer) are untranslated in your language, or you would like to improve the translations, please visit