-
Notifications
You must be signed in to change notification settings - Fork 1.7k
Labels
documentationDocumentation related issue/PRDocumentation related issue/PRtranslationsAny issues or pr's related to translationsAny issues or pr's related to translations
Description
@JimMadge Editing here...
I've been playing around with i8n and Crowdin and think I have handle on it now.
Some facts,
- Crowdin manages
- sources (for us, the website source in English)
- a string database (strings written in a range of languages) and translation memory (historical translations which can be applied again in the future)
- Crowdin can produce translations. For us that means source files in different language, which we can download according to a pattern
- For this reason, having each locale in a different directory is easiest to manage,
We can push sources from/src/content/docs/enonly
and pull translations to/src/content/docs/<lang>without any conflicts
- For this reason, having each locale in a different directory is easiest to manage,
- Starlight wants each language at
/src/content/docs/<lang>/ - Each language must be entered in
astro.config.mjs
When everything is working, the process will be
- On merge to main
- Push updated sources to Crowdin
(Because Crowdin has the string database, translations should be kept even if strings move within or between files)
- Push updated sources to Crowdin
- In testing and on deploy
- Pull translations (for languages we want to publish) from Crowdin
- Build
There are a lot of changes so I want to break them up,
- Move english site to
/en, remove redirect that removes lang codes - Add Crowdin configuration
Add npm script to pull translations and configuration to build with translations (but in comments) - Workflow to sync sources when merged to main
- Update tests to build with translations
Update Netlify build to include translations - Add location-based redirects
Reactions are currently unavailable
Sub-issues
Metadata
Metadata
Assignees
Labels
documentationDocumentation related issue/PRDocumentation related issue/PRtranslationsAny issues or pr's related to translationsAny issues or pr's related to translations