Konfiguration

Alla inställningar sparas i settings.py (som vanligt för Django).

Observera

Efter att ha ändrat någon av dessa inställningar måste du starta om Weblate – både WSGI- och Celery-processerna.

Om det körs som mod_wsgi måste du starta om Apache för att ladda om konfigurationen.

Se även

Se även Djangos dokumentation för parametrar som konfigurerar Django själv.

ADMINS_CONTACT

Konfigurerar vart kontaktformuläret skickar e-postmeddelanden. Om det inte är konfigurerat används e-postadresser från ADMINS.

Konfigurera detta som en lista med e-postadresser:

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

Se även

ALLOWED_ASSET_DOMAINS

Added in version 5.14.

Konfigurerar vilka domäner som är tillåtna för hämtning av tillgångar i Weblate.

Detta förbättrar säkerheten genom att förhindra att tillgångar laddas från opålitliga källor. Tillgångarna laddas ner en gång av Weblate-servern och lagras lokalt, istället för att levereras direkt från externa domäner till användarna.

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.

Den förväntar sig en lista med värd-/domännamn. Du kan använda fullständiga namn (t.ex. www.example.com) eller lägga till en punkt som jokertecken för att matcha alla underdomäner (t.ex. .example.com matchar cdn.example.com eller static.example.com).

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

Exempel

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

Detta används för närvarande på följande platser:

Se även

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 in bytes for fetching or uploading assets into Weblate. Defaults to 10 MB.

Se även

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.

Standardkonfiguration:

ASSET_PRIVATE_ALLOWLIST = []

Se även

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-lokalisering CDN add-on.

Se även

ALTCHA_COST

Added in version 2025.5.

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 2025.5.

Argon2id memory cost in KiB. Defaults to 65536.

ALTCHA_PARALLELISM

Added in version 2025.5.

Argon2id parallelism factor. Defaults to 1.

Se även

ALTCHA Proof of Work Mechanism

ANONYMOUS_USER_NAME

Användarnamn för användare som inte är inloggade.

Se även

Åtkomstkontroll

AUDITLOG_EXPIRY

Det maximala antalet dagar som Weblate sparar granskningsloggar med information om kontoaktiviteten.

Standardinställningen är 180 dagar.

AUTH_LOCK_ATTEMPTS

Maximalt antal misslyckade autentiseringsförsök innan hastighetsbegränsning tillämpas.

Detta tillämpas för närvarande på följande platser:

  • Logga in. Tar bort kontots lösenord, vilket förhindrar användaren från att logga in utan att begära ett nytt lösenord.

  • Återställning av lösenord. Förhindrar att nya e-postmeddelanden skickas, vilket undviker att användare spammades med för många försök att återställa lösenordet.

Standardvärdet är 10.

Se även

Hastighetsbegränsande

AUTO_UPDATE

Uppdaterar alla arkiv dagligen.

Råd

Användbart om du inte använder Aviseringskopplingar för att uppdatera Weblate-arkiv automatiskt.

Observera

On/off-alternativ finns utöver strängval för bakåtkompatibilitet.

Alternativen är:

"none"

Inga dagliga uppdateringar.

"fjärr" också False

Uppdatera endast fjärrkontroller.

"full" även True

Uppdatera fjärrkontroller och slå samman arbetskopian.

Observera

Detta kräver att Bakgrundsuppgifter med Celery fungerar och träder i kraft efter omstart.

AVATAR_URL_PREFIX

Prefix för att skapa avatar-URL:er som: ${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS}. Följande tjänster är kända för att fungera:

Gravatar (standard), enligt https://gravatar.com/

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

Libravatar, enligt https://www.libravatar.org/

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

Se även

AUTH_TOKEN_VALID

Hur länge autentiseringstoken och tillfälligt lösenord från e-postmeddelanden om återställning av lösenord är giltiga. Anges i antal sekunder, standardvärdet är 172800 (2 dagar).

AUTH_PASSWORD_DAYS

Hur många dagar Weblate avvisar återanvändning av ett tidigare använt lösenord för en användare.

Kontrollen baseras på revisionsloggen, AUDITLOG_EXPIRY måste vara minst lika med denna.

Observera

Lösenordsändringar som gjorts före Weblate 2.15 kommer inte att beaktas i denna policy.

Standardinställningen är 180 dagar.

AUTOFIX_LIST

Lista över automatiska korrigeringar som ska tillämpas vid sparande av en sträng.

Observera

Ange en fullständig sökväg till Python-klassen som implementerar autofixer-gränssnittet.

Tillgängliga korrigeringar beskrivs på Automatiska korrigeringar.

Du kan välja vilka du vill använda:

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

Se även

BACKGROUND_TASKS

Added in version 4.5.2.

Definierar hur ofta långvariga underhållsuppgifter ska utlösas för en komponent.

Just nu styr detta:

Möjliga val:

  • månadsvis (detta är standardinställningen)

  • weekly

  • daily

  • never

Observera

Det rekommenderas inte att öka frekvensen när Weblate innehåller tusentals komponenter.

BASIC_LANGUAGES

Added in version 4.4.

Lista över språk som användarna kan välja för att påbörja en ny översättning. Om inget anges används en inbyggd lista (som innehåller alla vanliga språk, men utan landsspecifika varianter).

Detta begränsar endast icke-privilegierade användare från att lägga till oönskade språk. Projektadministratörer har fortfarande tillgång till hela urvalet av språk som definierats i Weblate.

Observera

Detta definierar inte nya språk för Weblate — det filtrerar endast befintliga språk i databasen.

Exempel:

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

Se även

Språkliga definitioner

BORG_EXTRA_ARGS

Added in version 4.9.

Du kan skicka ytterligare argument till borg create när inbyggda säkerhetskopior aktiveras.

Exempel:

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

Se även

CACHE_DIR

Added in version 4.16.

Katalog där Weblate lagrar cachefiler. Standardinställningen är cache-underkatalogen i DATA_DIR.

Ändra detta till lokalt eller tillfälligt filsystem om DATA_DIR finns på ett nätverksfilsystem.

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.

Docker-containern använder en separat volym för detta, se Docker-containervolymer.

Följande underkataloger finns vanligtvis:

ssh

Generated helper files used for VCS access.

fonts

font-config cache för Hantera teckensnitt.

avatar

Cachade användaravatarer, se Avatarer.

static

Standardplats för statiska Django-filer, angiven av STATIC_ROOT. Se Servering av statiska filer.

tesseract

OCR-tränade data för Screenshots and visual context.

CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC

Anpassa Content-Security-Policy-rubriken för Weblate. Rubriken genereras automatiskt baserat på aktiverade integrationer med tredjepartstjänster (Matomo, Google Analytics, Sentry, …).

Alla dessa är som standard inställda på en tom lista.

Exempel:

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

Se även

CHECK_LIST

Lista över kvalitetskontroller som ska utföras på en översättning.

Observera

Ange en fullständig sökväg till Python-klassen som implementerar kontrollgränssnittet.

Justera listan med kontroller så att den innehåller de som är relevanta för dig.

Alla inbyggda Kvalitetskontroller är aktiverade som standard, och du kan ändra dessa inställningar där. Som standard är de kommenterade i Exempel på konfiguration så att standardvärdena används. Nya kontroller utförs sedan för varje ny version av Weblate.

Du kan stänga av alla kontroller:

CHECK_LIST = ()

Du kan bara aktivera några få:

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

Observera

Ändring av denna inställning påverkar endast nyändrade översättningar. Befintliga kontroller kommer fortfarande att lagras i databasen. För att även tillämpa ändringarna på de lagrade översättningarna, kör updatechecks.

Se även

COMMIT_PENDING_HOURS

Antal timmar mellan att bekräfta väntande ändringar genom bakgrundsuppgiften.

Se även

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.

Se även

CONTACT_FORM

Added in version 4.6.

Konfigurerar hur e-post från kontaktformuläret skickas. Välj en konfiguration som matchar konfigurationen för din e-postserver.

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

Inaktiverar kontaktformuläret helt.

Added in version 5.15.

Se även

ADMINS_CONTACT

DATA_DIR

Mappen där Weblate lagrar all data. Den innehåller länkar till VCS-arkiv, ett fulltextindex och olika konfigurationsfiler för externa verktyg.

Följande underkataloger finns vanligtvis:

home

Hemkatalog som används för att anropa skript.

ssh

SSH-nycklar och konfiguration.

media

Standardplats för Django-mediefiler, angiven av MEDIA_ROOT. Innehåller uppladdade skärmdumpar, se Screenshots and visual context.

vcs

Versionskontrollförvar för översättningar.

backups

Daglig säkerhetskopiering av data. Se Dumpade data för säkerhetskopior för mer information.

fonts:

Användaruppladdade teckensnitt, se Hantera teckensnitt.

cache

Olika cacher. Kan placeras på annan plats med hjälp av CACHE_DIR.

Docker-containern använder en separat volym för detta, se Docker-containervolymer.

Observera

Denna katalog måste vara skrivbar av Weblate. Att köra den som WSGI innebär att användaren www-data bör ha skrivbehörighet till den.

Det enklaste sättet att uppnå detta är att göra användaren till ägare av katalogen:

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

Standardinställningen är /home/weblate/data, men det förväntas att den konfigureras.

Se även

DATABASE_BACKUP

Om databasbackuperna ska lagras som ren text, komprimeras eller hoppas över. De godkända värdena är:

  • "plain"

  • "compressed"

  • "none"

Se även

Säkerhetskopiera och flytta Weblate

DEFAULT_ACCESS_CONTROL

Standardinställningen för åtkomstkontroll för nya projekt:

0

Offentlig

1

Skyddad

100

Privat

200

Anpassad

Använd Custom om du hanterar ACL manuellt, vilket innebär att du inte förlitar dig på den interna Weblate-hanteringen.

Se även

DEFAULT_AUTO_WATCH

Added in version 4.5.

Konfigurerar om Automatiskt bevaka projekt vid bidrag ska vara aktiverat för nya användare. Standardinställningen är True.

Se även

Aviseringar

DEFAULT_RESTRICTED_COMPONENT

Added in version 4.1.

Standardvärdet för komponentbegränsning.

Se även

DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE

Standardbekräftelsemeddelanden för olika åtgärder, se Komponentkonfiguration för mer information.

The built-in defaults follow Conventional Commits and include Weblate links where available. Changing these settings affects newly created defaults; existing message templates can be reset in the settings forms with Restore site default. For inherited values, restoring the site default also disables inheritance for that message.

Se även

DEFAULT_ADDONS

Standardtillägg som ska installeras för varje skapad komponent.

Observera

Denna inställning påverkar endast nyskapade komponenter.

Exempel:

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

Se även

DEFAULT_COMMITER_EMAIL

Committer-e-postadress, standardinställningen är noreply@weblate.org.

Se även

DEFAULT_COMMITER_NAME

DEFAULT_COMMITER_NAME

Committer-namn, standardvärdet är Weblate.

Se även

DEFAULT_COMMITER_EMAIL

DEFAULT_LANGUAGE

Added in version 4.3.2.

Källspråk för alla nya komponenter.

Standardvärdet är en. Det matchande språkområdet måste finnas i databasen.

Se även

DEFAULT_MERGE_STYLE

Sammanslagningsstil för alla nya komponenter.

  • rebase - standard

  • merge

Se även

DEFAULT_SHARED_TM

Konfigurerar standardvärdet för Använd delat översättningsminne och Bidra till det delade översättningsminnet.

DEFAULT_TRANSLATION_REVIEW

Added in version 5.16.

Configures the default value for Aktivera granskare, turned off by default.

DEFAULT_SOURCE_REVIEW

Added in version 5.16.

Configures the default value for Aktivera källgranskningar, turned off by default.

DEFAULT_AUTOCLEAN_TM

Added in version 5.13.

Konfigurerar standardvärdet för Automatisk rensning av översättningsminne.

DEFAULT_TRANSLATION_PROPAGATION

Standardinställning för översättningsspridning, standardvärdet är True.

Se även

DEFAULT_PULL_MESSAGE

Konfigurerar standardtitel och meddelande för pull-förfrågningar.

The built-in default follows Conventional Commits and includes Weblate links and translation status.

ENABLE_AVATARS

Om Gravatar-baserade avatarer ska aktiveras för användare. Aktiverat som standard.

Avatarer hämtas och cachelagras på servern, vilket minskar risken för läckage av privat information och snabbar upp användarupplevelsen.

Se även

ENABLE_HOOKS

Om anonyma fjärrkopplingar ska aktiveras.

Se även

Aviseringskopplingar

ENABLE_HTTPS

Förändrat i version 5.7: Weblate kräver nu https för stöd för WebAuthn.

Om länkar till Weblate ska skickas som HTTPS eller HTTP. Denna inställning påverkar skickade e-postmeddelanden och genererade absoluta URL:er.

I standardkonfigurationen används detta också för flera Django-inställningar relaterade till HTTPS — det aktiverar säkra cookies, växlar HSTS eller aktiverar omdirigering till en HTTPS-URL.

HTTPS-omdirigering kan vara problematisk i vissa fall och du kan stöta på problem med oändlig omdirigering om du använder en omvänd proxy som utför SSL-terminering som inte korrekt vidarebefordrar protokollhuvuden till Django. Justera din omvända proxykonfiguration så att den skickar X-Forwarded-Proto- eller Forwarded-huvuden, eller konfigurera SECURE_PROXY_SSL_HEADER så att Django korrekt kan upptäcka SSL-statusen.

Om detta är inaktiverat kommer Weblate inte att kunna starta och ett felmeddelande med texten otp_webauthn.E031 visas. Du kan dämpa detta felmeddelande genom att lägga till det i SILENCED_SYSTEM_CHECKS, men WebAuthn kommer fortfarande inte att fungera för webbplatser utan HTTPS.

Se även

ENABLE_SHARING

Aktivera/inaktivera menyn Community så att användare kan dela översättningsframsteg på sociala nätverk.

Se även

Bygga upp översättningsgemenskapen

EXTRA_HTML_HEAD

Added in version 4.15.

Infoga ytterligare markeringar i HTML-rubriken. Kan användas för verifiering av webbplatsägande, till exempel:

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

Varning

Strängen saneras inte. Den infogas som den är i HTML-rubriken.

GET_HELP_URL

Added in version 4.5.2.

URL där support för din Weblate-instans finns.

GITEA_CREDENTIALS

Added in version 4.12.

Lista över inloggningsuppgifter för Gitea-servrar.

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

Konfigurationsordlistan består av autentiseringsuppgifter som definieras för varje API-värd. Layouten är densamma för nästan alla versionshanteringsintegrationer och beskrivs i Konfigurera autentiseringsuppgifter för versionshantering.

Se även

GITLAB_CREDENTIALS

Added in version 4.3.

Lista över autentiseringsuppgifter för GitLab-servrar.

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

Observera

Den personliga åtkomsttoken behöver api-omfånget för att kunna använda API:et.

Konfigurationsordlistan består av autentiseringsuppgifter som definieras för varje API-värd. Layouten är densamma för nästan alla versionshanteringsintegrationer och beskrivs i Konfigurera autentiseringsuppgifter för versionshantering.

Se även

GITHUB_CREDENTIALS

Added in version 4.3.

Lista över autentiseringsuppgifter för GitHub-servrar.

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

Observera

Det är möjligt att använda både finfördelade personliga åtkomsttoken och klassiska personliga åtkomsttoken. De finfördelade token är begränsade till en enda organisation, så det fungerar inte om du vill att Weblate ska förgrena ett arkiv utanför organisationen (vanligtvis till användarens namnområde).

För att klona, pusha och skapa pull-förfrågningar krävs läs- och skrivbehörighet till Contents och Pull requests.

Administration kan också vara nödvändigt för att förgrena ett arkiv om du avser att använda förgrening och det ursprungliga arkivet inte är offentligt.

Råd

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

Konfigurationsordlistan består av autentiseringsuppgifter som definieras för varje API-värd. Layouten är densamma för nästan alla versionshanteringsintegrationer och beskrivs i Konfigurera autentiseringsuppgifter för versionshantering.

Se även

BITBUCKETSERVER_CREDENTIALS

Added in version 4.16.

Lista över autentiseringsuppgifter för Bitbucket Data Center.

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

Konfigurationsordlistan består av autentiseringsuppgifter som definieras för varje API-värd. Layouten är densamma för nästan alla versionshanteringsintegrationer och beskrivs i Konfigurera autentiseringsuppgifter för versionshantering.

Se även

BITBUCKETCLOUD_CREDENTIALS

Added in version 5.8.

Lista över autentiseringsuppgifter för Bitbucket Cloud-servrar.

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

Konfigurationsordlistan består av autentiseringsuppgifter som definieras för varje API-värd. API-värden kan skilja sig från den du använder i webbläsaren, till exempel nås GitHub API som api.github.com.

Följande konfiguration är tillgänglig för varje värd:

username

API-användare.

workspace

Användarens arbetsytaslugg.

token

API-token med behörigheten pullrequest:write.

Ytterligare inställningar som inte beskrivs här finns på Konfigurera autentiseringsuppgifter för versionshantering.

Se även

AZURE_DEVOPS_CREDENTIALS

Added in version 5.2.

Lista över autentiseringsuppgifter för Azure DevOps-servrar.

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

Konfigurationsordlistan består av autentiseringsuppgifter som definieras för varje API-värd. API-värden kan skilja sig från den du använder i webbläsaren, till exempel nås GitHub API som api.github.com.

Följande konfiguration är tillgänglig för varje värd:

username

Namnet på Azure DevOps-projektet. Detta är inte namnet på arkivet.

organization

Projektets organisationsnamn.

workItemIds

En valfri lista med ID-nummer för arbetsuppgifter från din organisation. När dessa anges kommer nya pull-förfrågningar att ha dessa bifogade.

token

API-token för API-användaren, krävs.

Ytterligare inställningar som inte beskrivs här finns på Konfigurera autentiseringsuppgifter för versionshantering.

Se även

GOOGLE_ANALYTICS_ID

Google Analytics-ID för att aktivera övervakning av Weblate med Google Universal Analytics.

Observera

Google Analytics 4-integration är för närvarande inte tillgänglig för Weblate, se https://github.com/WeblateOrg/weblate/issues/14015.

HIDE_REPO_CREDENTIALS

Dölj autentiseringsuppgifter för arkivet från webbgränssnittet. Om du har en arkiv-URL med användarnamn och lösenord kommer Weblate att dölja den när relaterad information visas för användarna.

Till exempel, istället för https://användare:lösenord@git.example.com/repo.git visas bara https://git.example.com/repo.git. Det försöker också rensa upp VCS-felmeddelanden på ett liknande sätt.

Observera

På som standard.

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.

Observera

The default is show.

HIDE_VERSION

Added in version 4.3.1.

Ersatt sedan version 5.17.

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

IP_BEHIND_REVERSE_PROXY

Anger om Weblate körs bakom en omvänd proxy.

Om inställt på True hämtar Weblate IP-adressen från en rubrik definierad av IP_PROXY_HEADER.

Varning

Se till att du verkligen använder en omvänd proxy och att den ställer in denna rubrik, annars kommer användarna att kunna förfalska IP-adressen.

Observera

Detta är inte aktiverat som standard.

Se även

IP_PROXY_HEADER

Anger vilken rubrik Weblate ska hämta IP-adressen från när IP_BEHIND_REVERSE_PROXY är aktiverat.

Standardvärdet är HTTP_X_FORWARDED_FOR.

Se även

IP_PROXY_OFFSET

Förändrat i version 5.0.1: Standardvärdet ändrades från 1 till -1.

Anger vilken del av IP_PROXY_HEADER som används som klientens IP-adress.

Beroende på din konfiguration kan denna rubrik bestå av flera IP-adresser (till exempel X-Forwarded-For: client-ip, proxy-a, proxy-b) och du kan här konfigurera vilken adress från rubriken som ska användas som klientens IP-adress.

Varning

Denna inställning påverkar säkerheten för din installation. Du bör endast konfigurera den för att använda betrodda proxyservrar för att fastställa IP-adressen. Se <https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns> för mer information.

Standardvärdet är -1.

Se även

LICENSE_EXTRA

Ytterligare licenser som ska inkluderas i licensvalen.

Observera

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.

Till exempel:

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

Förändrat i version 4.3: Om du ställer in detta på tomt värde inaktiveras licensvarningen.

Filtrera listan över licenser som ska visas. Detta inaktiverar också licensvarningen när den är tom.

Observera

Detta filter använder de korta licensnamnen.

Till exempel:

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

Följande inaktiverar licensvarningen:

LICENSE_FILTER = set()

Se även

Translation component diagnostics

LICENSE_REQUIRED

Definierar om licensattributet i Komponentkonfiguration är obligatoriskt.

Observera

Detta är avstängt som standard.

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH

Om längden på en given översättning ska begränsas. Begränsningen är längden på källsträngen × 10 tecken.

Råd

Ställ in detta på False för att tillåta längre översättningar (upp till 10 000 tecken) oavsett källsträngens längd.

Observera

Standardvärdet är True.

LOCALIZE_CDN_URL och LOCALIZE_CDN_PATH

These settings configure the CDN add-ons, including JavaScript-lokalisering 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 Lokalisering CDN for secure serving guidance.

Råd

På Hosted Weblate används https://weblate-cdn.com/.

Se även

MATOMO_SITE_ID

ID för webbplatsen i Matomo (tidigare Piwik) som du vill använda för att spåra Weblate.

Observera

Denna integration stöder inte Matomo Tag Manager.

Se även

MATOMO_URL

MATOMO_URL

Fullständig URL (inklusive avslutande snedstreck) till en Matomo-installation (tidigare Piwik) som du vill använda för att spåra användningen av Weblate. Se <https://matomo.org/> för mer information.

Råd

Denna integration stöder inte Matomo Tag Manager.

Till exempel:

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

Se även

MATOMO_SITE_ID

NEARBY_MESSAGES

Antal närliggande strängar som visas i varje riktning i fullständiga editorn.

Detta är bara ett standardvärde, användare kan justera detta i Användarprofil.

DEFAULT_PAGE_LIMIT

Added in version 4.7.

Standardantal element som ska visas när paginering är aktiv.

PAGURE_CREDENTIALS

Added in version 4.3.2.

Lista över autentiseringsuppgifter för Pagure-servrar.

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

Konfigurationsordlistan består av autentiseringsuppgifter som definieras för varje API-värd. Layouten är densamma för nästan alla versionshanteringsintegrationer och beskrivs i Konfigurera autentiseringsuppgifter för versionshantering.

Se även

PASSWORD_MINIMAL_STRENGTH

Added in version 5.10.2.

Minimalt lösenordsbetyg enligt bedömningen av lösenordsstyrkan med zxcvbn.

Standardvärdet är 0, vilket innebär att styrkekontrollen är inaktiverad.

Se även

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.

URL där din Weblate-instans visar sin integritetspolicy.

Råd

Useful if you host your privacy policy outside Weblate instead of using the Juridisk modul module. When the legal module is enabled, Weblate links to the internal legal pages by default.

Exempel:

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

Se även

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN

Added in version 4.15.

Konfigurerar om den privata commit-e-posten är opt-in eller opt-out (standard är opt-in).

Råd

Denna inställning gäller endast användare som inte uttryckligen har valt ett e-postmeddelande för bekräftelse.

Se även

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}.

Ställ in på tom sträng för att inaktivera.

Observera

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).

Råd

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

Se även

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}.

Ställ in på tom sträng för att inaktivera.

Observera

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.

Anger hur många säkerhetskopior per projekt som sparas på servern. Standardvärdet är 3.

Se även

Säkerhetskopior på projektnivå

PROJECT_BACKUP_KEEP_DAYS

Added in version 4.14.

Anger hur länge projektets säkerhetskopior ska sparas på servern. Standardinställningen är 30 dagar.

Se även

Säkerhetskopior på projektnivå

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.

Se även

Säkerhetskopior på projektnivå

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.

Se även

Säkerhetskopior på projektnivå

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.

Se även

Säkerhetskopior på projektnivå

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.

Se även

Säkerhetskopior på projektnivå

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.

Se även

Säkerhetskopior på projektnivå

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.

Se även

Säkerhetskopior på projektnivå

PROJECT_NAME_RESTRICT_RE

Added in version 4.15.

Definierar ett reguljärt uttryck för att begränsa projektnamngivningen. Alla matchande namn kommer att avvisas.

Se även

Projektnamn

PROJECT_WEB_RESTRICT_HOST

Added in version 4.16.2.

Avvisa användning av vissa värdar på projektets webbplats. Alla underdomäner matchas, så om du inkluderar example.com blockeras även test.example.com. Listan ska endast innehålla strängar med små bokstäver, eftersom den analyserade domänen omvandlas till små bokstäver innan matchningen.

Standardkonfiguration:

PROJECT_WEB_RESTRICT_HOST = {"localhost"}

Se även

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.

Varning

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.

Standardkonfiguration:

PROJECT_WEB_RESTRICT_ALLOWLIST = set()

Se även

PROJECT_WEB_RESTRICT_NUMERIC

Added in version 4.16.2.

Avvisa användning av numerisk IP-adress på projektets webbplats. Aktiverat som standard.

Se även

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.

Se även

PROJECT_WEB_RESTRICT_RE

Added in version 4.15.

Definierar ett reguljärt uttryck för att begränsa vad som kan anges som Projektwebbplats. Alla matchande URL:er kommer att avvisas.

Se även

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.

Standardkonfiguration:

WEBHOOK_PRIVATE_ALLOWLIST = []

Se även

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.

Se även

PUBLIC_ENGAGE

Added in version 5.16.2.

Allows public engage page even with REQUIRE_LOGIN.

Se även

RATELIMIT_NOTIFICATION_LIMITS

Added in version 5.14.

Begränsar hur många aviseringar som skickas ut till en enskild användare.

Standardinställningen är:

# 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

Maximalt antal autentiseringsförsök innan hastighetsbegränsning tillämpas.

Standardvärdet är 5.

Se även

RATELIMIT_WINDOW

Hur länge autentisering accepteras efter att hastighetsbegränsningen har trätt i kraft.

Ett antal sekunder, standardvärdet är 300 (5 minuter).

Se även

RATELIMIT_LOCKOUT

Hur länge autentiseringen är låst efter att hastighetsbegränsningen har tillämpats.

Ett antal sekunder som standard är 600 (10 minuter).

Se även

REGISTRATION_ALLOW_BACKENDS

Added in version 4.1.

Lista över autentiseringsbackends som tillåter registrering. Detta begränsar endast nya registreringar, användare kan fortfarande autentisera sig och lägga till autentisering med alla konfigurerade autentiseringsbackends.

Det rekommenderas att hålla REGISTRATION_OPEN aktiverat samtidigt som man begränsar registreringsbackends, annars kommer användarna att kunna registrera sig, men Weblate kommer inte att visa länkar för registrering i användargränssnittet.

Exempel:

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

Råd

Backend-namnen matchar namnen som används i URL:en för autentisering.

Se även

REGISTRATION_CAPTCHA

Om registrering av nya konton skyddas av CAPTCHA. Standardinställningen är aktiverad.

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

  • Registrering av nytt konto.

  • Återställning av lösenord.

  • Lägga till e-post till ett konto.

  • Kontaktformulär för användare som inte är inloggade.

Skyddet består för närvarande av följande steg:

REGISTRATION_EMAIL_MATCH

Låter dig filtrera vilka e-postadresser som kan registreras.

Standardinställningen är .*, vilket innebär att alla e-postadresser kan registreras.

Du kan använda den för att begränsa registreringen till en enda e-postdomän:

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.

Se även

REGISTRATION_OPEN

Om registrering av nya konton för närvarande är tillåtet. Standardinställningen är aktiverat.

Denna inställning påverkar inbyggd autentisering via e-postadress eller genom Python Social Auth (du kan tillåta vissa back-ends med REGISTRATION_ALLOW_BACKENDS).

Observera

Om du använder autentiseringsmetoder från tredje part, såsom Autentisering med LDAP, döljs bara registreringsformuläret, men nya användare kan fortfarande logga in och skapa konton.

Se även

REGISTRATION_REBIND

Added in version 4.16.

Tillåt ombindning av autentiseringsbackends för befintliga användare. Aktivera detta när du migrerar mellan autentiseringsleverantörer.

Observera

Som standard är funktionen inaktiverad för att förhindra att andra autentiseringsbackends läggs till ett befintligt konto. Omkoppling kan leda till att kontot komprometteras när fler autentiseringsbackends från tredje part används.

REPOSITORY_ALERT_THRESHOLD

Added in version 4.0.2.

Tröskelvärde för att utlösa en varning för föråldrade arkiv eller arkiv som innehåller för många ändringar. Standardvärdet är 25.

Se även

Translation component diagnostics

REQUIRE_LOGIN

Added in version 4.1.

Detta aktiverar django.contrib.auth.middleware.LoginRequiredMiddleware och konfigurerar REST-ramverket så att autentisering krävs för alla API-ändpunkter.

Förändrat i version 5.15: Weblate använder nu Djangos inbyggda mellanprogramvara.

Observera

Detta implementeras i Exempel på konfiguration. För Docker, använd WEBLATE_REQUIRE_LOGIN.

GOOGLE_CLOUD_ERROR_REPORTING

Configuration for Insamling av felrapporter och övervakning av prestanda using Google Cloud Error Reporting. Set to None to disable the integration, or set to a dictionary of keyword arguments for the Google Cloud Error Reporting client.

Weblate automatically supplies service as weblate and version as the current Weblate version or Git revision. Explicit values in the dictionary override these defaults.

OPENTELEMETRY_ENABLED

Added in version 2026.6.

Enable backend tracing using OpenTelemetry. Disabled by default.

Traces are exported only when this is enabled and OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT is configured.

OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT

OTLP HTTP traces endpoint for OpenTelemetry, for example https://collector.example.com/v1/traces.

OPENTELEMETRY_EXPORTER_OTLP_HEADERS

Additional HTTP headers for the OpenTelemetry OTLP exporter. Defaults to an empty dictionary.

OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES

Additional OpenTelemetry resource attributes. Defaults to an empty dictionary.

OPENTELEMETRY_SERVICE_NAME

OpenTelemetry service name. Defaults to weblate.

OPENTELEMETRY_TRACES_SAMPLE_RATE

Configure sampling rate for OpenTelemetry traces. Set to 1 to trace all events, 0 (the default) disables tracing.

SENTRY_DSN

Sentry DSN att använda för Insamling av felrapporter och övervakning av prestanda.

Se även

Django-integration för Sentry

SENTRY_ENVIRONMENT

Konfigurerar miljön för Sentry. Standardinställningen är devel.

SENTRY_MONITOR_BEAT_TASKS

Added in version 5.13.

Konfigurera om Celery Beat-uppgifter ska övervakas med Sentry. Standardinställningen är True.

SENTRY_PROFILES_SAMPLE_RATE

Configure sampling rate for performance monitoring. Set to 1 to profile all traced events (the default), 0 disables profiling.

Se även

Sentry Performance Monitoring

SENTRY_SEND_PII

Tillåt Sentry att samla in viss personlig identifierbar information. Avstängt som standard.

Förändrat i version 5.7: Detta är nu avstängt som standard, men var tidigare påslaget som standard.

SENTRY_TRACES_SAMPLE_RATE

Konfigurera samplingsfrekvens för profilövervakning. Ställ in på 1 för att spåra alla händelser, 0 (standard) inaktiverar spårning.

Se även

Sentry Profiling

SIMPLIFY_LANGUAGES

Använd enkla språkkoder för standardkombinationer av språk och land. Till exempel kommer en översättning av fr_FR att använda språkkoden fr. Detta är vanligtvis önskvärt, eftersom det förenklar listningen av språk för dessa standardkombinationer.

Stäng av denna funktion om du vill ha olika översättningar för varje variant.

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

Konfigurerar webbplatsdomänen. Nödvändigt för att skapa korrekta absoluta länkar i många sammanhang (till exempel aktiveringsmejl, aviseringar eller RSS-flöden).

Om Weblate körs på en icke-standardport, ange den också här.

Exempel:

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

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

Observera

Denna inställning ska endast innehålla domännamnet. För att konfigurera protokollet (aktivera och tillämpa HTTPS) använd ENABLE_HTTPS och för att ändra URL:en använd URL_PREFIX.

Råd

På en Docker-container konfigureras webbplatsdomänen via WEBLATE_ALLOWED_HOSTS.

Se även

SITE_TITLE

Webbplatsens titel som ska användas för webbplatsen och skickade e-postmeddelanden.

SPECIAL_CHARS

Ytterligare tecken som ska inkluderas i det visuella tangentbordet, Visuellt tangentbord.

Standardvärdet är:

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

SINGLE_PROJECT

Omdirigerar användare direkt till ett projekt eller en komponent istället för att visa instrumentpanelen. Du kan antingen ställa in den på True så att den bara fungerar om det faktiskt bara finns ett enda projekt i Weblate. Alternativt kan du ställa in projektets slug, och då kommer den att omdirigera villkorslöst till detta projekt.

Exempel:

SINGLE_PROJECT = "test"

SSH_EXTRA_ARGS

Added in version 4.9.

Gör det möjligt att lägga till anpassade parametrar när Weblate anropar SSH. Användbart vid anslutning till servrar som använder äldre kryptering eller andra icke-standardfunktioner.

Om till exempel SSH-anslutningen i Weblate misslyckas med Unable to negotiate with legacyhost: no matching key exchange method found. Their offer: diffie-hellman-group1-sha1, kan du aktivera det med:

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

Råd

Strängen utvärderas av skalet, så se till att alla blanktecken och specialtecken är inom citationstecken.

Se även

OpenSSH Legacy Options

STATUS_URL

Den URL där din Weblate-instans rapporterar sin status.

SUPPORT_STATUS_CHECK

Added in version 5.5.

Inaktiverar halvårlig kontroll av supportstatus och omdirigering av superanvändare vid inloggning till donationssidan om det inte finns något aktivt supportabonnemang.

Råd

Förbättra din upplevelse av Weblate genom att köpa ett supportabonnemang och påskynda utvecklingen av Weblate istället för att stänga av den här funktionen.

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.

Konfigurerar när varningen Komponenten verkar oanvänd utlöses.

Standardinställningen är 365 dagar. Ställ in på 0 för att stänga av funktionen.

UPDATE_LANGUAGES

Added in version 4.3.2.

Styr om språkdatabasen ska uppdateras när databasmigrering körs och är aktiverad som standard. Denna inställning har ingen inverkan på anropet av setuplang.

Varning

Språkinformationen kan bli inkonsekvent på grund av detta. Weblates språkinformation utökas med tiden och språkkoderna för de definierade språken visas inte.

Se även

Inbyggda språldefinitioner

URL_PREFIX

Denna inställning gör det möjligt att köra Weblate under en viss sökväg (annars måste det köras från webbserverns rotkatalog).

Observera

För att kunna använda denna inställning måste du också konfigurera din server så att prefixet tas bort. Med WSGI kan detta till exempel göras genom att ställa in WSGIScriptAlias.

Råd

Prefixet ska börja med ett /.

Exempel:

URL_PREFIX = "/translations"

Observera

Denna inställning fungerar inte med Djangos inbyggda server, du måste justera urls.py så att den innehåller detta prefix.

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-pullförfrågningar, GitLab-sammanslagningsförfrågningar, Gitea-pullförfrågningar, Pagure-sammanslagningsförfrågningar, and Azure DevOps pull-förfrågningar.

Denna hastighet begränsar API-anrop från Weblate till dessa tjänster för att undvika överbelastning.

Om du begränsas av sekundär hastighetsbegränsare på GitHub kan det hjälpa att öka denna.

Standardvärdet är 10.

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-pullförfrågningar, GitLab-sammanslagningsförfrågningar, Gitea-pullförfrågningar, Pagure-sammanslagningsförfrågningar, and Azure DevOps pull-förfrågningar.

Standardvärdet är 10.

VCS_BACKENDS

Konfiguration av tillgängliga VCS-backends.

Observera

Weblate försöker använda alla stödda back-ends som du har verktyg för.

Råd

Du kan begränsa valmöjligheterna eller lägga till anpassade VCS-backend genom att använda detta.

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

Se även

Integration av versionskontroll

VCS_CLONE_DEPTH

Konfigurerar hur djup kloning av repositorier Weblate ska göra.

Observera

För närvarande stöds detta endast i Git. Som standard gör Weblate ytliga kloner av arkiven för att göra kloningen snabbare och spara diskutrymme. Beroende på hur du använder det (till exempel när du använder anpassade Tillägg) kanske du vill öka djupet eller stänga av ytliga kloner helt genom att ställa in detta till 0.

Råd

Om du får felmeddelandet fatal: protocol error: expected old/new/ref, got 'shallow <commit hash>' när du pushar från Weblate, stäng av shallow clones helt genom att ställa in:

VCS_CLONE_DEPTH = 0

WEBLATE_ADDONS

Lista över tillägg som är tillgängliga för användning. För att kunna använda dem måste de aktiveras för en viss översättningskomponent. Som standard inkluderar detta alla inbyggda tillägg. När du utökar listan vill du förmodligen behålla de befintliga aktiverade, till exempel:

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

Observera

Att ta bort tillägget från listan avinstallerar det inte från komponenterna. Weblate kommer i så fall att krascha. Avinstallera tillägget från alla komponenter innan du tar bort det från listan.

Se även

ADDON_ACTIVITY_LOG_EXPIRY

Added in version 5.6.

Konfigurerar hur länge aktivitetsloggar för tillägg sparas. Standardinställningen är 180 dagar.

WEBLATE_EXPORTERS

Added in version 4.2.

Lista över tillgängliga exportörer som erbjuder nedladdning av översättningar eller ordlistor i olika filformat.

Se även

Lokalisering filformat

WEBLATE_FORMATS

Lista över filformat som kan användas.

Observera

Standardlistan innehåller redan de vanligaste formaten.

Se även

Lokalisering filformat

WEBLATE_MACHINERY

Added in version 4.13.

Lista över tillgängliga maskintjänster.

Se även

WEBLATE_GPG_IDENTITY

Identitet som används av Weblate för att signera Git-commits, till exempel:

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

Weblate GPG-nyckelringen söks efter en matchande nyckel (home/.gnupg under DATA_DIR). Om ingen hittas genereras en nyckel. Se Signera Git-commits med GnuPG för mer information.

Se även

Signera Git-commits med GnuPG

WEBSITE_REQUIRED

Definierar om Projektwebbplats måste anges när ett projekt skapas. Standardinställningen är på, eftersom det passar offentliga serverkonfigurationer.

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

Se även

WEBSITE_REQUIRED

Konfigurera autentiseringsuppgifter för versionshantering

Råd

I detta avsnitt beskrivs VCS-autentiseringsvariabler som GITHUB_CREDENTIALS, GITLAB_CREDENTIALS, GITEA_CREDENTIALS, PAGURE_CREDENTIALS, BITBUCKETSERVER_CREDENTIALS.

Konfigurationsordlistan består av autentiseringsuppgifter som definieras för varje API-värd. API-värden kan skilja sig från den du använder i webbläsaren, till exempel nås GitHub API som api.github.com.

Autentiseringsuppgifterna kan också åsidosättas i Push-URL för arkiv eller Källkodsarkiv (om push-URL inte är konfigurerad), dessa har företräde framför de som anges i konfigurationsfilen.

Följande konfiguration är tillgänglig för varje värd:

username

API-användare, krävs.

token

API-token för API-användaren, krävs.

scheme

Added in version 4.18.

Schemaöverskrivning. Weblate försöker analysera schemat från repositoriets URL och faller tillbaka till https. Om du kör API-servern internt kanske du vill använda http istället, men tänk på säkerheten.

Råd

I Docker-containern kan autentiseringsuppgifterna konfigureras med hjälp av miljövariabler, se Inloggningsuppgifter för kodhostingsajter.