Opcionális Weblate modulok¶

Több opcionális modul érhető el a rendszer testreszabásához.

Git exportáló¶

Lehetővé teszi az alapul szolgáló Git-tároló olvasásra korlátozott elérését HTTP(S) protokollon keresztül.

Telepítés¶

A settings.py fájlban adja hozzá az weblate.gitexport modult a telepített alkalmazásokhoz:
```
INSTALLED_APPS += ("weblate.gitexport",)
```
A meglévő tárolók exportálásához telepítés után futtassa az adatbázis-migrációt:
```
weblate migrate
```

Tipp

A hivatalos Docker-képen a Git exportáló alapértelmezés szerint be van kapcsolva. Kikapcsoláshoz használja a következőt:

WEBLATE_REMOVE_APPS=weblate.gitexport

Használat¶

A modul automatikusan bekapcsolódik a Weblate működésébe, és beállítja az exportált tároló URL-jét az adott összetevő alatt. A tárolók a Weblate URL-jének /git/ útvonalán keresztül érhetők el, például: https://example.org/git/weblate/main/.

A nyilvánosan elérhető projektek tárolói hitelesítés nélkül klónozhatók:

git clone 'https://example.org/git/weblate/main/'

A korlátozott hozzáférésű tárolók (Személyes hozzáférés-vezérlés mellett vagy ha a REQUIRE_LOGIN beállítás engedélyezett) böngészéséhez API-token szükséges, amely a felhasználói profil oldalon szerezhető be:

git clone 'https://user:KEY@example.org/git/weblate/main/'

Tipp

Alapértelmezés szerint a Felhasználók csoport tagjai és az anonim felhasználók is hozzáférnek a nyilvános projektek tárolóihoz a Tároló hozzáférés és a Képzett felhasználó szerepkörökön keresztül.

Számlázás¶

A Hosted Weblate szolgáltatásban használatos a számlázási csomagok meghatározására, a számlák és a használati korlátok nyomon követésére.

Telepítés¶

1. Add weblate.billing to installed apps in settings.py:

INSTALLED_APPS += ("weblate.billing",)

Futtassa az adatbázis-migrációt az opcionális, további adatbázis-struktúrák telepítéséhez:

weblate migrate

Számlázási csomag létrehozása és hozzárendelése¶

A számlázás aktiválásához először létre kell hozni egy számlázási csomagot. Ehhez navigáljon az Adminisztráció részhez (a csavarkulcs ikon), és nyissa meg az Eszközök képernyőt. Innen lépjen tovább a Django admin felületre.

A Django admin felületen keresse meg a BILLING szekciót, és adjon hozzá egy számlázási csomagot. Például létrehozhat egy Ingyenes csomagot költség nélkül.

Ha meglévő projekthez szeretne számlázási csomagot rendelni, ezt szintén a Django admin felületen belül, a Customer billings opcióval teheti meg.

Végül a Django admin felületen belül található egy Invoice lehetőség is a vevői befizetések nyilvántartására.

Használat¶

A telepítés után a számlázást az admin felületen keresztül lehet kezelni. Azok a felhasználók, akiknél a számlázás engedélyezve van, új Számlázás fület kapnak a felhasználói profiljukban.

A számlázási modul emellett lehetővé teszi a projektadminisztrátorok számára, hogy új projekteket és összetevőket hozzanak létre rendszergazdai jogosultság nélkül (lásd: Fordítási projektek és összetevők hozzáadása). Ez akkor lehetséges, ha az alábbi feltételek teljesülnek:

A számlázás a beállított korlátokon belül van (túllépés esetén blokkolásra kerül az új projekt/összetevő létrehozása), és ki van fizetve (ha a csomag nem ingyenes)
A felhasználó adminisztrátora egy meglévő, számlázással rendelkező projektnek vagy ő a számlázási fiók tulajdonosa (az utóbbi szükséges új számlázási fiók létrehozásakor a projektek importálásához).

Projekt létrehozásakor a felhasználó kiválaszthatja (ha több is elérhető), hogy melyik számlázási fiókot terhelje a projekt.

Jogi modul¶

A Hosted Weblate szolgáltatásban használt modul, amely a szükséges jogi dokumentumokat biztosítja. Üres dokumentumsablonokkal érkezik, amelyeket ki kell tölteni az alábbiak szerint:

legal/documents/tos.html: Használati feltételek dokumentuma
legal/documents/privacy.html: Adatvédelmi irányelvek dokumentuma
legal/documents/summary.html: Rövid összefoglaló a használati feltételekről és az adatvédelmi irányelvekről

Ha módosítja a használati feltételek dokumentumait, frissítse a LEGAL_TOS_DATE értékét, hogy a felhasználókat újra kötelezze az elfogadásra.

Megjegyzés

A Hosted Weblate szolgáltatás jogi dokumentumai elérhetők ebben a Git-tárolóban: <https://github.com/WeblateOrg/wllegal/tree/main/wllegal/templates/legal/documents>

Valószínűleg ezek így nem lesznek közvetlenül használhatók, de kiindulási alapként jól jöhetnek, ha az igényeihez igazítja őket.

Telepítés¶

1. Add weblate.legal to installed apps in settings.py:

INSTALLED_APPS += ("weblate.legal",)

# Optional:

# Social auth pipeline to confirm TOS upon registration/subsequent sign in
SOCIAL_AUTH_PIPELINE += ("weblate.legal.pipeline.tos_confirm",)

# Middleware to enforce TOS confirmation of signed in users
MIDDLEWARE += [
    "weblate.legal.middleware.RequireTOSMiddleware",
]

Futtassa az adatbázis-migrációt az opcionális, további adatbázis-struktúrák telepítéséhez:

weblate migrate

A weblate/legal/templates/legal/ mappában található jogi dokumentumokat igazítsa a saját szolgáltatásához.

Használat¶

A telepítés és a szerkesztés után a jogi dokumentumok megjelennek a Weblate felületén.

Profilképek¶

A profilképek szerveroldali letöltése és gyorsítótárazása alapértelmezés szerint csökkenti az információszivárgás kockázatát a képeket kiszolgáló oldalak felé. Az e-mail-címek alapján történő profilkép-letöltés beépített támogatása kikapcsolható az ENABLE_AVATARS beállítással.

Weblate jelenleg a következőket támogatja:

Lásd még

Profilképek gyorsítótárazása, AVATAR_URL_PREFIX, ENABLE_AVATARS

Kéretlen tartalom elleni védelem¶

A felhasználók által beküldött kéretlen tartalmak ellen az Akismet szolgáltatás használatával védekezhet.

Telepítse az akismet Python modult (ez a hivatalos Docker-képben már megtalálható).
Szerezze be az Akismet API-kulcsot.
Tárolja azt AKISMET_API_KEY vagy Docker esetén WEBLATE_AKISMET_API_KEY változóban.

Az Akismet az alábbi tartalmakat ellenőrzi:

Hitelesítetlen felhasználók javaslatai
Projekt- és összetevőleírások, valamint linkek

Megjegyzés

Ez többek között a felhasználók IP-címét is felhasználja, ezért kérjük, a megfelelő konfigurációért tekintse meg a Fordított (reverse) proxy mögötti futtatás részt.

Lásd még

Fordított (reverse) proxy mögötti futtatás, AKISMET_API_KEY, WEBLATE_AKISMET_API_KEY

Git véglegesítések aláírása GnuPG-vel¶

Minden véglegesítés aláírható a Weblate példány saját GnuPG-kulcsával.

Kapcsolja be a WEBLATE_GPG_IDENTITY beállítást. (A Weblate szükség esetén létrehoz egy GnuPG-kulcsot, és azzal írja alá az összes fordítási véglegesítést.)

Ez a funkció GnuPG 2.1 vagy újabb verziót igényel.

A kulcs a DATA_DIR könyvtárban található, a nyilvános kulcs pedig a „Névjegy” oldalon tekinthető meg:
Alternatív megoldásként meglévő kulcsokat is importálhat Weblate-be, ehhez a HOME=$DATA_DIR/home beállítást használja a gpg meghívásakor.

Tipp

A kulcsanyag hosszú ideig gyorsítótárazódik Weblate-ben. Ha a WEBLATE_GPG_IDENTITY beállítással generált kulcsot később egy azonosítót használó meglévő kulcsra szeretné cserélni, ajánlott a redis gyorsítótár ürítése, hogy a módosítás érvényesüljön.

Megjegyzés

Amennyiben több gép között osztja meg a DATA_DIR könyvtárat, a GnuPG megbízható működése érdekében kövesse a https://wiki.gnupg.org/NFS oldalon található útmutatót.

Lásd még

WEBLATE_GPG_IDENTITY

Sebességkorlátozás¶

A 4.6 verzióban változott: A sebességkorlátozás már nem vonatkozik a bejelentkezett rendszergazdákra.

A Weblate-ben több művelet is sebességkorlátozás alá esik. Legfeljebb RATELIMIT_ATTEMPTS próbálkozás engedélyezett RATELIMIT_WINDOW másodpercen belül. Ezt követően a felhasználó zárolásra kerül RATELIMIT_LOCKOUT időtartamra. Vannak speciális beállítások is egyes műveleti körökre, például RATELIMIT_CONTACT_ATTEMPTS vagy RATELIMIT_TRANSLATE_ATTEMPTS. Az alábbi táblázat tartalmazza az összes elérhető műveleti kört.

Az alábbi műveletek esnek sebességkorlátozás alá:

Név	Hatókör	Engedélyezett próbálkozások	Sebességkorlátozási időablak	Zárolási időszak
Regisztráció	`REGISTRATION`	5	300	600
Üzenetküldés az adminisztrátoroknak	`MESSAGE`	2	300	600
Jelszavas hitelesítés bejelentkezéskor	`LOGIN`	5	300	600
Kétlépcsős hitelesítés	`SECOND_FACTOR`	5	300	600
Teljes oldalas keresés	`SEARCH`	6	60	60
Fordítás	`TRANSLATE`	30	60	600
Szójegyzék bővítése	`GLOSSARY`	30	60	600
Új nyelvre történő fordítás megkezdése	`LANGUAGE`	2	300	600
Új projekt létrehozása	`PROJECT`	5	600	600

Bejelentkezett felhasználóknál a sebességkorlátozás munkamenet-alapú, míg nem bejelentkezett felhasználóknál az IP-címen alapul.

Ha egy felhasználó AUTH_LOCK_ATTEMPTS alkalommal sikertelenül próbál bejelentkezni, a jelszavas hitelesítés le lesz tiltva az adott fióknál, amíg a jelszó helyreállítási folyamaton nem megy végig.

A beállítások Docker-konténerben is alkalmazhatók, ilyenkor a változónév elé WEBLATE_ előtagot kell adni, például a RATELIMIT_ATTEMPTS így lesz WEBLATE_RATELIMIT_ATTEMPTS.

Az API-hoz külön sebességkorlátozási beállítások tartoznak, lásd: API lekérdezési korlátozás.

Lásd még

Sebességkorlátozás, Fordított (reverse) proxy mögötti futtatás, API lekérdezési korlátozás

Fedora Messaging integráció¶

A Fedora Messaging egy AMQP-alapú üzenetküldő rendszer, amely rögzíti a Weblate-ben bekövetkező változásokat. Ezzel a megoldással további szolgáltatásokat kapcsolhat a Weblate-ben történő eseményekhez.

A Fedora Messaging integráció külön Python-modulként, weblate-fedora-messaging néven érhető el. A beállítási útmutató a következő címen található: <https://github.com/WeblateOrg/fedora_messaging/>.

Lásd még

Weblate Messaging