Документація streamlit-gettext
streamlit-gettext допомагає додавати переклади до застосунків на Streamlit. Бібліотека враховує мовні налаштування браузера й показує користувачеві відповідний переклад.
Бібліотека сама не перекладає текст — переклади потрібно підготувати самостійно.
За автоматичного визначення streamlit-gettext перевіряє мову браузера поточного користувача під час кожного перекладу. Виклик set_preferred_languages() задає мову для сесії; передавання None або порожнього списку повертає автоматичне визначення. Тому той самий запущений застосунок може показувати різні мови різним користувачам.
Проєкт ще розвивається, тому документація та можливості бібліотеки можуть змінюватися.
Що вміє бібліотека
- Перекладати текст: Позначайте рядки для перекладу за допомогою
gettext— зазвичай її імпортують під коротким ім’ям_. - Враховувати кількість об’єктів: Функція
ngettextвибирає потрібну форму повідомлення: наприклад, «1 об’єкт», «2 об’єкти» або «5 об’єктів». - Вибирати мову: Бібліотека може враховувати мовні налаштування браузера.
Простий приклад
Ось як підключити функції перекладу в застосунку 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)
Виклик _() позначає текст, який потрібно перекласти. ngettext() добирає форму повідомлення відповідно до кількості об’єктів, а повзунок дає змогу змінювати їхню кількість.
Це лише приклад коду, а не покрокова інструкція з налаштування. Щоб запустити локалізований застосунок, знадобляться також файли перекладів і конфігурація проєкту.
Перемикання мови вручну
У цьому варіанті користувач сам вибирає мову в меню. Вибір передається до set_preferred_languages(), і застосунок показує переклад цією мовою:
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)
Спробувати застосунок
Перевірте, як це працює, у демонстраційному застосунку на Streamlit.
Вихідний код доступний у каталозі з прикладом.
Довідник API
Опис функцій та інших інтерфейсів бібліотеки наведено в довіднику API.