Dokumentacja streamlit-gettext
streamlit-gettext to rozszerzenie do Streamlit, które ułatwia dodawanie tłumaczeń do aplikacji. Biblioteka uwzględnia preferencje językowe przeglądarki i wyświetla użytkownikowi odpowiednie tłumaczenie.
Biblioteka sama nie tłumaczy tekstu; przygotowanie tłumaczeń należy do Ciebie.
Gdy automatyczne wykrywanie jest włączone, streamlit-gettext sprawdza język przeglądarki bieżącego użytkownika przy każdym tłumaczeniu. Wywołanie set_preferred_languages() ustawia język dla danej sesji; przekazanie None lub pustej listy przywraca automatyczne wykrywanie. Dzięki temu ta sama aplikacja może wyświetlać różne języki różnym osobom.
Projekt jest nadal rozwijany, dlatego dokumentacja i dostępne funkcje mogą się zmieniać.
Co potrafi biblioteka?
- Tłumaczy tekst. Oznaczaj ciągi do tłumaczenia za pomocą
gettext, zwykle importowanej pod krótką nazwą_. - Obsługuje liczbę mnogą. Funkcja
ngettextwybiera odpowiednią formę komunikatu w zależności od liczby, na przykład „1 obiekt”, „2 obiekty” lub „5 obiektów”. - Wybiera język. Biblioteka może uwzględniać preferencje językowe przeglądarki.
Prosty przykład
Oto jak użyć funkcji tłumaczących w aplikacji Streamlit:
import streamlit as st
from i18n import gettext as _
from i18n import ngettext
st.write(_("Squirrel application"))
squirrels = st.slider(_("How many squirrels to show?"), 1, 100, 1)
st.write(
ngettext(
"There's %(num)d squirrel:",
"There're %(num)d squirrels:",
squirrels,
)
% {"num": squirrels},
)
st.write("🐿️" * squirrels)
Wywołanie _() oznacza tekst do przetłumaczenia. ngettext() dobiera formę komunikatu do liczby wiewiórek, a suwak pozwala zmieniać ich liczbę.
To tylko przykład kodu, a nie pełna instrukcja konfiguracji. Do uruchomienia zlokalizowanej aplikacji potrzebne są również pliki tłumaczeń i konfiguracja projektu.
Ręczna zmiana języka
W tej wersji użytkownik sam wybiera język z menu. Wybrany język jest przekazywany do set_preferred_languages(), dzięki czemu aplikacja wyświetla odpowiednie tłumaczenie:
import streamlit as st
from i18n import get_available_languages, ngettext, set_preferred_languages
from i18n import gettext as _
language = st.segmented_control(
"Language",
options=get_available_languages(),
label_visibility="collapsed",
required=True,
)
if language:
set_preferred_languages([language])
st.write(_("Squirrel application"))
squirrels = st.slider(_("How many squirrels to show?"), 1, 100, 1)
st.write(
ngettext(
"There's %(num)d squirrel:",
"There're %(num)d squirrels:",
squirrels,
)
% {"num": squirrels},
)
st.write("🐿️" * squirrels)
Wypróbuj aplikację
Zobacz, jak to działa, w demonstracyjnej aplikacji Streamlit.
Kod źródłowy znajdziesz w katalogu z przykładem.
Dokumentacja API
Opis funkcji i pozostałych interfejsów biblioteki znajdziesz w dokumentacji API.