Kódhozzájárulás kezdése a Weblate-hez¶

Ismerkedjen meg a Weblate forráskódjával a következő dokumentációs részeken keresztül: Weblate forráskód, Weblate felhasználói felület és A Weblate belső működése.

Ismerkedés a kódbázissal¶

Kezdésként próbálja ki a good first issue címkével ellátott hibákat, hogy megismerje a Weblate kódbázisát.

Nyugodtan elkezdhet dolgozni ezeken a hibajegyeken anélkül, hogy engedélyt kérne. Az adott hibajegynél jelezze, hogy foglalkozik vele, így egyértelmű lesz, hogy már dolgozik rajta.

Weblate futtatása helyileg¶

A legkényelmesebb módja a Weblate fejlesztésének megkezdésére, ha követi a Telepítés forráskódból útmutatót. Ez létrehoz egy virtualenv környezetet, amelyben a Weblate forrása szerkeszthető formában elérhető.

Klónozza a Weblate forráskódját:

git clone https://github.com/WeblateOrg/weblate.git
cd weblate

Hozzon létre egy virtualenv-et:

uv venv .venv
source .venv/bin/activate

Telepítse a Weblate-et (ehhez néhány rendszerfüggőség is szükséges – lásd: Telepítés forráskódból) és minden, fejlesztéshez hasznos függőséget:
```
uv pip install -e '.[dev]'
```

Indítsa el a fejlesztői szervert:
```
weblate runserver
```
A beállításától függően el kell indítani a Celery munkafolyamatokat is:
```
./weblate/examples/celery start
```
Tesztek futtatásához (lásd: Weblate helyi tesztelése):
```
. scripts/test-database.sh
pytest
```

Lásd még

Telepítés forráskódból

Weblate futtatása helyileg Dockerben¶

Ha a Docker és a docker-compose-plugin telepítve van, szüksége lesz egy további eszközre, a jq-ra is, amelyet a kedvenc csomagkezelőjén keresztül telepíthet. Ezután egyszerűen elindíthatja a fejlesztői környezetet a következő paranccsal:

./rundev.sh

Ez létrehoz egy fejlesztői Docker-képet, és elindítja azt. A Weblate a <http://127.0.0.1:8080/> címen érhető el, a bejelentkezéshez használja a admin felhasználónevet és a admin jelszót. Az új telepítés üres, így érdemes folytatni a Fordítási projektek és összetevők hozzáadása rész alapján.

A Weblate úgy van beállítva, hogy a maildev konténert használja e-mail szerverként. A kézbesített e-mailek a <http://127.0.0.1:1080/> címen tekinthetők meg.

A hozzá tartozó Dockerfile és docker-compose.yml fájlok a dev-docker könyvtárban találhatók. A fejlesztés megkönnyítése érdekében a PostgreSQL-t futtató konténer a 5433-as porton elérhető.

A szkript néhány paramétert is elfogad: tesztek futtatásához indítsa el test paraméterrel, majd adja meg a kívánt test paramétereket. Például, ha csak a weblate.machine modul tesztjeit szeretné futtatni:

./rundev.sh test --exitfirst weblate/machine

Megjegyzés

Figyeljen arra, hogy a Docker-konténerek elindultak-e a tesztek futtatása előtt. Ezt a docker ps paranccsal ellenőrizheti.

Naplók megtekintéséhez:

./rundev.sh logs

Háttérkonténerek leállítása:

./rundev.sh stop

Ha a szkriptet argumentum nélkül futtatja, újra létrehozza és újraindítja a Docker-konténert.

Figyelem

Ez a konténer nem alkalmas éles környezetben való használatra. A biztonság feláldozásra kerül a fejlesztés megkönnyítése érdekében.

Fejlesztői példány inicializálása¶

Érdemes lehet a import_demo parancsot használni demó fordítások létrehozásához, illetve a createadmin parancsot egy admin felhasználó létrehozásához.

Weblate fejlesztése PyCharm használatával¶

A PyCharm egy ismert IDE (integrált fejlesztőkörnyezet) Python fejlesztéshez – az alábbi útmutató segít a Weblate projekt beállításában.

Miután a GitHub tárolót egy mappába klónozta, egyszerűen nyissa meg azt a PyCharmban. Amint megnyílik az IDE, az első lépés a használandó értelmező (interpreter) megadása:

Választhat, hogy a PyCharm hozza létre a virtualenv-et (virtuális környezetet) vagy kijelölhet egy már meglévőt:

Ne feledje telepíteni a függőségeket, miután beállította az interpretert – ezt megteheti konzolon keresztül (az IDE konzolja alapértelmezésben a virtualenv-et használja) vagy az interfészen keresztül, amikor figyelmeztetést kap a hiányzó csomagokról.

A második lépés a szükséges Django beállítások megadása, hogy az IDE natívan támogassa azt – így közvetlenül elindíthatja az egységteszteket. Ehhez meg kell adnia a Django projekt gyökérútvonalát és a beállításfájl elérési útját:

Figyelem: a Django projekt gyökérkönyvtára maga a tároló gyökere, nem a Weblate almappája. A beállításokhoz használhatja a tárolóban található weblate/settings_test.py fájlt, de akár létre is hozhat saját konfigurációt.

Az utolsó lépés a szerver futtatása és töréspontok (breakpointok) elhelyezése a kódban, hogy hibakeresésre is alkalmas legyen. Ehhez hozzon létre egy új Django Server konfigurációt:

Tipp

Figyeljen a No reload tulajdonságra: ez megakadályozza, hogy a szerver automatikusan újratöltődjön fájlmódosítás után, így a meglévő töréspontok aktívak maradnak, és nem vesznek el újratöltéskor.