Przejdź do treści

Strona może być nieaktualna

Nikt jej nie zmieniał od 21 miesięcy (ostatni commit: 2025-01-22, kamil_szulc). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.

Tłumaczenia i wersje językowe

Ustawienia

Miejsce z którego pobieramy tłumaczenia ogólne definiowane jest zmienną envoirnment, która możemy podać przy budowaniu/wystawianiu frontendu. W przypadku environment ustawionego jako development użyjemy lokalnych tłumaczeń, które są zawarte w projekcie apollo-frontend w folderze translations. Ember automatycznie przerzuci je do folderu dist przy budowaniu/wystawianiu serwera i z tamtad będzie je sobie pobierał.

W przypadku pozostałych środowisk (test, production) będziemy pobierać tłumaczenia z zewnętrznego źródla (cloudflare r2).

url dla test: https://translations-test.logintegra.eu/pl.json

url dla production: https://translations.logintegra.eu/pl.json

dostępne języki pl/cs/de/en/es/it/tr

Lokalizacja tłumaczeń specyficznych dla pryncypała sterowana jest parametrem TRANSLATIONS_URL (Parameter#TRANSLATIONS_URL)`

Tłumaczenia ogólne

Tłumaczenia ogólne są wspólne dla wszystkich klientów i muszą zawierać wszystkie klucze występujące w aplikacji. Pobierane są na stronie logowania.

Tłumaczenia specyficzne dla pryncypała

Po zalogowaniu, do mapy użytkowika dodajemy tłumaczenia specyficzne dla danego pryncypała. Mapa ta jest keszowana w USERS_ACCOUNT_SETTINGS_CACHE. Możemy w nich zdefiniować dowolną ilość kluczy, w przypadku zgodności nazw kluczy z tłumaczeniami ogólnymi, tłumaczenia specyficzne nadpiszą tłumaczenia ogólne. Np.: Pryncypał logintegra posiada specyficzne tłumaczenie dla klucza common.plan:

teamcity@logintegra-dev:~$ cat translations/logintegra/pl.json 
{
    "common": {
        "plan": "Trololo"
    }
}

Dlatego zamiast Zaplanuj: Default label Ma zmieniony label: Changed label

Dodawanie nowych tłumaczeń

Tłumaczenia dostępne są w repozytorium na bitbucket: Rozdzielone są na 2 brancze: - test — dla tłumaczeń testowych (https://translations-test.logintegra.eu) - prod — dla tłumaczeń produkcyjnych (https://translations.logintegra.eu)

Po dodaniu tłumaczenia należy wykonać skrypt znajdujący się na serwerze logintegra-dev (151.115.54.238):

teamcity@logintegra-dev:~/translations$ ./update-translations.sh 
Podaj parametr test lub prod
np.: ./update-translations.sh test
teamcity@logintegra-dev:~/translations$ ./update-translations.sh test
Already on 'test'
Your branch is up to date with 'origin/test'.
Already up to date.
{
    "ETag": "\"86ec4ea2850d94534d160ef32017afde\"",
    "VersionId": "7e6b723231eb791f251d08fbec5c3f45"
}
{
    "ETag": "\"68f72869a28a50fa0a1690bc834dbd33\"",
    "VersionId": "7e6b72322eddcec0f4290f3dd8ab00cf"
}
{
    "ETag": "\"8c207f1120924e8b23668da63aa20fcb\"",
    "VersionId": "7e6b72322beb39ccb7b8c2f78257b420"
}
{
    "ETag": "\"32caca3fe8a55fcbbb496a0aa6d56fc1\"",
    "VersionId": "7e6b7232284c2d1213150d4e9f0b2910"
}
{
    "ETag": "\"64f075cc2226d69b485f52562eaa5d92\"",
    "VersionId": "7e6b723225c461233241c06c360ac918"
}
{
    "ETag": "\"0eed89500e99df4a51b1a76a7e4954f9\"",
    "VersionId": "7e6b723222f3c72f561125291d4c2d18"
}
{
    "ETag": "\"3e778662ea488f9cdc330e80d9366f48\"",
    "VersionId": "7e6b72321f708481185bce4505e1c367"
}

Docelowo skrypt będzie wykonywał się automatycznie po zmergowaniu zmian do odpowiednich branczy.

Konfiguracja bucketów:

Buckety skonfigurowane są w r2 na cloudflare. Należy po zalogowaniu przenieść się do przestrzeni konta Kacpra:

Cloudflare account

Następnie przejść do zakładki R2 Object Storage:

Cloudflare account

Ostatnia zmiana: 2025-01-22 · kamil_szulc
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e