feat: readme update

Added additional Docusaurus i18n command.

Put all localization commands within code blocks.

Removed autogen Docusaurus readme.
This commit is contained in:
Chris Milne 2026-05-01 13:04:01 +01:00
parent 4d5d3dcaf2
commit 7ac5129cee
2 changed files with 15 additions and 46 deletions

View file

@ -18,19 +18,29 @@ Key files for localization are:
### Locale commands
To update translation key values:
npm run write-translations -- --locale <locale>
`npm run write-translations -- --locale <locale>`
By default, write-translate only appends new values. To also update existing values:
- Note this will overwrite **all** JSON stored translations to English.
`docusaurus write-translations --locale <locale> --overrride`
To updated po4a consolidated .pot and .po files from English markdown files (with po4a tool installed):
po4a po4a.conf --no-translations
`po4a po4a.conf --no-translations`
To update localization markdown files from po4a consolidated .po files (with po4a tool installed):
po4a po4a.conf --no-update
`po4a po4a.conf --no-update`
To run the site in a specific locale:
npm run start -- --locale <locale>
`npm run start -- --locale <locale>`
To build the static site for all locales:
npm run build
`npm run build`
### Localization mapping