3996bdac33
* website: Bump prettier from 3.3.3 to 3.4.1 in /website Bumps [prettier](https://github.com/prettier/prettier) from 3.3.3 to 3.4.1. - [Release notes](https://github.com/prettier/prettier/releases) - [Changelog](https://github.com/prettier/prettier/blob/main/CHANGELOG.md) - [Commits](https://github.com/prettier/prettier/compare/3.3.3...3.4.1) --- updated-dependencies: - dependency-name: prettier dependency-type: direct:development update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> * update formatting Signed-off-by: Jens Langhammer <jens@goauthentik.io> * sigh Signed-off-by: Jens Langhammer <jens@goauthentik.io> * disable flaky test Signed-off-by: Jens Langhammer <jens@goauthentik.io> --------- Signed-off-by: dependabot[bot] <support@github.com> Signed-off-by: Jens Langhammer <jens@goauthentik.io> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Jens Langhammer <jens@goauthentik.io>
45 lines
1.3 KiB
Markdown
45 lines
1.3 KiB
Markdown
---
|
|
title: Translations
|
|
---
|
|
|
|
Translation in authentik is done in two places. Most of the text is defined in the frontend in `web/`, and a subset of messages is defined in the backend.
|
|
|
|
The frontend uses [@lit/localize](https://lit.dev/docs/localization/overview/), and the backend uses the built-in django translation tools.
|
|
|
|
:::info
|
|
Please review the [Writing documentation](./docs/writing-documentation) guidelines as they apply to documentation too.
|
|
:::
|
|
|
|
## Online translation
|
|
|
|
To simplify translation you can use https://www.transifex.com/authentik/authentik, which has no local requirements.
|
|
|
|
## Local translation
|
|
|
|
### Prerequisites
|
|
|
|
- Node (any recent version should work, we use 16.x to build)
|
|
- Make (again, any recent version should work)
|
|
- Docker
|
|
|
|
Run `npm i` in the `/web` folder to install all dependencies.
|
|
|
|
Ensure the language code is in the `lit-localize.json` file in `web/`:
|
|
|
|
```json
|
|
// [...]
|
|
"targetLocales": [
|
|
"en",
|
|
"pseudo-LOCALE",
|
|
"a-new-locale"
|
|
// [...]
|
|
],
|
|
// [...]
|
|
```
|
|
|
|
Afterwards, run `make web-i18n-extract` to generate a base .xlf file.
|
|
|
|
The .xlf files can be edited by any text editor, or using a tool such as [POEdit](https://poedit.net/).
|
|
|
|
To see the change, run `make web-watch` in the root directory of the repository.
|