Instalarea pe SUSE și openSUSE

Cerințe hardware

Weblate should run on any contemporary hardware without problems, the following is the minimal configuration required to run Weblate on a single host (Weblate, database and web server):

  • 3 GB of RAM

  • 2 nuclee CPU

  • 1 GB de spațiu de stocare

Notă

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

Memory usage

The more memory the better - it is used for caching on all levels (file system, database and Weblate). For hundreds of translation components, at least 4 GB of RAM is recommended.

Sugestie

For systems with less memory than recommended, Single-process Celery setup is recommended.

CPU usage

Many concurrent users increase the amount of needed CPU cores.

Storage usage

The typical database storage usage is around 300 MB per 1 million hosted words.

Storage space needed for cloned repositories varies, but Weblate tries to keep their size minimal by doing shallow clones.

Nodes

For small and medium-sized sites (millions of hosted words), all Weblate components (see Architecture overview) can be run on a single node.

When you grow to hundreds of millions of hosted words, it is recommended to have a dedicated node for database (see Configurarea bazei de date pentru Weblate).

Instalare

Cerințe de sistem

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

zypper install \
   libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel \
   libyaml-devel libffi-devel cairo-devel pango-devel \
   gobject-introspection-devel libacl-devel liblz4-devel libzstd-devel libxxhash-devel \
   python3-devel git

Install wanted optional dependencies depending on features you intend to use (see Dependențe Python):

zypper install libldap2-devel libsasl2-devel
zypper install libxmlsec1-devel

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
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

# Gettext for the msgmerge add-on
zypper install gettext

uv package manager

Sugestie

We’re using uv package manager to install Weblate.

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

Vezi și

Installing uv

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:

    uv venv ~/weblate-env
    
  2. Activați virtualenv pentru Weblate:

    . ~/weblate-env/bin/activate
    
  3. Instalați Weblate, inclusiv toate dependențele opționale:

    # Install Weblate with all optional dependencies
    uv pip install "weblate[all]"
    

    Please check Dependențe Python for fine-tuning of optional dependencies.

    Notă

    Pe unele distribuții Linux, rularea Weblate eșuează cu o eroare libffi:

    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)
    

    Acest lucru este cauzat de incompatibilitatea pachetelor binare distribuite prin PyPI cu distribuția. Pentru a rezolva acest lucru, trebuie să reconstruiți pachetul pe sistemul dumneavoastră:

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

Configurarea Weblate

Notă

Ceea ce urmează presupune că virtualenv-ul folosit de Weblate este activat (prin executarea . ~/weblate-env/bin/activate). În caz contrar, specificați calea completă a comenzii weblate ca ~/weblate-env/bin/weblate.

  1. Copiați fișierul ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py în ~/weblate-env/lib/python3.9/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 configurație pregătită pentru producție):

    weblate migrate
    

    Vezi și

    migrate

  4. Create an administrator user account admin, generate its password, and copy it to the clipboard; remember to save it for later use:

    weblate createadmin
    

    Sugestie

    If you previously missed/lost the admin password, you can generate a new one with the following command:

    weblate createadmin --update
    

    Vezi și

    createadmin

  5. Colectează fișierele statice pentru serverul tău 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 lucrurile 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.9/site-packages/weblate/examples/celery start
    
  8. Porniți serverul de dezvoltare ( Rularea serverului 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/.

  • Conectați-vă cu acreditările de administrator obținute în timpul instalării sau înregistrați-vă cu utilizatori noi.

  • 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.

  • Review potential issues with your installation either on /manage/performance/ URL (see Raport de performanță) or using weblate check --deploy, see 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.

    Câmpurile importante aici sunt: Nume componentă, Depozitar cod sursă și Mască de fișier pentru găsirea fișierelor traductibile. Weblate acceptă o gamă largă de formate, inclusiv GNU gettext PO (Portable Object), Resurse de șiruri Android, Șiruri Apple iOS, Proprietăți Java, Format Stringsdict sau Format fluent, consultați Formate de fișiere acceptate pentru mai multe detalii.

  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.