Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,42 @@
|
||||
# Translation files
|
||||
|
||||
The web app loads translations per locale from this directory. Each `*.json`
|
||||
under `<locale>/` corresponds to one i18next namespace.
|
||||
|
||||
## Layout
|
||||
|
||||
```
|
||||
apps/web/public/locales/
|
||||
├── de/
|
||||
│ ├── translations.json # Legacy single-file namespace (4000+ keys)
|
||||
│ ├── errors.json # HTTP/auth/app error copy
|
||||
│ ├── mail.json # Subjects + bodies for transactional emails
|
||||
│ ├── common.json # Buttons / generic UI / ICU plurals (#72)
|
||||
│ ├── settings.json # Per-area: settings surfaces (#72)
|
||||
│ ├── billing.json # Per-area: billing surfaces (#72)
|
||||
│ ├── crm.json # Per-area: CRM surfaces (#72)
|
||||
│ ├── auth.json # Per-area: authentication surfaces (#72)
|
||||
│ └── emailMarketing.json # Per-area: email marketing surfaces (#72)
|
||||
└── en/ (same files)
|
||||
```
|
||||
|
||||
## Conventions
|
||||
|
||||
- **Default namespace:** `translations` (legacy). Existing callsites continue
|
||||
to work unchanged.
|
||||
- **Per-area namespaces:** use the existing namespace that matches the surface:
|
||||
`common`, `settings`, `billing`, `crm`, `auth`, or `emailMarketing`. Use the
|
||||
registered name exactly; `emailMarketing` is camelCase.
|
||||
- **Brand-new namespaces:** create matching `de/` and `en/` JSON files and
|
||||
register the namespace in `packages/i18n/src/index.ts#i18nNamespaces`.
|
||||
- **Key naming:** dotted scope.action — `locale.title`, `action.save`.
|
||||
- **ICU plurals:** wrap the count expression as
|
||||
`{count, plural, one {# item} other {# items}}`. The custom
|
||||
`useTranslate()` hook detects the ICU shape and routes it through
|
||||
`intl-messageformat`; the legacy i18next `_one`/`_other` suffix style stays
|
||||
supported for back-compat.
|
||||
- **Parity gate:** every namespace must have identical keys across `de/` and
|
||||
`en/`. Enforced by `packages/i18n/src/index.test.ts` and
|
||||
`scripts/i18n-check.ts`.
|
||||
|
||||
See `docs/contributing/i18n.md` for the long-form guide.
|
||||
Reference in new issue
Block a user