Tłumaczenia — mówienie każdym językiem

System internacjonalizacji (I18N) Pytigon opiera się na sprawdzonym frameworku tłumaczeń Django, dodając automatyczne wykrywanie tłumaczeń, lokalizację pozycji menu oraz obsługę tłumaczeń po stronie JavaScript.

Jak to działa

Pytigon integruje się z opartym na gettext systemem tłumaczeń Django:

  1. Oznacz ciągi do przetłumaczenia w kodzie Python za pomocą _() lub pgettext()
  2. Oznacz ciągi do przetłumaczenia w szablonach za pomocą {% translate %} lub _("tekst")
  3. Wygeneruj pliki .po poleceniem make_i18n
  4. Przetłumacz pliki .po przy użyciu dowolnego edytora PO
  5. Skompiluj do .mo — Django wczytuje je w czasie działania

Tłumaczenia w kodzie Python

from django.utils.translation import gettext as _

class Album(models.Model):
    name = models.CharField(_("Name"), max_length=128)
    artist = models.CharField(_("Artist"), max_length=128)

    class Meta:
        verbose_name = _("Album")
        verbose_name_plural = _("Albums")

Tłumaczenia w szablonach

W szablonach .ihtml:

[translate "Welcome to Pytigon"]
[blocktranslate with name=user.username]
    Hello, {{ name }}!

Automatyczne wykrywanie

Pytigon automatycznie przeszukuje ciągi do przetłumaczenia w:

  • Nazwach wyświetlanych (verbose names) i opisach pól modeli
  • Etykietach pozycji menu
  • Etykietach pól formularzy (FastForm generuje przetłumaczalne etykiety automatycznie)
  • Konfiguracjach widoków
  • Plikach szablonów

Generowanie plików tłumaczeń

python manage.py make_i18n

To polecenie: 1. Przeszukuje wszystkie pliki Python pod kątem wywołań _() 2. Przeszukuje wszystkie szablony .ihtml pod kątem tagów {% translate %} 3. Generuje pliki .po w locale/[lang]/LC_MESSAGES/ 4. Aktualizuje istniejące pliki .po o nowe ciągi (zachowując istniejące tłumaczenia)

Tłumaczenia w JavaScript

Pytigon zapewnia obsługę tłumaczeń po stronie klienta przez bibliotekę frontendową:

// JavaScript
ptig.i18n.gettext("Save");
ptig.i18n.pgettext("Button label", "Save");

Katalog tłumaczeń JavaScript jest serwowany automatycznie i buforowany w przeglądarce.

Lokalizacja menu

Pozycje menu zdefiniowane w narzędziach developerskich są lokalizowane automatycznie. Pole „Name” jest konwertowane na klucz tłumaczenia poprzez zamianę na małe litery i zastąpienie spacji podkreślnikami. Pliki tłumaczeń zawierają wpisy takie jak:

msgid "user_management"
msgstr "Benutzerverwaltung"

Wykrywanie języka

Pytigon wykrywa język użytkownika z:

  1. Prefiksu URL (/en/, /de/, /pl/)
  2. Nagłówka Accept-Language przeglądarki użytkownika
  3. Ustawienia profilu użytkownika (jeśli jest zalogowany)
  4. Języka domyślnego z settings_app.py

Skonfiguruj dostępne języki w ustawieniach:

LANGUAGES = [
    ('en', 'English'),
    ('pl', 'Polski'),
    ('de', 'Deutsch'),
]
?: Translations ?: Translations