streamlit-gettext-Dokumentation
streamlit-gettext ist eine Erweiterung für Streamlit, mit der sich Anwendungen leichter lokalisieren lassen. Die Bibliothek berücksichtigt die Spracheinstellungen des Browsers und zeigt die passende Übersetzung an.
Die Bibliothek übersetzt Texte nicht selbst; die Übersetzungen müssen Sie selbst bereitstellen.
Bei aktiver automatischer Erkennung prüft streamlit-gettext bei jeder Übersetzung die Browsersprache des jeweiligen Nutzers. set_preferred_languages() legt die Sprache für die Sitzung fest; mit None oder einer leeren Liste wird die automatische Erkennung wieder aktiviert. So kann dieselbe Anwendung verschiedenen Nutzern in unterschiedlichen Sprachen angezeigt werden.
Das Projekt befindet sich noch in der Entwicklung. Die Dokumentation und die verfügbaren Funktionen können sich daher ändern.
Was kann die Bibliothek?
- Texte übersetzen. Markiere zu übersetzende Zeichenketten mit
gettext, das üblicherweise unter dem Kurznamen_importiert wird. - Einzahl und Mehrzahl behandeln. Mit
ngettextwird abhängig von der Anzahl die passende Nachrichtenform ausgewählt. - Sprache auswählen. Die Bibliothek kann die Spracheinstellungen des Browsers berücksichtigen.
Einfaches Beispiel
So verwendest du die Übersetzungsfunktionen in einer Streamlit-Anwendung:
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)
Der Aufruf _() kennzeichnet Text, der übersetzt werden soll. ngettext() wählt je nach Anzahl der Eichhörnchen die passende Nachrichtenform aus. Mit dem Schieberegler lässt sich die Anzahl ändern.
Dies ist nur ein Codebeispiel und keine vollständige Einrichtungsanleitung. Für eine lokalisierte Anwendung werden zusätzlich Übersetzungsdateien und eine Projektkonfiguration benötigt.
Sprache manuell wechseln
In dieser Variante wählt der Benutzer die Sprache selbst über ein Menü aus. Die Auswahl wird an set_preferred_languages() übergeben, damit die Anwendung die entsprechende Übersetzung verwendet:
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)
Anwendung ausprobieren
Probiere die Streamlit-Demoanwendung aus.
Der Quellcode befindet sich im Beispielverzeichnis.
API-Referenz
Eine Beschreibung der Funktionen und weiteren Schnittstellen findest du in der API-Referenz.