Встановлення у SUSE та openSUSE

Вимоги щодо обладнання

Weblate має працювати на будь-якому сучасному обладнанні без проблем. Нижче наведено мінімальні налаштування, які потрібні для запуску Weblate на одному вузлі (Weblate, бази даних і вебсервера):

  • 2 ГБ оперативної пам’яті

  • 2 ядра процесора

  • 1 ГБ вільного місця на диску

Чим більше пам’яті — тим краще. Пам’ять використовується для кешування на усіх рівнях (у файловій системі, базі даних та Weblate).

Збільшення кількості одночасних користувачів системи збільшує кількість потрібних для роботи ядер центрального процесора. Для сотень складників перекладу рекомендовано використовувати принаймні 4 ГБ оперативної пам’яті.

Типовий об’єм сховища даних близько 300 МБ на 1 мільйон збережених слів. Об’єм даних, потрібний для зберігання клонованих сховищ коду, може бути різним, але Weblate намагається його скоротити створенням поверхневих клонів.

Примітка

Реальні вимоги до встановленого вами Weblate значно залежать від розміру перекладів, які ним керуються.

Встановлення

Вимоги до системи

Встановіть залежності, потрібні для збирання модулів Python (див. Вимоги для програмного забезпечення):

zypper install \
   libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel libyaml-devel \
   cairo-devel typelib-1_0-Pango-1_0 gobject-introspection-devel libacl-devel \
   python3-pip python3-virtualenv python3-devel git

Встановіть бажані додаткові залежності, залежно від можливостей, якими ви бажаєте користуватися (див. Необов’язкові залежності):

zypper install tesseract-ocr tesseract-devel leptonica-devel

Додатково встановіть програмне забезпечення для роботи промислового сервера, див. Запуск сервера, Налаштування бази даних для Weblate, Фонові завдання з використанням Celery. Залежно від розміру встановлених складників, вам може знадобитися запуск цих складників на окремих серверах.

Настанови із локального встановлення:

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

# Web server option 2: Apache with ``mod_wsgi``
zypper install apache2 apache2-mod_wsgi

# Caching backend: Redis
zypper install redis-server

# Database server: PostgreSQL
zypper install postgresql postgresql-contrib

# SMTP server
zypper install postfix

Модулі Python

Підказка

Ми використовуємо virtualenv для встановлення Weblate в окремому середовищі з вашої системи. Якщо ви не призвичаєні до такого встановлення, ознайомтеся із User Guide до virtualenv.

  1. Створіть virtualenv для Weblate:

    virtualenv --python=python3 ~/weblate-env
    
  2. Активуйте virtualenv для Weblate:

    . ~/weblate-env/bin/activate
    
  3. Встановіть Weblate разом із усіма залежностями:

    pip install Weblate
    
  4. Встановіть драйвер бази даних:

    pip install psycopg2-binary
    
  5. Встановіть бажані додаткові залежності, залежно від можливостей, якими ви бажаєте користуватися (деяких з них можуть потребувати додаткових системних бібліотек, див. Необов’язкові залежності):

    pip install ruamel.yaml aeidon boto3 zeep chardet tesserocr
    

Налаштовування Weblate

Примітка

У наступних кроках ми припускаємо, що віртуальне середовище, яке використовується Weblate, є активним (активувати його можна за допомогою . ~/weblate-env/bin/activate). Якщо середовище не активовано, вам доведеться вказати повний шлях до команди weblate як ~/weblate-env/bin/weblate.

  1. Скопіюйте файл ~/weblate-env/lib/python3.7/site-packages/weblate/settings_example.py до ~/weblate-env/lib/python3.7/site-packages/weblate/settings.py.

  2. Скоригуйте значення у новому файлі settings.py відповідно до ваших уподобань. Ви можете скористатися типовим прикладом для тестування, але вам варто внести зміни для вашої промислової конфігурації, див. Коригування налаштувань.

  3. Створіть базу даних і її структуру для Weblate (у прикладі вказано параметри для PostgreSQL, ознайомтеся із розділом check Налаштування бази даних для Weblate, щоб дізнатися більше про готову до промислової роботи конфігурацію):

    weblate migrate
    
  4. Створіть обліковий запис адміністративного користувача і скопіюйте пароль, який буде виведено, до буфера обміну даними, а також збережіть його для наступного використання:

    weblate createadmin
    
  5. Зберіть статичні файли для вебсервера (див. Запуск сервера і Обслуговування статичних файлів):

    weblate collectstatic
    
  6. Стисніть файли JavaScript і CSS (необов’язково, див. Стиснення клієнтських даних):

    weblate compress
    
  7. Запустіть обробники Celery. У цьому немає потреби для розробки, але ми наполегливо рекомендуємо це у всіх інших варіантах. Див. Фонові завдання з використанням Celery, щоб дізнатися більше:

    ~/weblate-env/lib/python3.7/site-packages/weblate/examples/celery start
    
  8. Запустіть сервер для розробки (див. Запуск сервера, щоб дізнатися більше про промислові налаштування):

    weblate runserver
    

Після встановлення

Вітаємо, тепер ваш сервер Weblate запущено, і ви можете розпочати ним користуватися.

  • Ви можете отримувати доступ до Weblate за адресою http://localhost:8000/.

  • Увійдіть до системи за допомогою реєстраційних даних, які було отримано під час встановлення, або зареєструйте нових користувачів.

  • Тепер ви можете віддавати команди Weblate за допомогою програми weblate, коли віртуальне середовище Weblate є активним, див. Команди керування.

  • Припинити роботу тестового сервера можна за допомогою натискання комбінації клавіш Ctrl+C.

  • Ознайомтеся із переліком можливих проблем встановлення або за URL-адресою /manage/performance/, або за допомогою команди weblate check --deploy, див. Промислові налаштування.

Додавання перекладу

  1. Відкрийте адміністративний інтефейс (http://localhost:8000/create/project/) і створіть проєкт, який ви хочете перекладати. Див. Налаштування проєкту, щоб дізнатися більше.

    Усе, що вам слід тут вказати, це назва проєкту і адреса його сайта.

  2. Створіть складник, який є справжнім об’єктом для перекладу — він вказує на сховище системи керування версіями і визначає, які файли слід перекладати. Див. Налаштовування складників, щоб дізнатися більше.

    Важливими полями тут є такі: назва складника, адреса сховища системи керування версіями та маска для пошуку придатних до перекладу файлів. У Weblate передбачено підтримку широкого діапазону форматів, зокрема файлів PO gettext PO, рядків ресурсів Android, рядкових властивостей iOS, властивостей Java та файлів Qt Linguist. Див. Підтримувані формати файлів, щоб дізнатися більше.

  3. Щойно буде виконано вказані вище дії (це може бути доволі тривалим процесом, залежно від розмірів вашого сховища системи керування версіями та кількості повідомлень, які слід перекласти), ви можете розпочати переклад.