Skip to content

Commit

Permalink
Merge pull request #64 from Ultramarine-Linux/fix/l10n-heading
Browse files Browse the repository at this point in the history
fix(en/usage/l10n): make heading smaller (for better table of contents)
  • Loading branch information
madonuko authored Aug 11, 2024
2 parents 6f908ab + 0f60ba2 commit 783e073
Showing 1 changed file with 15 additions and 15 deletions.
30 changes: 15 additions & 15 deletions src/content/docs/en/usage/l10n.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down Expand Up @@ -44,12 +44,12 @@ edit `~/.config/fontconfig/fonts.conf` (or `/etc/fonts/local.conf` for global ch
</fontconfig>
```

# 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.
Expand All @@ -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
Expand All @@ -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.
</Alert>

## 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`.

Expand All @@ -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.
Expand All @@ -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.
Expand All @@ -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:
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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.
Expand All @@ -283,20 +283,20 @@ 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
due to lack of translation efforts from upstream (either the DE/WM or the app in concern). You may
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
Expand Down

0 comments on commit 783e073

Please sign in to comment.