Telepítés macOS 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):

brew install python pango cairo gobject-introspection glib libyaml pkgconf zstd lz4 xxhash libxmlsec1 librsvg uv

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
brew install nginx uwsgi

# Web server option 2: Apache with ``mod_wsgi``
brew install httpd

# Caching backend: Valkey
brew install valkey

# Database server: PostgreSQL
brew install postgresql

# Gettext for the msgmerge add-on
brew install gettext

Python modulok¶

Tipp

We’re installing Weblate in a separate Python environment.

Create the Python environment for Weblate:
```
uv venv ~/weblate-env
```
Activate the Python environment for Weblate:
```
. ~/weblate-env/bin/activate
```
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.

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.
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.
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
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
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
```
Tömörítse a JavaScript és CSS fájlokat (opcionális, lásd: Kliensoldali fájlok tömörítése):
```
weblate compress
```
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
```
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¶

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