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

1. A settings.py fájlban adja hozzá az weblate.gitexport modult a telepített alkalmazásokhoz:

   INSTALLED_APPS += ("weblate.gitexport",)
   

2. 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ő beállításainál. 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/'

Access to browse the repositories with restricted access (with Private access control or when REQUIRE_LOGIN is enabled) requires an API token which can be obtained in your user profile:

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

Megjegyzés

Weblate serves the Git repository itself, but it does not serve Git LFS objects. For repositories using Git LFS, clone from the upstream repository and add Weblate as another remote. If you only need Git-tracked files, you can clone from Weblate with GIT_LFS_SKIP_SMUDGE=1 to skip downloading Git LFS objects.

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",)

2. 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 adminisztrátori felületen vezérelheti. Az engedélyezett számlázással rendelkező felhasználók új Számlázás lapot 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

Legal documents for the Hosted Weblate service operated by Weblate s.r.o. are available in this Git repository: <https://github.com/WeblateOrg/wllegal/tree/main/wllegal/templates/legal/documents>.

The bundled terms of service and related legal documents are specific to that service and are not intended for general use. They might still come in handy as a starting point if adjusted to meet your needs.

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",
]

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

weblate migrate

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

Tipp

In Docker deployments, enable the legal module using WEBLATE_LEGAL_INTEGRATION instead of editing settings.py. Use tos-confirm to enable the legal module and terms of service confirmation enforcement, or wllegal to additionally load the hosted legal document templates used by services operated by Weblate s.r.o. These templates are not intended for general use. To provide your own templates in Docker, place them in /app/data/python/customize/templates/legal/documents, see Logó és egyéb statikus fájlok cseréje.

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:

• Gravatar

• Libravatar

Lásd még

• Profilképek gyorsítótárazása

• AVATAR_URL_PREFIX

• ENABLE_AVATARS

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