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.

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

Standardinställningen är [*], vilket tillåter alla domäner.

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_ASSET_SIZE

Added in version 5.14.

Konfigurerar storleksbegränsningen för hämtning av tillgångar i Weblate. Standardvärdet är 4 MB.

Se även

ALTCHA_MAX_NUMBER

Added in version 5.9.

Konfigurerar ett maximalt antal för ALTCHA-mekanismen för bevis på arbete.

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.

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

Följande underkataloger finns vanligtvis:

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 Visuellt sammanhang för strängar.

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

COMMENT_CLEANUP_DAYS

Ta bort kommentarer efter ett visst antal dagar. Standardinställningen är Ingen, vilket innebär att inga kommentarer tas bort.

COMMIT_PENDING_HOURS

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

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"

Avsändaren används i Reply-To, detta är standardinställningen.

"from"

Avsändaren används i From. Din e-postserver måste tillåta att sådana e-postmeddelanden skickas.

"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 Visuellt sammanhang för strängar.

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.

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

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

Använd api.github.com som API-värd för 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-username",
        "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.

HIDE_VERSION

Added in version 4.3.1.

Döljer versionsinformation från icke-autentiserade användare. Detta gör också att alla dokumentationslänkar pekar på den senaste versionen istället för dokumentationen som matchar den version som för närvarande är installerad.

Att dölja versionen är en rekommenderad säkerhetsåtgärd i vissa företag, men hindrar inte en angripare från att ta reda på versionen genom att undersöka beteendet.

Observera

Detta är avstängt som standard.

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

Varje licensdefinition bör bestå av en kortbeteckning, en långbeteckning, en URL och en boolesk variabel som anger att det är en fri licens.

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

Översättningskomponentvarningar

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

Dessa inställningar konfigurerar tillägget JavaScript-lokalisering CDN. LOCALIZE_CDN_URL definierar rot-URL där lokaliserings-CDN är tillgängligt och LOCALIZE_CDN_PATH definierar sökvägen där Weblate ska lagra genererade filer som kommer att serveras på LOCALIZE_CDN_URL.

Råd

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

Se även

JavaScript-lokalisering CDN

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

PRIVACY_URL

Added in version 4.8.1.

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

Råd

Användbart om du lagrar dina juridiska dokument utanför Weblate för att bädda in dem i Weblate. Se Juridisk modul för mer information.

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.

Mall för att generera privat e-postmeddelande om commit för en användare. Standardinställningen är "{username}@users.noreply.{site_domain}".

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

Observera

Att använda olika e-postadresser för commit är valfritt för användare om det inte konfigureras med PRIVATE_COMMIT_EMAIL_OPT_IN. Användare kan konfigurera e-postadresser för commit i 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_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_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_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

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.

Om funktionen är aktiverad läggs en CAPTCHA till på alla sidor där användare anger sin e-postadress:

  • 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:

  • Matematisk captcha som ska lösas av användaren.

  • Bevis på arbetsutmaning beräknat av webbläsaren. Svårighetsgraden kan justeras med hjälp av ALTCHA_MAX_NUMBER.

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

Översättningskomponentvarningar

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.

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

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

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.

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.

SUGGESTION_CLEANUP_DAYS

Raderar automatiskt förslag efter ett visst antal dagar. Standardinställningen är Ingen, vilket innebär att inga raderingar görs.

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.

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.

En uppsättning värdar som ska tillåtas vid konfigurering av VCS-URL. Standardinställningen är en tom uppsättning som inte filtrerar alls.

VCS_ALLOW_SCHEMES

Added in version 5.15.

En uppsättning värdar som tillåts vid konfigurering av VCS-URL. Endast https och ssh är tillåtna som standard.

VCS_API_DELAY

Added in version 4.15.1.

Konfigurerar minimal fördröjning i sekunder mellan API-anrop från tredje part i GitHub-pullförfrågningar, GitLab-sammanslagningsförfrågningar, Gitea-pullförfrågningar, Pagure-sammanslagningsförfrågningar och 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.

Konfigurerar timeout i sekunder för API-anrop från tredje part, till exempel för att förgrena eller skapa sammanfogningsförfrågningar i GitHub-pullförfrågningar, GitLab-sammanslagningsförfrågningar, Gitea-pullförfrågningar, Pagure-sammanslagningsförfrågningar och 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.

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.