Instalarea pe Debian și Ubuntu

Cerințe hardware

Weblate ar trebui să ruleze fără probleme pe orice hardware contemporan, următoarea este configurația minimă necesară pentru a rula Weblate pe o singură gazdă (Weblate, baza de date și serverul web):

  • 2 GB de RAM

  • 2 nuclee CPU

  • 1 GB de spațiu de stocare

Cu cât mai multă memorie, cu atât mai bine - aceasta este utilizată pentru memoria cache la toate nivelurile (sistem de fișiere, bază de date și Weblate).

Un număr mare de utilizatori simultani crește numărul de nuclee CPU necesare. Pentru sute de componente de traducere se recomandă cel puțin 4 GB de memorie RAM.

Utilizarea obișnuită a bazei de date este de aproximativ 300 MB pentru 1 milion de cuvinte găzduite. Spațiul de stocare necesar pentru depozitele clonate variază, dar Weblate încearcă să mențină dimensiunea acestora la un nivel minim prin clonarea superficială.

Notă

Cerințele reale pentru instalarea Weblate variază foarte mult în funcție de dimensiunea traducerilor gestionate în cadrul acesteia.

Instalare

Cerințe de sistem

Instalați dependențele necesare pentru a construi modulele Python (consultați Cerințe software):

apt install \
   libxml2-dev libxslt-dev libfreetype6-dev libjpeg-dev libz-dev libyaml-dev \
   libffi-dev libcairo-dev gir1.2-pango-1.0 libgirepository1.0-dev \
   libacl1-dev libssl-dev libpq-dev libjpeg62-turbo-dev build-essential \
   python3-gdbm python3-dev python3-pip python3-virtualenv virtualenv git

Instalați dependențele opționale dorite în funcție de caracteristicile pe care intenționați să le utilizați (vezi Dependențe opționale):

apt install tesseract-ocr libtesseract-dev libleptonica-dev
apt install libldap2-dev libldap-common libsasl2-dev
apt install libxmlsec1-dev

Instalarea opțională a software-ului pentru rularea serverului de producție, a se vedea Rularea serverului, Configurarea bazei de date pentru Weblate, Sarcini de fundal folosind Celery. În funcție de mărimea instalației tale, este posibil să dorești să rulezi aceste componente pe servere dedicate.

Instrucțiunile de instalare locală:

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

# Web server option 2: Apache with ``mod_wsgi``
apt install apache2 libapache2-mod-wsgi-py3

# Caching backend: Redis
apt install redis-server

# Database server: PostgreSQL
apt install postgresql postgresql-contrib

# SMTP server
apt install exim4

Module Python

Sugestie

Folosim virtualenv pentru a instala Weblate într-un mediu separat de sistemul dumneavoastră. Dacă nu sunteți familiarizați cu el, consultați virtualenv User Guide.

  1. Creați un virtualenv pentru Weblate:

    virtualenv --python=python3 ~/weblate-env

  2. Activați virtualenv pentru Weblate:

    . ~/weblate-env/bin/activate

  3. Instalați Weblate, inclusiv toate dependențele opționale:

    # pkgconfig is needed to install borgbackup 1.2
pip install pkgconfig
# Install Weblate with all optional dependencies
pip install "Weblate[all]"

    Vă rugăm să verificați Dependențe opționale pentru reglarea fină a dependențelor opționale.

    Notă

    On some Linux distributions running Weblate fails with libffi error:

    ffi_prep_closure(): bad user_data (it seems that the version of the libffi library seen at runtime is different from the 'ffi.h' file seen at compile-time)

    This is caused by incompatibility of binary packages distributed via PyPI with the distribution. To address this, you need to rebuild the package on your system:

    pip install --force-reinstall --no-binary :all: cffi

Configurarea Weblate

Notă

Următorii pași presupun că virtualenv folosit de Weblate este activ (ceea ce se poate face prin . ~/weblate-env/bin/activate). În cazul în care acest lucru nu este adevărat, va trebui să specificați calea completă a comenzii weblate ca ~/weblate-env/bin/weblate.

  1. Copiați fișierul ~/weblate-env/lib/python3.7/site-packages/weblate/settings_example.py în ~/weblate-env/lib/python3.7/site-packages/weblate/settings.py.

  2. Ajustați valorile din noul fișier settings.py după bunul plac. Va trebui să furnizați cel puțin credențialele bazei de date și cheia secretă Django, dar veți dori mai multe modificări pentru configurarea de producție, consultați Ajustarea configurației.

  3. Creați baza de date și structura acesteia pentru Weblate (setările de exemplu utilizează PostgreSQL, verificați Configurarea bazei de date pentru Weblate pentru o configurare pregătită pentru producție):

    weblate migrate

  4. Creați contul de utilizator administrator și copiați parola pe care o scoate în clipboard și, de asemenea, salvați-o pentru utilizare ulterioară:

    weblate createadmin

  5. Colectează fișiere statice pentru serverul web (a se vedea Rularea serverului și Servirea fișierelor statice):

    weblate collectstatic

  6. Comprimarea fișierelor JavaScript și CSS (opțional, consultați Comprimarea activelor clienților):

    weblate compress

  7. Începeți să lucrați cu Celery. Acest lucru nu este necesar în scopuri de dezvoltare, dar este recomandat cu tărie în caz contrar. Pentru mai multe informații, consultați Sarcini de fundal folosind Celery:

    ~/weblate-env/lib/python3.7/site-packages/weblate/examples/celery start

  8. Porniți serverul de dezvoltare (consultați Rularea serverului pentru configurația de producție):

    weblate runserver

După instalare

Felicitări, serverul Weblate este acum în funcțiune și puteți începe să îl utilizați.

  • Acum puteți accesa Weblate pe http://localhost:8000/.

  • Sign in with admin credentials obtained during installation or register with new users.

  • Acum puteți rula comenzi Weblate folosind comanda weblate atunci când Weblate virtualenv este activ, consultați Comenzi de gestionare.

  • Puteți opri serverul de testare cu Ctrl+C.

  • Examinați problemele potențiale ale instalării dvs. fie pe URL-ul /manage/performance/ (consultați Interfața de gestionare), fie folosind weblate check --deploy, consultați Configurarea producției.

Adăugarea traducerii

  1. Deschideți interfața de administrare (http://localhost:8000/create/project/) și creați proiectul pe care doriți să-l traduceți. Consultați proiect pentru mai multe detalii.

    Tot ce trebuie să specificați aici este numele proiectului și site-ul acestuia.

  2. Creați o componentă care este obiectul real al traducerii - aceasta indică depozitul VCS și selectează fișierele care trebuie traduse. Pentru mai multe detalii, consultați Configurația componentei.

    The important fields here are: Denumirea componentei, Depozitul de cod sursă, and Masca de fișier for finding translatable files. Weblate supports a wide range of formats including GNU gettext, Resurse de șiruri Android, Șiruri Apple iOS, Proprietăți Java, Formatul Stringsdict or Format fluent, see Formate de fișiere acceptate for more details.

  3. După ce ați finalizat cele de mai sus (poate fi un proces de lungă durată, în funcție de dimensiunea depozitului VCS și de numărul de mesaje de tradus), puteți începe traducerea.