Localization: add first-launch language selection and persistent locale settings
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 30/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Ít trao đổi
- Lĩnh vực
- frontend, localization, testing
Hướng nghiên cứu
Start by locating the application's first-launch/bootstrap flow, the Settings screen, locale persistence code, and the existing test and visual-check entry points. Implement detection, explicit confirmation, English fallback, and changeable locale settings across the relevant UI and persistence paths, including migration for existing installs. Done means all acceptance criteria pass, including tests for first launch, persistence, invalid locales, fallback, migration, input, and representative layouts in all six languages.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Summary
Add a first-launch language selection flow and persist the player's chosen locale. The selected language must remain changeable from Settings.
The goal is to make HitTheKit understandable from the first screen and establish a reliable localization foundation for international players.
Initial languages
- English (
en) - Italiano (
it) - Deutsch (
de) - Español (
es) - Français (
fr) - Română (
ro)
Language names should be displayed in their native form. Do not use flags as language selectors.
First-launch experience
On the first launch:
- detect the operating-system locale when it matches a supported language;
- preselect that language, otherwise preselect English;
- show a clear language-selection screen before entering the main experience;
- require an explicit confirmation from the player;
- persist only the stable locale code;
- continue to the normal application flow.
On later launches, skip this screen and use the saved locale.
Existing installations without a saved locale should be treated as a first launch for this preference, without resetting unrelated settings or progress.
Settings behavior
Add a language selector under Settings → Language.
Changing the language should:
- update the visible interface immediately when technically safe;
- otherwise show a clear message that the change applies after reopening the current screen;
- preserve all unrelated settings and progress;
- remain effective after restarting the application.
The selector must be usable with mouse, keyboard, and the application's supported drum-navigation input.
Localization contract
- English is the explicit fallback locale.
- Missing translations must fall back to the English source string rather than displaying an empty label or localization key.
- UI components must not contain new player-facing hardcoded strings outside the localization system.
- Unknown or invalid saved locale codes must fail safely to English.
- Text rendering must support accents and Romanian diacritics correctly.
- Layouts must tolerate text expansion, with particular attention to German labels.
Acceptance criteria
- A clean installation opens the language-selection screen before the main menu.
- The supported system locale is preselected; unsupported locales preselect English.
- The user can choose and confirm any of the six initial locales.
- The confirmed locale is persisted and restored on the next launch.
- The language can be changed later from Settings.
- The interface never displays an empty string or raw localization key when a translation is missing.
- An invalid persisted locale falls back deterministically to English.
- Existing progress and settings are not reset by the migration.
- Selection and confirmation work with mouse and keyboard; drum-navigation behavior is covered where available.
- Automated tests cover first launch, system-locale preselection, persistence, relaunch, settings changes, migration, and fallback behavior.
- Representative screens are visually checked in all six languages at the supported desktop resolutions.
Translation quality boundary
This issue establishes the complete locale-selection and persistence behavior. It does not authorize unreviewed machine-generated translations to be treated as final copy.
Each language may be completed or proofread in follow-up contributions. Incomplete translations must remain visible through the English fallback until reviewed.
Out of scope
- automatic translation services;
- account or cloud synchronization;
- changing gameplay timing or scoring;
- redesigning unrelated screens;
- using country flags to represent languages.
- Ngôn ngữ chính
- C#
- Star
- 0
- Fork
- 0
- Merge trung bình
- 16 giờ 9 phút
- Pull request đã merge (30 ngày)
- 7
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của Codewriter90x/HitTheKit
-
hardware help wanted
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 88/100
Codewriter90x/HitTheKit#14 ·
-
documentation enhancement
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 72/100
Codewriter90x/HitTheKit#54 ·
-
Platforms: electronic-drum MIDI input on Windows (and Linux)Có thể đã có người làm Có pull request liên kết đang mở hoặc đã được merge. Đang mởenhancement hardware help wanted
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 40/100
Codewriter90x/HitTheKit#53 ·
-
enhancement hardware
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 58/100
Codewriter90x/HitTheKit#52 ·
-
enhancement help wanted
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100
Codewriter90x/HitTheKit#43 ·
Tất cả issue của Codewriter90x/HitTheKit
Issue tương tự
-
type:task ux
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
elsa-workflows/elsa-foundation#5253 ·
Maintainer thường phản hồi trong vòng 1 ngày