Установка на RedHat, Fedora и CentOS¶

Требования к оборудованию¶

Weblate должен без проблем работать на любом современном оборудовании, ниже приведена минимальная конфигурация, необходимая для запуска Weblate на одном сервере (сам Weblate, база данных и веб-сервер):

3 ГБ ОЗУ
2-х ядерный процессор
1 ГБ дискового пространства

Примечание

Фактические требования к вашей установке Weblate сильно зависят от размера управляемых ею переводов.

Использование памяти¶

Чем больше памяти, тем лучше — она используется для кэширования на всех уровнях (на уровне файловой системы, уровне базы данных и уровне Weblate). Для сотен компонентов перевода рекомендуется не менее 4 ГБ оперативной памяти.

Подсказка

Для систем с меньшим, чем рекомендуется, объёмом памяти рекомендуется использовать Однопроцессная установка для производства Celery.

Использование CPU¶

Множество одновременно работающих пользователей увеличивают количество необходимых ядер процессора.

Использование хранилища¶

Типовое использование дискового пространства базой данной находится в районе 300MB на 1 миллион хранимых слов.

Пространство необходимое для клонирования репозиториев разнится, хотя Weblate и пытается поддерживать их размер минимальным, делая поверхностные (shallow) копии.

Узлы¶

Для небольших и средних сайтов (миллионы размещённых слов) все компоненты Weblate (см. Обзор архитектуры) могут работать на одном узле.

Когда вы вырастете до сотен миллионов размещённых слов, рекомендуется выделить отдельный узел для базы данных (см. Настройка базы данных для Weblate).

Установка¶

Системные требования¶

Установите зависимости, необходимые для сборки модулей Python (смотрите раздел Требования к программному обеспечению):

dnf install \
   libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel \
   libyaml-devel libffi-devel cairo-devel cairo-gobject-devel pango-devel \
   gobject-introspection-devel libacl-devel lz4-devel libzstd-devel xxhash-devel \
   libtool-ltdl-devel python3-devel git

Установите необходимые необязательные зависимости в зависимости от возможностей, которые вы собираетесь использовать (см. Зависимости Python):

dnf install openldap-devel cyrus-sasl-devel
dnf install xmlsec1-devel

При желании установите программное обеспечение для запуска рабочего сервера, смотрите разделы Запуск сервера, Настройка базы данных для Weblate и Фоновые задачи с использованием Celery. В зависимости от размера вашей установки вы можете захотеть запустить эти компоненты на выделенных серверах.

Инструкции по установке на местах:

# Web server option 1: NGINX and uWSGI
dnf install nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
dnf install httpd python3-mod_wsgi

# Caching backend: Valkey
dnf install valkey

# Database server: PostgreSQL
dnf install postgresql postgresql-contrib

# SMTP server
dnf install postfix

# Gettext for the msgmerge add-on
dnf install gettext

Менеджер пакетов uv¶

Подсказка

Мы используем менеджер пакетов uv для установки Weblate.

curl -LsSf https://astral.sh/uv/install.sh | sh

См. также

Установка uv

Модули Python¶

Подсказка

Мы устанавливаем Weblate в отдельное виртуальное окружение Python.

Создайте виртуальное окружение Python для Weblate:
```
uv venv ~/weblate-env
```
Активируйте виртуальное окружение Python для Weblate:
```
. ~/weblate-env/bin/activate
```
Установите Weblate, включая все его необязательные зависимости:
```
# Install Weblate with all optional dependencies
uv pip install "weblate[all]"
```
Пожалуйста, проверьте Зависимости Python для тонкой настройки необязательных зависимостей.

См. также

Настройка Weblate¶

Примечание

Далее предполагается, что виртуальное окружение Python, используемое Weblate, активировано (с помощью выполнения . ~/weblate-env/bin/activate). Если нет, укажите полный путь к команде weblate как ~/weblate-env/bin/weblate.

Скопируйте файл ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py в ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.
По своему усмотрению подкорректируйте значения в новом файле settings.py. Вам нужно будет предоставить как минимум учётные данные базы данных и секретный ключ Django, но для установки на рабочей системе вам понадобится больше изменений, смотрите больше в разделе Изменение конфигурации под свои нужды.
Создайте базу данных и её структуру для Weblate (для примера настройки используется PostgreSQL, ознакомьтесь с Настройка базы данных для Weblate, чтобы узнать информацию о готовой установке):
```
weblate migrate
```
См. также

migrate
Создайте учётную запись администратора admin, создайте её пароль и скопируйте его в буфер обмена; не забудьте сохранить его для дальнейшего использования:
```
weblate createadmin
```
Подсказка

Если вы ранее пропустили/потеряли пароль администратора, вы можете создать новый с помощью следующей команды:
```
weblate createadmin --update
```
См. также

createadmin
Соберите статические файлы для своего веб-сервера (см. разделы Запуск сервера и Обслуживание статических файлов):
```
weblate collectstatic
```
Сожмите файлы JavaScript и CSS (необязательно, смотрите раздел Сжатие клиентских ресурсов):
```
weblate compress
```
Запустите обработчики Celery. Для целей разработки это делать не обязательно, но настоятельно рекомендуется. Больше информации смотрите в разделе Фоновые задачи с использованием Celery:
```
celery --app=weblate.utils worker --beat --queues=celery,notify,memory,translate,backup
```
Запустите сервер разработки (в разделе Запуск сервера подробно описана настройка):
```
weblate runserver
```

После установки¶

Поздравляем, теперь ваш сервер Weblate запущен и вы можете начать его использовать.

Теперь вы можете получить доступ к Weblate по адресу http://localhost:8000/.
Войдите в систему с учётными данными администратора, полученными во время установки, или зарегистрируйтесь в качестве нового пользователя.
Теперь вы можете запускать команды Weblate с помощью команды weblate, когда виртуальное окружение Python Weblate активно, см. Команды управления.
Вы можете остановить тестовый сервер с помощью Ctrl+C.
Проверьте потенциальные проблемы с вашей установкой либо по URL-адресу /manage/performance/ (см. Отчёт о производительности), либо с помощью weblate check --deploy, см. Рабочая среда.

Добавление перевода¶

Откройте интерфейс администратора (http://localhost:8000/create/project/) и создайте проект, который вы хотите перевести. Подробнее смотрите в разделе Настройки проекта.

Всё, что вам нужно здесь указать — это название проекта и его веб-сайт.
Создайте компонент, который является реальным объектом для перевода — он указывает на репозиторий системы контроля версий и задаёт файлы для перевода. Подробнее смотрите в разделе Настройки компонента.

Здесь важны следующие поля: Название компонента, Репозиторий исходного кода и Маска файла для поиска файлов перевода. Weblate поддерживает широкий спектр форматов, включая GNU gettext PO (переносимый объект), Строковые ресурсы Android, Строки Apple iOS, Файлы свойств Java, Формат Stringsdict или Формат Fluent, см. Форматы файлов локализации, чтобы получить больше подробностей.
После того, как вышеперечисленные действия будут завершены (это может быть довольно длительный процесс в зависимости от размера вашего репозитория системы контроля версий и количества сообщений для перевода), вы сможете начать перевод.