Telepítés RedHat, Fedora és CentOS rendszeren

Hardverkövetelmények

A Weblate bármilyen korszerű hardveren problémamentesen működik, az alábbi minimális konfiguráció szükséges a Weblate (adatbázis és webszerverrel együtt) egyetlen gépen történő futtatásához:

  • 3 GB RAM

  • 2 CPU mag

  • 1 GB tárhely

Megjegyzés

A Weblate telepítésének tényleges követelményei nagymértékben függnek a kezelt fordítások méretétől.

Memóriahasználat

Minél több memória áll rendelkezésre, annál jobb – a memória minden szinten gyorsítótárazásra szolgál (fájlrendszer, adatbázis és Weblate). Több száz fordítási összetevő esetén legalább 4 GB RAM ajánlott.

Tipp

Ha kevesebb memória áll rendelkezésre, mint az ajánlott, a Egyszálú Celery beállítás használata javasolt.

CPU-használat

Sok egyidejű felhasználó esetén nő a szükséges CPU magok száma.

Tárhelyhasználat

Az adatbázis tipikus tárhelyigénye körülbelül 300 MB 1 millió tárolt szóra vetítve.

A klónozott tárolók tárhelyigénye változó, de a Weblate igyekszik a méretüket minimálisra csökkenteni sekély (shallow ) klónozások alkalmazásával.

Csomópontok

Kis és közepes méretű webhelyek esetén (milliós nagyságrendű tárolt szavak) az összes Weblate összetevő (lásd: Rendszer-architektúra áttekintése) egyetlen csomóponton is futtatható.

Amikor a tárolt szavak száma százmilliók fölé nő, ajánlott külön csomópontot biztosítani az adatbázis számára (lásd: Adatbázis beállítása Weblate-hez).

Telepítés

Rendszerkövetelmények

Telepítse a Python modulok fordításához szükséges csomagokat (lásd: Szoftverkövetelmények):

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

Telepítse azokat az opcionális csomagokat, amire a funkciókhoz szüksége van (lásd: Python függőségek):

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

Opcionálisan telepítse az éles kiszolgáló működtetéséhez szükséges szoftvereket, lásd: Szerver futtatása, Adatbázis beállítása Weblate-hez, Háttérfeladatok Celery használatával. Nagyobb rendszerek esetén célszerű lehet ezeket az összetevőket külön kiszolgálókon futtatni.

Helyi telepítési útmutató:

# 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 csomagkezelő

Tipp

We’re using uv package manager to install Weblate.

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

Lásd még

uv telepítése

Python modulok

Tipp

We’re installing Weblate in a separate Python environment.

  1. Create the Python environment for Weblate:

    uv venv ~/weblate-env

  2. Activate the Python environment for Weblate:

    . ~/weblate-env/bin/activate

  3. Telepítse a Weblate-t, beleértve az összes opcionális függőséget:

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

    További információ az opcionális függőségek részletes beállításairól: Python függőségek.

Lásd még

Weblate konfigurálása

Megjegyzés

The following assumes the Python environment used by Weblate is activated (by executing . ~/weblate-env/bin/activate). If not, specify the full path to the weblate command as ~/weblate-env/bin/weblate.

  1. Másolja a ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py fájlt a következő néven: ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.

  2. A létrehozott settings.py fájlban végezze el a kívánt módosításokat. Legalább az adatbázis hitelesítő adatait és a Django titkos kulcsot meg kell adni, de érdemes további módosításokat is végrehajtani az éles környezethez, lásd: Konfiguráció módosítása.

  3. Hozza létre az adatbázist és annak struktúráját a Weblate számára (a példa beállítások PostgreSQL-t használnak, éles környezethez lásd: Adatbázis beállítása Weblate-hez):

    weblate migrate

    Lásd még

    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

    Tipp

    Ha korábban elfelejtette vagy elveszítette az admin jelszót, a következő paranccsal hozhat létre újat:

    weblate createadmin --update

    Lásd még

    createadmin

  5. Gyűjtse össze a statikus fájlokat a webkiszolgáló számára (lásd: Szerver futtatása és Statikus fájlok kiszolgálása):

    weblate collectstatic

  6. Tömörítse a JavaScript és CSS fájlokat (opcionális, lásd: Kliensoldali fájlok tömörítése):

    weblate compress

  7. Indítsa el a Celery munkafolyamatokat. Ez fejlesztési célokra nem kötelező, de minden más esetben erősen ajánlott. További információ: Háttérfeladatok Celery használatával:

    celery --app=weblate.utils worker --beat --queues=celery,notify,memory,translate,backup

  8. Indítsa el a fejlesztői kiszolgálót (az éles környezet beállításairól lásd: Szerver futtatása):

    weblate runserver

Telepítés után

Gratulálunk, a Weblate szerver sikeresen elindult, és máris elkezdheti használni.

  • A Weblate elérhető a http://localhost:8000/ címen.

  • Jelentkezzen be az admin hitelesítő adatokkal, amelyeket a telepítés során kapott vagy regisztráljon új felhasználókat.

  • You can now run Weblate commands using weblate command when Weblate Python environment is active, see Kezelőparancsok.

  • A tesztkiszolgáló leállításához nyomja meg a Ctrl+C billentyűkombinációt.

  • Ellenőrizze a telepítés esetleges problémáit a /manage/performance/ URL alatt (lásd: Teljesítményjelentés) vagy a következő parancs segítségével: weblate check --deploy, további részletek: Éles környezet beállítása.

Fordítás hozzáadása

  1. Nyissa meg az adminisztrációs felületet (http://localhost:8000/create/project/), és hozzon létre egy fordítandó projektet. További részletek: Projektkonfiguráció.

    Itt elegendő megadni a projekt nevét és weboldalát.

  2. Hozzon létre egy összetevőt, amely a tényleges fordítási objektum – ez hivatkozik a VCS (verziókezelő) tárolóra, és meghatározza, hogy mely fájlokat kell fordítani. További részletek: Összetevőkonfiguráció.

    A legfontosabb mezők itt: Összetevő neve, Forráskód tároló, és Fájlmaszk, amelyek a fordítandó fájlok azonosításához szükségesek. A Weblate számos formátumot támogat, többek között: GNU gettext PO (Portable Object), Android szövegerőforrások, Apple iOS-sztringek, Java properties, Stringsdict-formátum vagy Fluent-formátum. További formátumok: Fordítási fájlformátumok.

  3. Ha a fenti lépésekkel végzett (ami időigényes lehet a VCS tároló méretétől és a fordítandó üzenetek számától függően), elkezdheti a fordítást.