Beállítások

Minden beállítás a settings.py fájlban van tárolva (ahogy az a Django rendszernél szokásos).

Megjegyzés

A beállítások módosítása után újra kell indítani a Weblate-et — mind a WSGI, mind a Celery folyamatokat.

Ha mod_wsgi alatt futtatja a Weblate-et, az Apache szervert is újra kell indítani a konfiguráció betöltéséhez.

Lásd még

Tekintse át a Django dokumentációját is a Django saját konfigurációs paramétereinek megismeréséhez.

ADMINS_CONTACT

Ez határozza meg, hova küldje a kapcsolatfelvételi űrlap az e-maileket. Ha nincs külön megadva, az ADMINS beállításban szereplő e-mail címek lesznek használva.

A beállítást egy e-mail címekből álló listaként kell megadni:

ADMINS_CONTACT = ["admin@example.com", "support@example.com"]

Lásd még

ALLOWED_ASSET_DOMAINS

Added in version 5.14.

Configures which domains are allowed for fetching assets in Weblate.

This enhances security by preventing loading assets from untrusted sources. Assets are downloaded once by the Weblate server and stored locally, rather than being served directly from external domains to users.

The allowlist is applied to the initial URL and to every HTTP redirect target before Weblate follows it. Redirects to hosts outside of this allowlist are rejected.

It expects a list of host/domain names. You can use fully qualified names (e.g www.example.com) or prepend with a period as a wildcard to match all subdomains (e.g .example.com will match cdn.example.com or static.example.com).

Defaults to ["*"], which allows all domains.

Example

ALLOWED_ASSET_DOMAINS = [
    # Allows only cdn.anotherdomain.org
    "cdn.anotherdomain.org",
    # Allows example.com and all its subdomains
    ".example.com",
]

This is currently used in the following places:

Lásd még

ALLOWED_MACHINERY_DOMAINS

Configures which custom machinery domains are explicitly allowed in project-level machine translation configuration.

This setting applies only to machinery services and does not affect ALLOWED_ASSET_DOMAINS.

It expects a list of host/domain names. You can use fully qualified names or prepend with a period as a wildcard to match all subdomains.

Defaults to [].

The allowlist affects project-managed machinery in two ways: it permits the configured endpoint during outbound validation, and it marks matching hosts as trusted when deciding whether remote provider error details or response bodies can be shown to the user. For direct connections, runtime checks still reject destinations that resolve to private or otherwise non-public addresses. When an HTTP(S) proxy is used, runtime validation falls back to hostname validation and does not perform the same local DNS or peer-IP checks.

ALLOWED_ASSET_SIZE

Added in version 5.14.

Configures size limit for fetching assets in Weblate. Defaults to 10 MB.

Lásd még

ASSET_PRIVATE_ALLOWLIST

Added in version 2025.5.

Defines hostnames or domains exempt from ASSET_RESTRICT_PRIVATE for remote asset downloads that enforce private-target checks. Entries follow Django host matching semantics, so values such as assets.internal.example or .internal.example can be used.

This does not replace ALLOWED_ASSET_DOMAINS; remote assets must still match the asset domain allowlist.

Alapértelmezett konfiguráció:

ASSET_PRIVATE_ALLOWLIST = []

Lásd még

ASSET_RESTRICT_PRIVATE

Added in version 2025.5.

Reject remote asset URLs pointing to internal or non-public addresses unless the target host is included in ASSET_PRIVATE_ALLOWLIST. On by default.

When enabled, hostnames that cannot be resolved during validation are rejected unless they are explicitly included in ASSET_PRIVATE_ALLOWLIST. This currently applies to screenshot URL uploads and remote HTML downloads for the JavaScript lokalizációs CDN add-on.

Lásd még

ALTCHA_COST

Added in version 5.18.

Argon2id time cost for the ALTCHA proof-of-work challenge. Defaults to 3.

Replaces ALTCHA_MAX_NUMBER, which applied to the removed ALTCHA widget v2.

ALTCHA_MEMORY_COST

Added in version 5.18.

Argon2id memory cost in KiB. Defaults to 65536.

ALTCHA_PARALLELISM

Added in version 5.18.

Argon2id parallelism factor. Defaults to 1.

Lásd még

ALTCHA Proof of Work mechanizmus

ANONYMOUS_USER_NAME

A nem bejelentkezett felhasználók felhasználóneve.

Lásd még

Hozzáférés-vezérlés

AUDITLOG_EXPIRY

A naplózási adatokban tárolt fióktevékenységi információk maximális megőrzési ideje napokban számolva.

Alapértelmezett érték: 180 nap.

AUTH_LOCK_ATTEMPTS

A hibás hitelesítési kísérletek maximális száma, mielőtt a rendszer korlátozást alkalmaz.

Jelenleg az alábbi esetekben érvényesül:

  • Bejelentkezés: Törli a fiók jelszavát, így a felhasználó nem tud bejelentkezni, amíg új jelszót nem igényel.

  • Jelszó visszaállítása: új visszaállító e-mailek küldését tiltja le, elkerülve a visszaélésből eredő spamküldést.

Alapértelmezett érték: 10 hibás próbálkozás.

Lásd még

Sebességkorlátozás

AUTO_UPDATE

Minden tárolót napi rendszerességgel frissít.

Tipp

Ez akkor lehet hasznos, ha nem használja a Értesítési hookok funkciót a Weblate tárolók automatikus frissítésére.

Megjegyzés

A kompatibilitás megőrzése érdekében a karakterlánc-választás mellett ki- és bekapcsolási lehetőségek is elérhetők.

Az elérhető opciók:

"none"

Napi frissítések kikapcsolása.

"remote" — ugyanaz, mint a False érték

Csak a távoli tárolók frissítése.

"full" — ugyanaz, mint a True érték

A távoli tárolók frissítése és a munkapéldány összeolvasztása.

Megjegyzés

Ez a beállítás csak akkor működik, ha a Háttérfeladatok Celery használatával megfelelően fut, és a módosítás után újra kell indítani.

AVATAR_URL_PREFIX

Profilkép URL-ek előtagja, az alábbi formátumban: ${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS}. Az alábbi szolgáltatásokkal működik:

Gravatar (alapértelmezett), lásd: https://gravatar.com/

AVATAR_URL_PREFIX = 'https://www.gravatar.com/'

Libravatar, lásd: https://www.libravatar.org/

AVATAR_URL_PREFIX = 'https://www.libravatar.org/'

Lásd még

AUTH_TOKEN_VALID

Az hitelesítő tokenek és a jelszó-visszaállító e-mailekben küldött ideiglenes jelszavak érvényességi ideje másodpercben megadva. Alapértelmezett érték: 172800 másodperc (2 nap).

AUTH_PASSWORD_DAYS

A napok száma, ameddig a Weblate nem engedi egy korábban használt jelszó újrafelhasználását ugyanazon felhasználó számára.

Az ellenőrzés az auditnaplón alapul, így az AUDITLOG_EXPIRY beállítás értékének legalább ekkorának kell lennie.

Megjegyzés

A Weblate 2.15 előtti jelszóváltoztatásokra ez a szabályzat nem vonatkozik.

Alapértelmezett érték: 180 nap.

AUTOFIX_LIST

Automatikusan alkalmazott javítások listája szöveg mentésekor.

Megjegyzés

Adja meg az automatikus javítót megvalósító Python osztály teljes elérési útját.

Az elérhető javításokat a Automatikus javítások rész tartalmazza.

Kiválaszthatja, hogy mely javításokat kívánja használni:

AUTOFIX_LIST = (
    "weblate.trans.autofixes.whitespace.SameBookendingWhitespace",
    "weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis",
)

Lásd még

BACKGROUND_TASKS

Added in version 4.5.2.

Meghatározza, hogy milyen gyakran indítsa el a rendszer a hosszabb karbantartási feladatokat egy összetevőnél.

Jelenleg az alábbiak vezérlésére szolgál:

Lehetséges beállítások:

  • monthly (ez az alapértelmezett)

  • weekly

  • daily

  • never

Megjegyzés

A gyakoriság növelése nem ajánlott, ha a Weblate telepítés több ezer összetevőt tartalmaz.

BASIC_LANGUAGES

Added in version 4.4.

A felhasználók számára felkínált nyelvek listája új fordítás indításakor. Ha nincs megadva, a beépített lista lesz használva (amely minden elterjedt nyelvet tartalmaz, de ország-specifikus változatok nélkül).

Ez a beállítás csak a az adminisztrációs joggal nem rendelkező felhasználók számára korlátozza a nem kívánt nyelvek hozzáadását. A projekt adminisztrátorok továbbra is a Weblate által definiált teljes nyelvlistát látják.

Megjegyzés

Ez a beállítás nem hoz létre új nyelveket a Weblate-ben — csupán az adatbázisban meglévő nyelvek szűrését szabályozza.

Példa:

BASIC_LANGUAGES = {"cs", "it", "ja", "en"}

Lásd még

Nyelvi definíciók

BORG_EXTRA_ARGS

Added in version 4.9.

További argumentumokat adhat meg a borg create parancshoz, amikor a beépített biztonsági mentések elindulnak.

Példa:

BORG_EXTRA_ARGS = ["--exclude", "vcs/"]

Lásd még

CACHE_DIR

Added in version 4.16.

A könyvtár, ahol a Weblate a gyorsítótár fájlokat tárolja. Alapértelmezett hely: a DATA_DIR könyvtár cache almappája.

Érdemes helyi vagy ideiglenes fájlrendszert megadni erre a célra, ha a DATA_DIR hálózati fájlrendszeren található.

Weblate stores generated helper files here and executes some of them, so CACHE_DIR has to be writable and mounted on a filesystem that allows execution. Avoid using noexec mount options for this directory.

A Docker-konténer külön kötetet használ ehhez, lásd: Docker-konténer kötetek.

A következő alkönyvtárak jellemzően léteznek:

ssh

Generated helper files used for VCS access.

fonts

font-config gyorsítótár a Betűtípusok kezelése kezeléséhez.

avatar

Gyorsítótárazott felhasználói profilképek, lásd: Profilképek.

static

Alapértelmezett hely a statikus Django-fájlok számára, amit a STATIC_ROOT határoz meg. Lásd: Statikus fájlok kiszolgálása.

tesseract

OCR betanított adatok a Screenshots and visual context funkcióhoz.

CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC

Customize the Content-Security-Policy header for Weblate. The header is automatically generated based on enabled integrations with third-party services (Matomo, Google Analytics, Sentry, …).

All these default to an empty list.

Példa:

# Enable Cloudflare Javascript optimizations
CSP_SCRIPT_SRC = ["ajax.cloudflare.com"]

Lásd még

CHECK_LIST

A fordításokon végrehajtandó minőség-ellenőrzések listája.

Megjegyzés

Adja meg az ellenőrzési felületet megvalósító Python osztály teljes elérési útját.

A saját igényei szerint állítsa össze az ellenőrzések listáját.

Minden beépített Minőség-ellenőrzések alapértelmezetten be van kapcsolva, ezeket a Mintakonfiguráció fájlban tudja módosítani, ahol kezdetben ki vannak kommentelve, így az alapértékek érvényesülnek. Minden új Weblate verzióval az új ellenőrzések automatikusan lefutnak.

Az összes ellenőrzést ki is kapcsolhatja:

CHECK_LIST = ()

Csak néhány ellenőrzést is engedélyezhet:

CHECK_LIST = (
    "weblate.checks.chars.BeginNewlineCheck",
    "weblate.checks.chars.EndNewlineCheck",
    "weblate.checks.chars.MaxLengthCheck",
)

Megjegyzés

A beállítás módosítása csak az újonnan módosított fordításokra lesz hatással. A meglévő ellenőrzések továbbra is az adatbázisban maradnak. Ha ezeket is szeretné frissíteni, futtassa a updatechecks parancsot.

Lásd még

COMMIT_PENDING_HOURS

A háttérfeladatként történő függőben lévő változtatások véglegesítése közötti órák száma.

Lásd még

COMPONENT_ZIP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Configures the maximum size, in bytes, for uploaded component ZIP files. Defaults to 50 MB.

In Docker, configure this using the WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE environment variable.

Lásd még

CONTACT_FORM

Added in version 4.6.

Beállítja, hogyan küldje a Weblate az e-maileket a kapcsolatfelvételi űrlapról. Olyan beállítást válasszon, amely megfelel a saját levelezőszerver konfigurációjának.

"reply-to"

The sender is used as Reply-To, this is the default behaviour.

"from"

The sender is used as From. Your mail server needs to allow sending such e-mails.

"disabled"

Disables the contact form entirely.

Added in version 5.15.

Lásd még

ADMINS_CONTACT

DATA_DIR

A könyvtár, amelyben a Weblate minden adatát tárolja. Tartalmazza a VCS (verziókezelő) tárolók linkjeit, a teljes szöveges keresőindexet és külső eszközök különböző konfigurációs fájljait.

A következő alkönyvtárak jellemzően léteznek:

home

A parancsfájlok futtatásakor használt induló (home) könyvtár.

ssh

SSH kulcsok és konfigurációk helye.

media

A Django médiatartalom alapértelmezett helye, amit a MEDIA_ROOT ad meg. Ide kerülnek a feltöltött képernyőképek is, lásd: Screenshots and visual context.

vcs

Fordítások verziókezelő tárolói.

backups

Napi biztonsági mentések adatai. Részletek: Lementett adatok (dumpok) a biztonsági mentésekhez.

fonts:

Felhasználók által feltöltött betűtípusok, lásd: Betűtípusok kezelése.

cache

Különféle gyorsítótárak, amelyek másik helyre is helyezhetők a CACHE_DIR beállítással.

A Docker-konténer külön kötetet használ ehhez, lásd: Docker-konténer kötetek.

Megjegyzés

Ennek a könyvtárnak írhatónak kell lennie a Weblate számára. Ha WSGI-n keresztül futtatja, akkor a www-data felhasználónak kell írási jogosultsággal rendelkeznie.

A legegyszerűbb módja ennek az, ha a megfelelő felhasználót teszi meg a könyvtár tulajdonosává:

sudo chown www-data:www-data -R $DATA_DIR

Alapértelmezett hely: /home/weblate/data, de ajánlott testreszabni a beállítást.

Lásd még

DATABASE_BACKUP

Meghatározza, hogy az adatbázis-mentések szöveges formátumban, tömörítve vagy egyáltalán ne kerüljenek-e tárolásra. Az engedélyezett értékek:

  • "plain"

  • "compressed"

  • "none"

Lásd még

Weblate biztonsági mentése és áthelyezése

DEFAULT_ACCESS_CONTROL

Az új projektek alapértelmezett hozzáférés-vezérlési beállítása:

0

Nyilvános

1

Védett

100

Személyes

200

Egyéni

Ha az ACL-t manuálisan kívánja kezelni, válassza az Egyéni beállítást, ekkor nem a Weblate belső jogosultságkezelésére támaszkodik.

Lásd még

DEFAULT_AUTO_WATCH

Added in version 4.5.

Beállítja, hogy az új felhasználóknál alapértelmezetten be legyen-e kapcsolva a Projektek automatikus követése közreműködéskor funkció. Alapértelmezett érték: True.

Lásd még

Értesítések

DEFAULT_RESTRICTED_COMPONENT

Added in version 4.1.

Az összetevők korlátozásának alapértelmezett értéke.

Lásd még

DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE

A különböző műveletekhez tartozó alapértelmezett véglegesítési (commit) üzenetek. További részletekért lásd: Összetevőkonfiguráció.

Lásd még

DEFAULT_ADDONS

Az alapértelmezett kiegészítők, amelyeket minden új összetevőhöz telepíteni kell.

Megjegyzés

Ez a beállítás csak az újonnan létrehozott összetevőket érinti.

Példa:

DEFAULT_ADDONS = {
    # Add-on with no parameters
    "weblate.flags.target_edit": {},
    # Add-on with parameters
    "weblate.autotranslate.autotranslate": {
        "mode": "suggest",
        "filter_type": "todo",
        "auto_source": "mt",
        "component": "",
        "engines": ["weblate-translation-memory"],
        "threshold": "80",
    },
}

Lásd még

DEFAULT_COMMITER_EMAIL

A véglegesítő (committer) e-mail címe, alapértelmezésben: noreply@weblate.org.

Lásd még

DEFAULT_COMMITER_NAME

DEFAULT_COMMITER_NAME

A véglegesítő neve, alapértelmezésben: Weblate.

Lásd még

DEFAULT_COMMITER_EMAIL

DEFAULT_LANGUAGE

Added in version 4.3.2.

Az új összetevők alapértelmezett Forrásnyelv beállítása.

Alapértelmezett érték: en. A megfelelő nyelvi objektumnak léteznie kell az adatbázisban.

Lásd még

DEFAULT_MERGE_STYLE

Az új összetevők alapértelmezett Egyesítési mód beállítása.

  • rebase - alapértelmezett

  • merge

Lásd még

DEFAULT_SHARED_TM

A Megosztott fordítási memória használata és Hozzájárulás a megosztott fordítási memóriához alapértelmezett beállításainak konfigurálása.

DEFAULT_TRANSLATION_REVIEW

Added in version 5.16.

Configures the default value for Felülvizsgálatok engedélyezése, turned off by default.

DEFAULT_SOURCE_REVIEW

Added in version 5.16.

Configures the default value for Forrás-felülvizsgálatok engedélyezése, turned off by default.

DEFAULT_AUTOCLEAN_TM

Added in version 5.13.

Configures the default value of Fordítási memória automatikus tisztítása.

DEFAULT_TRANSLATION_PROPAGATION

Az alapértelmezett beállítás a fordítási terjesztéshez, alapértelmezésben: True.

Lásd még

DEFAULT_PULL_MESSAGE

Az alapértelmezett cím és üzenet beállítása beküldött módosítási kérelemhez (pull request).

ENABLE_AVATARS

A Gravatar-alapú profilképek bekapcsolása felhasználók számára. Alapértelmezésben engedélyezve van.

A profilképeket a szerver tölti le és gyorsítótárazza, így csökkenti a személyes adatok kiszivárgásának kockázatát, és gyorsabbá teszi a felhasználói élményt.

Lásd még

ENABLE_HOOKS

Az anonim távoli (remote) hookok bekapcsolása.

Lásd még

Értesítési hookok

ENABLE_HTTPS

A 5.7 verzióban változott: A Weblate mostantól HTTPS-t igényel a WebAuthn támogatásához.

Beállítja, hogy a Weblate által küldött hivatkozások HTTPS vagy HTTP protokollt használjanak. Ez a beállítás hatással van a küldött e-mailekre és a generált abszolút URL-ekre.

Az alapértelmezett konfigurációban ez több Django HTTPS-hez kapcsolódó beállítást is vezérel — például a biztonságos sütik (secure cookies) használatát, a HSTS engedélyezését vagy a HTTPS-re való átirányítást.

A HTTPS átirányítás problémát okozhat bizonyos esetekben, például ha SSL-terminációt végző fordított (reverse) proxy mögött fut a Weblate, és az nem adja át helyesen a protokoll fejlécet a Django számára. Ilyenkor érdemes a proxy konfigurációját úgy módosítani, hogy az X-Forwarded-Proto vagy a Forwarded fejlécet küldje, de lehet a SECURE_PROXY_SSL_HEADER beállítást is konfigurálni a helyes SSL-észlelés érdekében.

Ha ez a beállítás le van tiltva, a Weblate nem fog elindulni, és otp_webauthn.E031 hibát ad. Az ellenőrzés elnémítható úgy, hogy hozzáadja a SILENCED_SYSTEM_CHECKS listához, de HTTPS nélkül a WebAuthn akkor sem fog működni.

Lásd még

ENABLE_SHARING

Turn on/off the Community menu so users can share translation progress on social networks.

Lásd még

Building the translation community

EXTRA_HTML_HEAD

Added in version 4.15.

További HTML kód beszúrása a HTML fejlécbe. Ez például webhelytulajdon-ellenőrzés céljára használható:

EXTRA_HTML_HEAD = '<link href="https://fosstodon.org/@weblate" rel="me">'

Figyelem

A megadott sztringen nincs semmilyen szűrés vagy tisztítás, így az változatlanul kerül beillesztésre a HTML fejlécbe.

GET_HELP_URL

Added in version 4.5.2.

A támogatási oldal URL-je, ahol a Weblate példányhoz támogatás található.

GITEA_CREDENTIALS

Added in version 4.12.

Gitea szerverekhez használt hitelesítő adatok listája.

GITEA_CREDENTIALS = {
    "try.gitea.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

A konfigurációs szótár a megadott API-hosztonkénti hitelesítő adatokból áll. A felépítése szinte minden verziókezelő integráció esetén ugyanaz, részletek: Verziókezelő hitelesítési adatok beállítása.

Lásd még

GITLAB_CREDENTIALS

Added in version 4.3.

GitLab szerverekhez használt hitelesítő adatok listája.

GITLAB_CREDENTIALS = {
    "gitlab.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Megjegyzés

The personal access token needs the api scope to be able to use the API.

A konfigurációs szótár a megadott API-hosztonkénti hitelesítő adatokból áll. A felépítése szinte minden verziókezelő integráció esetén ugyanaz, részletek: Verziókezelő hitelesítési adatok beállítása.

Lásd még

GITHUB_CREDENTIALS

Added in version 4.3.

GitHub szerverekhez használt hitelesítő adatok listája.

GITHUB_CREDENTIALS = {
    "api.github.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Megjegyzés

It is possible to use both fine-grained personal access tokens and classic personal access tokens. The fine-grained tokens are limited to a single organization, so it won’t work if you want Weblate to fork a repository outside the organization (typically to the user namespace).

To clone, push and create pull requests, the read and write access to Contents and Pull requests is required.

Az Adminisztráció jogosultság is szükséges lehet, ha másolatot szeretne készíteni a tárolóról (forkolni a tárolót), és az eredeti tároló nem nyilvános.

Tipp

Use api.github.com as an API host for https://github.com/.

A konfigurációs szótár a megadott API-hosztonkénti hitelesítő adatokból áll. A felépítése szinte minden verziókezelő integráció esetén ugyanaz, részletek: Verziókezelő hitelesítési adatok beállítása.

Lásd még

BITBUCKETSERVER_CREDENTIALS

Added in version 4.16.

Bitbucket Data Center szerverekhez használt hitelesítő adatok listája.

BITBUCKETSERVER_CREDENTIALS = {
    "git.self-hosted.com": {
        "username": "weblate",
        "token": "http-access-token",
    },
}

A konfigurációs szótár a megadott API-hosztonkénti hitelesítő adatokból áll. A felépítése szinte minden verziókezelő integráció esetén ugyanaz, részletek: Verziókezelő hitelesítési adatok beállítása.

Lásd még

BITBUCKETCLOUD_CREDENTIALS

Added in version 5.8.

Bitbucket Cloud szerverekhez használt hitelesítő adatok listája.

BITBUCKETCLOUD_CREDENTIALS = {
    "bitbucket.org": {
        "username": "your-email",
        "workspace": "your-workspace-slug",
        "token": "your-api-token",
    },
}

A konfigurációs szótár API-hosztonként meghatározott hitelesítő adatokat tartalmaz. Az API-hoszt eltérhet attól, amit a böngészőben használ, például a GitHub API az api.github.com címen érhető el.

Az alábbi beállítások érhetők el minden hoszthoz:

username

API felhasználó.

workspace

A felhasználói munkaterület URL-azonosítója (slug).

token

The API token with pullrequest:write permission.

További beállítások a Verziókezelő hitelesítési adatok beállítása résznél találhatók.

Lásd még

AZURE_DEVOPS_CREDENTIALS

Added in version 5.2.

Azure DevOps szerverekhez használt hitelesítő adatok listája.

AZURE_DEVOPS_CREDENTIALS = {
    "dev.azure.com": {
        "username": "project-name",
        "token": "your-api-token",
        "organization": "organization-name",
    },
}

A konfigurációs szótár API-hosztonként meghatározott hitelesítő adatokat tartalmaz. Az API-hoszt eltérhet attól, amit a böngészőben használ, például a GitHub API az api.github.com címen érhető el.

Az alábbi beállítások érhetők el minden hoszthoz:

username

Az Azure DevOps projekt neve. Ez nem azonos a tároló nevével.

organization

A projekt szervezetének neve.

workItemIds

Opcionálisan megadható a szervezet munkafolyamat-azonosítóinak listája. Ha meg van adva, az új módosítási kérelmekhez (pull request) ezek automatikusan csatolódnak.

token

API token az API-felhasználóhoz (kötelező).

További beállítások a Verziókezelő hitelesítési adatok beállítása résznél találhatók.

Lásd még

GOOGLE_ANALYTICS_ID

Google Analytics azonosító a Weblate megfigyelésének bekapcsolásához Google Universal Analytics segítségével.

Megjegyzés

Jelenleg a Google Analytics 4 integráció nem érhető el a Weblate-ben. Bővebben lásd: https://github.com/WeblateOrg/weblate/issues/14015

HIDE_REPO_CREDENTIALS

A tároló hitelesítő adatok elrejtése a webes felületről. Ha a tároló URL-je tartalmaz felhasználónevet és jelszót, a Weblate ezeket eltávolítja, amikor a felhasználók számára megjeleníti az adatokat.

Például a https://user:password@git.example.com/repo.git helyett csak https://git.example.com/repo.git jelenik meg. A rendszer hasonló módon igyekszik megtisztítani a verziókezelő rendszer hibaüzeneteit is.

Megjegyzés

Ez a beállítás alapértelmezetten be van kapcsolva.

VERSION_DISPLAY

Added in version 5.17.

Controls how prominently Weblate exposes its own version.

Supported values are:

show

Show the version in shared UI such as the footer and expose it in GET /api/metrics/.

soft

Hide the version from prominent shared UI, while keeping it discoverable on the About page and in GET /api/metrics/.

hide

Hide the version from shared UI and GET /api/metrics/. This also makes anonymous documentation links point to the latest documentation instead of the version matching the installed release.

Hiding the version is a recommended security practice in some corporations, but it does not prevent an attacker from inferring the version by probing behavior.

Megjegyzés

The default is show.

HIDE_VERSION

Added in version 4.3.1.

Elavult a(z) 5.17 verzió óta.

Compatibility alias for VERSION_DISPLAY. Set this to True to get the same behavior as VERSION_DISPLAY = "hide".

IP_BEHIND_REVERSE_PROXY

Annak jelzése, hogy a Weblate fordított (reverse) proxy mögött fut-e.

Ha True értékre van állítva, a Weblate az IP_PROXY_HEADER által meghatározott fejlécből olvassa ki a felhasználó IP-címét.

Figyelem

Fontos, hogy valóban fordított (reverse) proxy-t használjon, és az megfelelően állítsa be ezt a fejlécet, különben a felhasználók hamis IP-címeket is megadhatnak.

Megjegyzés

Ez a beállítás alapértelmezés szerint ki van kapcsolva.

Lásd még

IP_PROXY_HEADER

Azt határozza meg, hogy a Weblate melyik fejlécből olvassa ki az IP-címet, ha az IP_BEHIND_REVERSE_PROXY be van kapcsolva.

Alapértelmezett érték: HTTP_X_FORWARDED_FOR.

Lásd még

IP_PROXY_OFFSET

A 5.0.1 verzióban változott: Az alapértelmezett érték 1-ről -1-re változott.

Azt jelzi, hogy az IP_PROXY_HEADER fejlécben melyik IP-címet kell felhasználni a kliens IP-címeként.

A beállítástól függően ez a fejléc több IP-címet is tartalmazhat (például: X-Forwarded-For: client-ip, proxy-a, proxy-b), és itt adható meg, hogy melyik címet használja a rendszer.

Figyelem

Ennek a beállításnak a módosítása befolyásolja a telepítés biztonságát. Csak megbízható proxyk IP-címének meghatározásához állítsa be. További információk: <https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns>.

Alapértelmezett érték: -1.

Lásd még

LICENSE_EXTRA

További licencek megadása a licencválasztási lehetőségek között.

Megjegyzés

Each license definition should be a tuple of its short name, a long name, a URL and a boolean, indicating whether it is a libre license.

Például:

LICENSE_EXTRA = [
    (
        "AGPL-3.0",
        "GNU Affero General Public License v3.0",
        "https://www.gnu.org/licenses/agpl-3.0-standalone.html",
        True,
    ),
]

LICENSE_FILTER

A 4.3 verzióban változott: Ha ezt az értéket üresre állítja, a licencfigyelmeztetés kikapcsolódik.

A megjelenített licencek listájának szűrése. Üres lista esetén a licencfigyelmeztetés is letiltásra kerül.

Megjegyzés

Ez a szűrő a licenc rövid nevét használja.

Például:

LICENSE_FILTER = {"AGPL-3.0", "GPL-3.0-or-later"}

A következő módon tiltható le a licencfigyelmeztetés:

LICENSE_FILTER = set()

Lásd még

Fordítási összetevő riasztások

LICENSE_REQUIRED

Meghatározza, hogy az összetevő licenc attribútuma kötelező-e.

Megjegyzés

Ez az opció alapértelmezetten ki van kapcsolva.

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH

Meghatározza, hogy egy adott fordítás hosszát korlátozni kell-e. Az alapértelmezett korlát a forrásszöveg hossza × 10 karakter.

Tipp

Ha False értékre állítja, a fordítások hossza a forrásszöveg hosszától függetlenül akár 10 000 karakterig is engedélyezett lesz.

Megjegyzés

Alapértelmezett érték: True.

LOCALIZE_CDN_URL és LOCALIZE_CDN_PATH

These settings configure the CDN add-ons, including JavaScript lokalizációs CDN and Translation files CDN. LOCALIZE_CDN_URL defines root URL where the localization CDN is available and LOCALIZE_CDN_PATH defines path where Weblate should store generated files which will be served at the LOCALIZE_CDN_URL. The files are served by your web server or CDN, not by Weblate; see Lokalizációs CDN for secure serving guidance.

Tipp

A Hosted Weblate esetében ez a https://weblate-cdn.com/ URL.

Lásd még

MATOMO_SITE_ID

A Matomo (korábban Piwik) szolgáltatásban használt site azonosító, amellyel a Weblate használatát követni szeretné.

Megjegyzés

Ez az integráció nem támogatja a Matomo Tag Manager funkciót.

Lásd még

MATOMO_URL

MATOMO_URL

A Matomo (korábban Piwik) telepítésének teljes URL-je (záró perjellel), amelyet a Weblate követéséhez szeretne használni. További részletek: <https://matomo.org/>.

Tipp

Ez az integráció nem támogatja a Matomo Tag Manager funkciót.

Például:

MATOMO_SITE_ID = 1
MATOMO_URL = "https://example.matomo.cloud/"

Lásd még

MATOMO_SITE_ID

NEARBY_MESSAGES

A teljes szerkesztőben megjelenítendő közeli szövegek száma minden irányban.

Ez csak egy alapértelmezett érték, a felhasználók saját Felhasználói profil beállításukban módosíthatják.

DEFAULT_PAGE_LIMIT

Added in version 4.7.

Lapozás esetén megjelenítendő elemek alapértelmezett száma.

PAGURE_CREDENTIALS

Added in version 4.3.2.

Pagure szerverekhez használt hitelesítő adatok listája.

PAGURE_CREDENTIALS = {
    "pagure.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

A konfigurációs szótár a megadott API-hosztonkénti hitelesítő adatokból áll. A felépítése szinte minden verziókezelő integráció esetén ugyanaz, részletek: Verziókezelő hitelesítési adatok beállítása.

Lásd még

PASSWORD_MINIMAL_STRENGTH

Added in version 5.10.2.

A minimálisan elvárt jelszóerősség, a zxcvbn jelszó ellenőrző értékelése alapján.

Alapértelmezett érték: 0, ami azt jelenti, hogy az erősség-ellenőrzés nincs bekapcsolva.

Lásd még

PASSWORD_RESET_URL

Added in version 5.17.

URL for password reset when authentication is handled by an external identity provider, such as LDAP, SAML, or OAuth.

When set, Forgot your password? on the sign-in page links to this URL instead of Weblate’s built-in password reset page.

PRIVACY_URL

Added in version 4.8.1.

Az URL, ahol a Weblate példány adatvédelmi szabályzata elérhető.

Tipp

Ez akkor hasznos, ha a jogi dokumentumokat Weblate-en kívül tárolja, de be szeretné ágyazni őket a Weblate felületére is. További részletek: Jogi modul.

Példa:

PRIVACY_URL = "https://weblate.org/terms/"

Lásd még

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN

Added in version 4.15.

Beállítja, hogy az egyéni véglegesítési (commit) e-mail alapértelmezetten opt-in (felhasználói jóváhagyást igényel) vagy opt-out (leiratkozós) legyen (alapértelmezetten opt-in).

Tipp

Ez a beállítás csak azokra a felhasználókra vonatkozik, akik nem választottak ki kifejezetten véglegesítési e-mail címet.

Lásd még

PRIVATE_COMMIT_EMAIL_TEMPLATE

Added in version 4.15.

Template to generate a private commit e-mail for a user. Defaults to "{username}@users.noreply.{site_domain}".

It can contain {user_id}, {username}, {site_title}, and {site_domain}.

Üres sztring megadásával letiltható.

Megjegyzés

Using a different commit e-mail is opt-in for users unless configured by PRIVATE_COMMIT_EMAIL_OPT_IN. Users can configure their commit e-mail in the Profil.

PRIVATE_COMMIT_NAME_OPT_IN

Added in version 5.16.

Configures whether the private commit name is opt-in or opt-out (by default it is opt-in).

Tipp

This setting only applies to users which have not explicitly chosen a commit name.

Lásd még

PRIVATE_COMMIT_NAME_TEMPLATE

Added in version 5.16.

Template to generate a private commit name for a user. Defaults to "{site_title} user {user_id}".

It can contain {user_id}, {username}, {site_title}, and {site_domain}.

Üres sztring megadásával letiltható.

Megjegyzés

Using a different commit name is opt-in for users unless configured by PRIVATE_COMMIT_NAME_OPT_IN. Users can configure their commit name in the Profil.

PROJECT_BACKUP_KEEP_COUNT

Added in version 4.14.

Meghatározza, hogy projektenként hány biztonsági mentést tároljon a szerver. Alapértelmezett érték: 3.

Lásd még

Projektszintű biztonsági mentések

PROJECT_BACKUP_KEEP_DAYS

Added in version 4.14.

Meghatározza, hogy mennyi ideig őrizze meg a projektbiztonsági mentéseket a szerver. Alapértelmezett érték: 30 nap.

Lásd még

Projektszintű biztonsági mentések

PROJECT_BACKUP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Configures the maximum size, in bytes, for uploaded project backup ZIP files. Defaults to 536870912 bytes (512 MiB).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE environment variable. Docker setups can also be constrained by CLIENT_MAX_BODY_SIZE; other deployments can be constrained by their reverse proxy request body-size limit.

Lásd még

Projektszintű biztonsági mentések

PROJECT_BACKUP_IMPORT_MAX_MEMBERS

Added in version 5.17.

Defines the maximum number of ZIP entries allowed when importing a project backup.

This is a safeguard against malformed or intentionally fragmented archives. Defaults to 100000 entries.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS environment variable.

Lásd még

Projektszintű biztonsági mentések

PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE

Added in version 5.17.1.

Defines the maximum total uncompressed size, in bytes, for ZIP entries in an imported project backup. Defaults to 536870912 bytes (512 MiB).

This limits archives that are small when uploaded but expand to much more data during validation or restore.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE environment variable.

Lásd még

Projektszintű biztonsági mentések

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE

Added in version 5.17.

Defines the maximum uncompressed size, in bytes, for a single highly compressed ZIP entry in an imported project backup.

This limit is only applied to entries that are large enough and compress enough to look suspicious. Large low-compression files are intentionally allowed here and are expected to be constrained by the HTTP upload limit. Defaults to 262144000 bytes (250 MiB).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE environment variable.

Lásd még

Projektszintű biztonsági mentések

PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE

Added in version 5.17.

Defines the minimum uncompressed size, in bytes, at which Weblate starts considering the ZIP compression ratio during project backup import.

Smaller files are ignored for the compression-ratio-based validation to avoid rejecting reasonably sized files that compress well. Defaults to 1048576 bytes (1 MiB).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE environment variable.

Lásd még

Projektszintű biztonsági mentések

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO

Added in version 5.17.

Defines the maximum allowed ratio between the uncompressed and compressed size for a large ZIP entry during project backup import.

This is used together with PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE and PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE to detect suspiciously compressed entries while still allowing large repository pack files and other low-compression content. Defaults to 250.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO environment variable.

Lásd még

Projektszintű biztonsági mentések

PROJECT_NAME_RESTRICT_RE

Added in version 4.15.

Reguláris kifejezéssel korlátozható a projektek elnevezése. A szabálynak megfelelő neveket a rendszer elutasítja.

Lásd még

Projekt neve

PROJECT_WEB_RESTRICT_HOST

Added in version 4.16.2.

Meghatározza, hogy mely hosztnevek használatát utasítsa el a projekt weboldal mezőjében. Minden aldomainre is érvényes, például ha example.com szerepel a listában, akkor test.example.com is blokkolva lesz. A listának kisbetűs karaktereket kell tartalmaznia, és az ellenőrzés előtt a domain neveket is kisbetűssé alakítja a rendszer.

Alapértelmezett konfiguráció:

PROJECT_WEB_RESTRICT_HOST = {"localhost"}

Lásd még

PROJECT_WEB_RESTRICT_ALLOWLIST

Added in version 5.17.

Defines a set of project slugs exempt from PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_PRIVATE, and PROJECT_WEB_RESTRICT_RE when validating the project website. Project slugs are matched case-insensitively.

Figyelem

This exemption weakens outbound URL protections for matching projects, including the private-target restriction enforced by PROJECT_WEB_RESTRICT_PRIVATE. Use it only for trusted, administrator-managed projects where bypassing these checks is intentional.

Alapértelmezett konfiguráció:

PROJECT_WEB_RESTRICT_ALLOWLIST = set()

Lásd még

PROJECT_WEB_RESTRICT_NUMERIC

Added in version 4.16.2.

A szám formátumú IP-címek használatának elutasítása a projekt weboldal mezőjében. Alapértelmezés szerint be van kapcsolva.

Lásd még

PROJECT_WEB_RESTRICT_PRIVATE

Added in version 5.17.

Reject using project website and repository browser URLs pointing to internal or non-public addresses. On by default.

Lásd még

PROJECT_WEB_RESTRICT_RE

Added in version 4.15.

Reguláris kifejezéssel korlátozható, hogy milyen URL adható meg a Projekt webhelye mezőben. A szabálynak megfelelő URL-ek el lesznek utasítva.

Lásd még

WEBHOOK_PRIVATE_ALLOWLIST

Added in version 5.17.

Defines hostnames or domains exempt from WEBHOOK_RESTRICT_PRIVATE for outbound webhook delivery. Entries follow Django host matching semantics, so values such as hooks.internal.example or .internal.example can be used.

Alapértelmezett konfiguráció:

WEBHOOK_PRIVATE_ALLOWLIST = []

Lásd még

WEBHOOK_RESTRICT_PRIVATE

Added in version 5.17.

Reject webhook URLs pointing to internal or non-public addresses unless the target host is included in WEBHOOK_PRIVATE_ALLOWLIST. On by default.

When enabled, hostnames that cannot be resolved during validation are rejected unless they are explicitly included in WEBHOOK_PRIVATE_ALLOWLIST.

Lásd még

PUBLIC_ENGAGE

Added in version 5.16.2.

Allows public engage page even with REQUIRE_LOGIN.

Lásd még

RATELIMIT_NOTIFICATION_LIMITS

Added in version 5.14.

Limits how many notifications for a single user will be sent out.

The default setting is:

# Multi-level rate limiting for email notifications
# Each tuple contains (max_emails, time_window_seconds)
RATELIMIT_NOTIFICATION_LIMITS = [
    # Prevent burst sends - 3 emails per 2 minutes
    (3, 120),
    # Equalize to avoid getting blocked for too long - 10 emails per hour
    (10, 3600),
    # Daily limit: 50 emails per day
    (50, 86400),
]

RATELIMIT_ATTEMPTS

A hitelesítési kísérletek maximális száma a korlátozás (rate limiting) alkalmazása előtt.

Alapértelmezett érték: 5.

Lásd még

RATELIMIT_WINDOW

A hitelesítés elfogadásának időtartama a korlátozás alkalmazása után.

Másodpercben megadva, alapértelmezett érték: 300 másodperc (5 perc).

Lásd még

RATELIMIT_LOCKOUT

A hitelesítés zárolásának időtartama a korlátozás alkalmazása után.

Másodpercben megadva, alapértelmezett érték: 600 másodperc (10 perc).

Lásd még

REGISTRATION_ALLOW_BACKENDS

Added in version 4.1.

Azon hitelesítési háttérrendszerek (backends) listája, amelyekből új regisztráció engedélyezett. Ez csak az új regisztrációkat korlátozza, a meglévő felhasználók továbbra is használhatják a már beállított hitelesítési módokat.

Ajánlott a REGISTRATION_OPEN beállítást bekapcsolva hagyni a hitelesítési háttérrendszerek korlátozása mellett, különben a regisztráció technikailag lehetséges marad, de nem lesznek láthatók a regisztrációs linkek a felhasználói felületen.

Példa:

REGISTRATION_ALLOW_BACKENDS = ["azuread-oauth2", "azuread-tenant-oauth2"]

Tipp

A háttérrendszer nevei megegyeznek az azonosításhoz (hitelesítéshez) használt URL-ben szereplő nevekkel.

Lásd még

REGISTRATION_CAPTCHA

Új fiókok regisztrációjának CAPTCHA védelemmel való ellátása. Alapértelmezetten be van kapcsolva.

If turned on, a CAPTCHA is added to all pages where a user enters their e-mail address:

  • Új fiók regisztrációja.

  • Jelszó-visszaállítás.

  • E-mail cím hozzáadása egy fiókhoz.

  • Kapcsolatfelvételi űrlap nem bejelentkezett felhasználók számára.

A védelem jelenleg az alábbi lépésekből áll:

REGISTRATION_EMAIL_MATCH

Lehetővé teszi, hogy szűrje, milyen e-mail címekről lehet regisztrálni.

Alapértelmezett érték: .*, ami bármilyen e-mail cím regisztrációját engedélyezi.

Használható arra is, hogy a regisztrációt egyetlen e-mail domainre korlátozza:

REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"

REGISTRATION_ALLOW_DISPOSABLE_EMAILS

Added in version 5.16.1.

Allow registration with disposable e-mail domains. When enabled, the disposable domain blocklist is bypassed. Default is False.

Lásd még

REGISTRATION_OPEN

Meghatározza, hogy az új fiókok regisztrációja jelenleg engedélyezett-e. Alapértelmezés szerint engedélyezett.

Ez a beállítás az e-mail címmel történő beépített hitelesítést, illetve a Python Social Auth használatát érinti (bizonyos háttérrendszereket külön engedélyezhet a REGISTRATION_ALLOW_BACKENDS segítségével).

Megjegyzés

Ha harmadik fél által biztosított hitelesítési módszereket használ, például: LDAP-hitelesítés, akkor csak a regisztrációs űrlapot rejti el, de az új felhasználók továbbra is be tudnak jelentkezni és fiókot tudnak létrehozni.

Lásd még

REGISTRATION_REBIND

Added in version 4.16.

Engedélyezi a hitelesítési háttérrendszerek újrakapcsolását (rebind) meglévő felhasználók esetén. Kapcsolja be ezt az opciót, ha hitelesítési szolgáltatók közötti átállás (migráció) történik.

Megjegyzés

Alapértelmezés szerint ki van kapcsolva, hogy ne lehessen más hitelesítési háttérrendszert hozzáadni egy meglévő fiókhoz. Az újrakapcsolás (rebind) fiókfeltöréshez vezethet, ha több külső hitelesítési háttérrendszert is használ a rendszer.

REPOSITORY_ALERT_THRESHOLD

Added in version 4.0.2.

Küszöbérték az elavult tárolók vagy túl sok változást tartalmazó tárolók figyelmeztetésének aktiválásához. Alapértelmezett érték: 25.

Lásd még

Fordítási összetevő riasztások

REQUIRE_LOGIN

Added in version 4.1.

This enables django.contrib.auth.middleware.LoginRequiredMiddleware and configures REST framework to require authentication for all API endpoints.

A 5.15 verzióban változott: Weblate now relies on Django built-in middleware.

Megjegyzés

Ez megvalósításra került a Mintakonfiguráció példában. Docker használatakor állítsa be a WEBLATE_REQUIRE_LOGIN változót.

SENTRY_DSN

Sentry DSN beállítása a Hibajelentések gyűjtése és teljesítmény monitorozása funkcióhoz.

Lásd még

Django integráció a Sentry-vel

SENTRY_ENVIRONMENT

A Sentry környezetének beállítása. Alapértelmezett érték: devel.

SENTRY_MONITOR_BEAT_TASKS

Added in version 5.13.

Configure whether to monitor Celery Beat tasks with Sentry. Defaults to True.

SENTRY_PROFILES_SAMPLE_RATE

A teljesítményfigyelés mintavételezési arányának beállítása. Állítsa 1-re az összes esemény nyomon követéséhez, 0-ra (alapértelmezett) a követés kikapcsolásához.

Lásd még

Sentry teljesítményfigyelés

SENTRY_SEND_PII

Személyes adatok gyűjtésének engedélyezése Sentry számára. Alapértelmezés szerint ki van kapcsolva.

A 5.7 verzióban változott: Ez alapértelmezés szerint ki van kapcsolva, korábban verziókban alapból be volt kapcsolva.

SENTRY_TRACES_SAMPLE_RATE

A profilfigyelés mintavételezési arányának beállítása. Állítsa 1-re az összes esemény nyomon követéséhez, 0-ra (alapértelmezett) a követés kikapcsolásához.

Lásd még

Sentry profilozás

SIMPLIFY_LANGUAGES

Egyszerű nyelvkódok használata alapértelmezett nyelv/ország kombinációk esetén. Például egy fr_FR fordítás fr nyelvkódot használ majd. Ez általában kívánatos viselkedés, mert egyszerűsíti a nyelvlisták kezelését.

Kapcsolja ki, ha minden nyelvi változathoz külön fordítást szeretne kezelni.

HIDE_SHARED_GLOSSARY_COMPONENTS

Added in version 5.16.

Glossary components are typically shared into other projects to make them available for translation work. When these are visible in the component list of projects that are using them, it can cause confusion or distract translators from the actual components that are meant to be translated.

This is turned off by default, making shared glossary components visible.

SITE_DOMAIN

A webhely domainjének beállítása. Ez szükséges a helyes abszolút linkek előállításához sok helyzetben (például aktiváló e-mailek, értesítések vagy RSS hírcsatornák esetén).

Ha a Weblate nem szabványos porton fut, azt is adja meg itt.

Példák:

# Production site with domain name
SITE_DOMAIN = "weblate.example.com"

# Local development with IP address and port
SITE_DOMAIN = "127.0.0.1:8000"

Megjegyzés

Ez a beállítás csak a domain nevet tartalmazza. A protokoll beállításához (pl. HTTPS engedélyezése és kötelezővé tétele) használja az ENABLE_HTTPS beállítást, az URL módosításához pedig az URL_PREFIX értéket.

Tipp

Docker-konténer esetén a webhely domainje a WEBLATE_ALLOWED_HOSTS változón keresztül van konfigurálva.

Lásd még

SITE_TITLE

A webhely és a kiküldött e-mailek címében megjelenő webhelynév beállítása.

SPECIAL_CHARS

További karakterek hozzáadása a vizuális billentyűzethez, lásd: Vizuális billentyűzet.

Az alapértelmezett érték:

SPECIAL_CHARS = ("\t", "\n", "\u00a0", "…")

SINGLE_PROJECT

A felhasználók közvetlen átirányítása egy projektre vagy összetevőre az vezérlőpult helyett. Beállítható True értékre, hogy csak akkor történjen meg, ha valóban csak egy projekt van a Weblate-ben. Alternatívaként megadható egy projekt URL-azonosító (slug), és ekkor mindig arra irányít át.

Példa:

SINGLE_PROJECT = "test"

SSH_EXTRA_ARGS

Added in version 4.9.

Lehetővé teszi egyéni paraméterek hozzáadását, amikor a Weblate SSH kapcsolatot létesít. Ez hasznos, ha régi titkosítást vagy egyéb nem szabványos jellemzőket használó szerverekhez kell csatlakozni.

Például, ha a Weblate SSH kapcsolata hibával megszakad (Unable to negotiate with legacyhost: no matching key exchange method found. Their offer: diffie-hellman-group1-sha1) (Nem sikerült kulcscsere-módszert egyeztetni), ezt így lehet kezelni:

SSH_EXTRA_ARGS = "-oKexAlgorithms=+diffie-hellman-group1-sha1"

Tipp

A megadott sztringet a shell értékeli ki, ezért ügyeljen rá, hogy minden szóközt és speciális karaktert idézőjelek közé tegyen.

Lásd még

OpenSSH örökölt beállítások

STATUS_URL

Az URL, ahol a Weblate példány állapotjelentése elérhető.

SUPPORT_STATUS_CHECK

Added in version 5.5.

Féléves támogatási státuszellenőrzés és a rendszergazdák adományozási oldalra történő átirányításának letiltása bejelentkezéskor, ha nincs aktív támogatási előfizetés.

Tipp

A Weblate élményének javítása érdekében ajánlott inkább támogatási előfizetést vásárolni és ezzel a Weblate fejlődését segíteni, ahelyett hogy ezt kikapcsolná.

TRANSLATION_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Configures the maximum size, in bytes, for uploaded translation files. Defaults to 50 MB.

In Docker, configure this using the WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE environment variable.

UNUSED_ALERT_DAYS

Added in version 4.17.

Annak beállítása, hogy mikor jelenjen meg az Összetevő használaton kívülinek tűnik figyelmeztetés.

Alapértelmezett érték: 365 nap. 0-ra állítva a funkció kikapcsolható.

UPDATE_LANGUAGES

Added in version 4.3.2.

Szabályozza, hogy az adatbázis migrációja során frissüljön-e a nyelvi adatbázis. Alapértelmezés szerint be van kapcsolva. Ez a beállítás nincs hatással a setuplang parancsra.

Figyelem

Ha ezt kikapcsolja, a nyelvek megjelenítése eltérhet a valóságtól, mivel a Weblate nyelvi definíciói idővel bővülnek, és a nem definiált nyelvkódok nem fognak megjelenni.

Lásd még

Beépített nyelvi definíciók

URL_PREFIX

Ez a beállítás lehetővé teszi, hogy a Weblate egy adott elérési úton fusson (ellenkező esetben a webszerver gyökérkönyvtárából kell futnia).

Megjegyzés

A beállítás használatához a szervert is úgy kell konfigurálni, hogy eltávolítsa ezt az előtagot. WSGI esetében például a WSGIScriptAlias beállítás használható erre.

Tipp

Az előtagot / jellel kell kezdeni.

Példa:

URL_PREFIX = "/translations"

Megjegyzés

Ez a beállítás nem működik a Django beépített szerverével, ilyenkor az urls.py fájlt kell módosítani, hogy tartalmazza az előtagot.

VCS_ALLOW_HOSTS

Added in version 5.15.

A set of hosts to allow when configuring VCS URL. Defaults to an empty set, which does no filtering at all.

When VCS_RESTRICT_PRIVATE is enabled, matching hosts are also exempt from the private-target restriction.

VCS_ALLOW_SCHEMES

Added in version 5.15.

A set of URL schemes to allow when configuring VCS URL. Only https and ssh are allowed by default.

VCS_RESTRICT_PRIVATE

Added in version 5.17.

Reject VCS repository URLs pointing to internal or non-public addresses unless the target host is included in VCS_ALLOW_HOSTS. On by default.

When enabled, hostnames that cannot be resolved during validation are rejected unless they are explicitly included in VCS_ALLOW_HOSTS.

VCS_API_DELAY

Added in version 4.15.1.

Configures minimal delay in seconds between third-party API calls in GitHub módosítási kérelmek (pull request), GitLab egyesítési kérelmek (merge request), Gitea módosítási kérelmek (pull request), Pagure egyesítési kérelmek (merge request), and Azure DevOps egyesítési kérelmek (pull request).

Ez a beállítás korlátozza a Weblate által ezekre a szolgáltatásokra küldött API hívások gyakoriságát, elkerülve a túlterhelést.

Ha a GitHub másodlagos korlátozó mechanizmusa (rate-limiter) miatt tapasztal korlátozást, az érték növelése segíthet.

Alapértelmezett érték: 10 másodperc.

VCS_API_TIMEOUT

Added in version 5.15.

Configures timeout in seconds for third-party API calls such as forking or creating merge requests in GitHub módosítási kérelmek (pull request), GitLab egyesítési kérelmek (merge request), Gitea módosítási kérelmek (pull request), Pagure egyesítési kérelmek (merge request), and Azure DevOps egyesítési kérelmek (pull request).

Alapértelmezett érték: 10 másodperc.

VCS_BACKENDS

Az elérhető VCS (verziókezelő) háttérrendszerek konfigurációja.

Megjegyzés

A Weblate megpróbálja használni az összes olyan háttérrendszert, amelyhez a szükséges eszközök telepítve vannak.

Tipp

Ezzel korlátozhatja az elérhető választási lehetőségeket vagy saját verziókezelő háttérrendszereket adhat hozzá.

VCS_BACKENDS = ("weblate.vcs.git.GitRepository",)

Lásd még

Verziókezelő integráció

VCS_CLONE_DEPTH

Beállítja, milyen mélységű klónozást végezzen a Weblate a tárolók esetén.

Megjegyzés

Jelenleg ezt csak a Git támogatja. Alapértelmezetten a Weblate sekély klónokat készít a tárolókról a gyorsabb klónozás és a lemezterület megtakarítása érdekében. Használatától függően (például egyéni kiegészítők használatakor) érdemes lehet növelni a mélységet, vagy teljesen kikapcsolni a sekély klónozást az érték 0-ra állításával.

Tipp

Ha a feltöltés során ilyen hibát kap: fatal: protocol error: expected old/new/ref, got 'shallow <commit hash>', akkor állítsa a klónozás mélységét 0-ra:

VCS_CLONE_DEPTH = 0

WEBLATE_ADDONS

A használható kiegészítők listája. Ezek használatához az adott fordítási összetevőhöz is engedélyezni kell őket. Alapértelmezésben az összes beépített kiegészítő elérhető. Ha bővíti a listát, érdemes a meglévő kiegészítőket is benne hagyni, például:

WEBLATE_ADDONS = (
    # Built-in add-ons
    "weblate.addons.gettext.GenerateMoAddon",
    "weblate.addons.gettext.UpdateLinguasAddon",
    "weblate.addons.gettext.UpdateConfigureAddon",
    "weblate.addons.gettext.MsgmergeAddon",
    "weblate.addons.gettext.GettextAuthorComments",
    "weblate.addons.cleanup.CleanupAddon",
    "weblate.addons.consistency.LanguageConsistencyAddon",
    "weblate.addons.discovery.DiscoveryAddon",
    "weblate.addons.flags.SourceEditAddon",
    "weblate.addons.flags.TargetEditAddon",
    "weblate.addons.flags.SameEditAddon",
    "weblate.addons.flags.BulkEditAddon",
    "weblate.addons.generate.GenerateFileAddon",
    "weblate.addons.properties.PropertiesSortAddon",
    "weblate.addons.git.GitSquashAddon",
    "weblate.addons.removal.RemoveComments",
    "weblate.addons.removal.RemoveSuggestions",
    "weblate.addons.resx.ResxUpdateAddon",
    "weblate.addons.autotranslate.AutoTranslateAddon",
    "weblate.addons.cdn.CDNJSAddon",
    # Add-on you want to include
    "weblate.addons.example.ExampleAddon",
)

Megjegyzés

A kiegészítő eltávolítása a listából nem távolítja el azt az összetevőkből! Ebben az esetben a Weblate hibát ad. Ezért a listából való eltávolítás előtt minden összetevőből törölje a kiegészítőt.

Lásd még

ADDON_ACTIVITY_LOG_EXPIRY

Added in version 5.6.

Beállítja, hogy mennyi ideig őrizze meg a rendszer a kiegészítők tevékenységi naplóit. Alapértelmezett érték: 180 nap.

WEBLATE_EXPORTERS

Added in version 4.2.

A rendelkezésre álló exportálók listája, amelyekkel különféle fájlformátumokban lehet letölteni fordításokat vagy szójegyzékeket.

Lásd még

Fordítási fájlformátumok

WEBLATE_FORMATS

A használható fájlformátumok listája.

Megjegyzés

Az alapértelmezett lista már tartalmazza a leggyakoribb formátumokat.

Lásd még

Fordítási fájlformátumok

WEBLATE_MACHINERY

Added in version 4.13.

A használható gépi fordító szolgáltatások listája.

Lásd még

WEBLATE_GPG_IDENTITY

A Weblate által a Git véglegesítések aláírására használt azonosító, például:

WEBLATE_GPG_IDENTITY = "Weblate <weblate@example.com>"

A Weblate a GPG kulcstartóban (a DATA_DIR alatti home/.gnupg mappában) keres megfelelő kulcsot. Ha nem talál, automatikusan létrehoz egyet. További információ: Git véglegesítések aláírása GnuPG-vel.

Lásd még

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

WEBSITE_REQUIRED

Meghatározza, hogy a Projekt webhelye kitöltése kötelező legyen-e új projekt létrehozásakor. Alapértelmezés szerint kötelező, ami a nyilvános kiszolgálókhoz ideális.

WEBSITE_ALERTS_ENABLED

Added in version 5.17.

Default: True

Defines whether Weblate should check project website availability and show alerts for unreachable project websites.

When set to False, Weblate will skip website availability checks and will not generate project website alerts. This is useful when:

  • Your websites are behind firewalls that block Weblate’s requests

  • You want to avoid 403/503-type errors from bot protection

  • Project website availability is not a concern for your installation

Lásd még

WEBSITE_REQUIRED

Verziókezelő hitelesítési adatok beállítása

Tipp

Ez a rész a következő hitelesítési változókat írja le: GITHUB_CREDENTIALS, GITLAB_CREDENTIALS, GITEA_CREDENTIALS, PAGURE_CREDENTIALS, BITBUCKETSERVER_CREDENTIALS.

A konfigurációs szótár API-hosztonként meghatározott hitelesítő adatokat tartalmaz. Az API-hoszt eltérhet attól, amit a böngészőben használ, például a GitHub API az api.github.com címen érhető el.

A hitelesítő adatok a Tároló feltöltési URL vagy Forráskód tároló szinten is felülírhatók (ha nincs külön feltöltési (push) URL megadva), ezek előnyt élveznek a konfigurációs fájlban megadottakkal szemben.

Az alábbi beállítások érhetők el minden hoszthoz:

username

API felhasználó megadása (kötelező).

token

API token az API-felhasználóhoz (kötelező).

scheme

Added in version 4.18.

Séma felülírása. A Weblate megpróbálja az URL-ből kinyerni a sémát, ha nem sikerül, a https-t használja. Ha belsőleg futtatja az API szervert, megadhatja az http-t is, de ügyeljen a biztonságra.

Tipp

Docker-konténer esetén a hitelesítő adatokat környezeti változókkal lehet beállítani, lásd: Kódtároló oldalak hitelesítő adatai.