Skip to content

FLUENT_I18N_GUIDE.md

Latest commit

 

History

History
66 lines (45 loc) · 1.46 KB

FLUENT_I18N_GUIDE.md

File metadata and controls

66 lines (45 loc) · 1.46 KB

EmojiClu Internationalization (i18n) Guide

This document explains how internationalization (i18n) is implemented in EmojiClu using the fluent-i18n crate.

Overview

EmojiClu now supports multiple languages using Mozilla's Fluent localization system. The setup includes:

  • English (en) - Default/fallback language
  • Spanish (es) - Complete translation
  • French (fr) - Complete translation

Directory Structure

locales/
├── en/
│   └── main.ftl
├── es/
│   └── main.ftl
└── fr/
    └── main.ftl

How It Works

1. Initialization

The i18n system is initialized in src/lib.rs:

fluent_i18n::i18n!("locales", fallback = "en");

The locale is automatically detected from the system settings at runtime in src/main.rs. You can override it by setting the LOCALE environment variable:

LOCALE=fr ./emojiclu  # Force French
LOCALE=es ./emojiclu  # Force Spanish

The system automatically handles locale variations (e.g., fr_FR, fr_BE → fr, es_ES, es_MX → es).

2. Usage in Code

Replace hardcoded strings with the t! macro:

use fluent_i18n::t;

// Before
Button::with_label("Submit")

// After
Button::with_label(&t!("submit"))

3. Translation Keys

All translation keys are defined in .ftl files. For example, in locales/en/main.ftl:

submit = Submit
menu-new-game = New Game
app-title = EmojiClu