Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ and this project adheres to
### Added

- ♿️(frontend) restore skip to content link after header redesign #2510
- 🌐(i18n) rename cn_CN to zh_CN, add eo_PL and zh_TW locales #2486

## [v5.4.1] - 2026-07-09

Expand Down
3 changes: 2 additions & 1 deletion documentation/languages-configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,9 +118,9 @@ Before adding a new language, ensure that:
The following languages have translation files available in `src/backend/locale/`:

- `br_FR` - Breton (France)
- `cn_CN` - Chinese (China) - *Note: Use `zh-cn` in DJANGO_LANGUAGES*
- `de_DE` - German (Germany) - Use `de-de`
- `en_US` - English (United States) - Use `en-us`
- `eo_PL` - Esperanto - Use `eo-pl`

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Document that eo-pl is an administrative placeholder.

Because Esperanto has no associated country code, clarify here that eo-pl is a project locale identifier using Poland administratively—not a Poland-specific linguistic variant.

Suggested clarification
 - `eo_PL` - Esperanto - Use `eo-pl`
+  (`eo-pl` uses `PL` as an administrative placeholder; it is not a regional Esperanto variant.)
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@documentation/languages-configuration.md` at line 123, Update the eo_PL entry
in the language configuration documentation to state that eo-pl is an
administrative project locale identifier using Poland’s code because Esperanto
has no associated country code, not a Poland-specific linguistic variant.

- `es_ES` - Spanish (Spain) - Use `es-es`
- `fr_FR` - French (France) - Use `fr-fr`
- `it_IT` - Italian (Italy) - Use `it-it`
Expand All @@ -132,6 +132,7 @@ The following languages have translation files available in `src/backend/locale/
- `tr_TR` - Turkish (Turkey) - Use `tr-tr`
- `uk_UA` - Ukrainian (Ukraine) - Use `uk-ua`
- `zh_CN` - Chinese (China) - Use `zh-cn`
- `zh_TW` - Traditional Chinese (Taiwan) - Use `zh-tw`

**Note:** When configuring `DJANGO_LANGUAGES`, use lowercase with hyphens (e.g., `pt-pt`, `ru-ru`) rather than the directory name format.

Expand Down
Loading
Loading