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.

Storage performance¶

Version control operations perform many filesystem metadata lookups. The vcs subdirectory in DATA_DIR therefore needs low read latency; storage with slow metadata access can make operations such as git status take a long time even when its bulk throughput is good. Keep CACHE_DIR on low-latency local or temporary storage when possible.

The deployment checks measure metadata lookup latency for both locations and warn when the median latency exceeds 10 milliseconds. This is an approximate point-in-time measurement affected by filesystem and system load. Rerun weblate check --deploy before changing the storage configuration.

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 libyaml pkgconf zstd lz4 xxhash libxmlsec1 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 tools for gettext POT/PO update add-ons
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
```
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 \
    --prefetch-multiplier=1
```
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.