Configuratie

Alle instellingen worden opgeslagen in settings.py (zoals gebruikelijk voor Django).

Notitie

Na het wijzigen van deze instellingen moet u Weblate opnieuw starten — zowel de processen van WSGI als van Celery.

In het geval dat het wordt uitgevoerd als mod_wsgi, moet u Apache opnieuw starten om de configuratie opnieuw te laden.

Zie ook

Controleer ook de documentatie van Django voor parameters om Django zelf te configureren.

ADMINS_CONTACT

Configureert waar het contactformulier zijn e-mail naartoe stuurt. Indien niet geconfigureerd, worden e-mailadressen van ADMINS gebruikt.

Configureer dit als een lijst met e-mailadressen:

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

ALLOWED_ASSET_DOMAINS

Added in version 5.14.

Configureert welke domeinen zijn toegestaan om dingen op te halen in Weblate.

Dit verhoogt de veiligheid door te voorkomen dat dingen worden geladen vanuit niet vertrouwde bronnen. Goederen worden eenmaal gedownload door de server van Weblate en lokaal opgeslagen, in plaats van direct aan gebruikers te worden geserveerd vanuit externe domeinen.

De lijst met toegestane vermeldingen wordt toegepast op de initiële URL en op elk HTTP redirectdoel voordat Weblate het volgt. Redirects naar hosts buiten deze lijst met toegestane vermeldingen worden geweigerd.

Het verwacht een lijst van namen van hosts/domeinen. U mag volledig gekwalificeerde namen gebruiken (bijv. www.example.com) of vooraf laten gaan door een punt als jokerteken om overeen te laten komen met alle subdomeinen (bijv. .example.com zal overeenkomen met cdn.example.com of static.example.com).

Standaard ["*"] dat alle domeinen toestaat.

Voorbeeld

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

Dit wordt momenteel gebruikt op de volgende plaatsen:

ALLOWED_MACHINERY_DOMAINS

Configureert welke aangepaste machinedomeinen expliciet zijn toegestaan in de configuratie voor machinevertalingen op projectniveau.

Deze instelling is alleen van toepassing op machineservices en heeft geen invloed op ALLOWED_ASSET_DOMAINS.

Het verwacht een lijst van namen van hosts/domeinen. U mag volledig gekwalificeerde namen gebruiken of vooraf laten gaan door een punt als jokerteken om overeen te laten komen met alle subdomeinen.

Standaard is [].

De lijst met toegestane vermeldingen beïnvloedt projectbeheerd machinevertalen op twee manieren: het staat het geconfigureerde eindpunt toe gedurende uitgaand valideren, en het markeert overeenkomende hosts als vertrouwd bij het bepalen of foutdetails van de provider op afstand en antwoordblokken mogen worden weergegeven aan de gebruiker. Voor directe verbindingen, weigeren controles tijdens runtime nog steeds doelen die eindigen in private of anderszins niet-publieke adressen. Wanneer een HTTP(S)-proxy wordt gebruikt, valt valideren tijdens runtime terug op de gevalideerde hostnaam en voert niet dezelfde lokale DNS- of peer-IP controles uit.

ALLOWED_ASSET_SIZE

Added in version 5.14.

Configureert de limiet voor de grootte van het ophalen van dingen in Weblate. Standaard is 10 MB.

ASSET_PRIVATE_ALLOWLIST

Added in version 2025.5.

Definieert uitgesloten hostnamen of domeinen vanuit ASSET_RESTRICT_PRIVATE voor het downloaden van dingen op afstand die controles voor private doelen afdwingen. Items volgen de semantiek die overeenkomt voor Django host, dus waarden als assets.internal.example of .internal.example mogen worden gebruikt.

Dit vervangt niet ALLOWED_ASSET_DOMAINS; dingen op afstand moeten nog steeds overeenkomen met de lijst van toegestane dingen voor het domein.

Standaard configuratie:

ASSET_PRIVATE_ALLOWLIST = []

ASSET_RESTRICT_PRIVATE

Added in version 2025.5.

Weiger URL’s voor dingen op afstand die wijzen naar interne of niet-publieke adressen, tenzij de doelhost is opgenomen in ASSET_PRIVATE_ALLOWLIST. Standaard aan.

Indien ingeschakeld worden hostnamen, die niet kunnen worden opgelost bij het valideren, geweigerd, tenzij ze expliciet zijn opgenomen in ASSET_PRIVATE_ALLOWLIST. Dit is momenteel van toepassing op uploaden van URL’s van schermafdrukken en downloaden van HTML op afstand voor de add-on JavaScript-vertaling CDN.

ALTCHA_COST

Added in version 5.18.

Argon2id tijdsduur voor de ALTCHA proof-of-work-uitdaging. Standaard 3.

Vervangt ALTCHA_MAX_NUMBER, dat werd toegepast voor de verwijderde ALTCHA widget v2.

ALTCHA_MEMORY_COST

Added in version 5.18.

Argon2id geheugen in KiB. Standaard 65536.

ALTCHA_PARALLELISM

Added in version 5.18.

Argon2id parallel-factor. Standaard 1.

ANONYMOUS_USER_NAME

Gebruikersnaam van gebruikers die niet zijn ingelogd.

Zie ook

Toegangsbeheer

AUDITLOG_EXPIRY

Het maximale aantal dagen dat Weblate logboeken zou moeten bewaren, die informatie bevatten over activiteiten van het account.

Standaard is 180 dagen.

AUTH_LOCK_ATTEMPTS

Maximaal aantal mislukte pogingen voor authenticatie voordat de limiet wordt toegepast.

Dit wordt momenteel toegepast op de volgende locaties:

  • Inloggen. Verwijdert het wachtwoord voor het account, voorkomt dat de gebruiker kan inloggen zonder eerst een nieuw wachtwoord aan te vragen.

  • Wachtwoord herstellen. Voorkomt dat nieuwe e-mails worden verzonden, vermijdt het spammen van gebruikers met te veel pogingen voor herstellen van wachtwoord.

Standaard is 10.

AUTO_UPDATE

Werkt alle opslagruimten bij op dagelijkse basis.

Hint

Nuttig als u geen Notificatie-hooks gebruikt om opslagruimten van Weblate automatisch bij te werken.

Notitie

Opties Aan/Uit bestaan in aanvulling op het selecteren van tekenreeks om redenen van achterwaartse compatibiliteit.

De opties zijn:

"none"

Geen dagelijkse bijwerkingen.

"remote" ook False

Alleen bijwerken op afstand.

"full" ook True

Bijwerken op afstand en samenvoegen werkkopie.

Notitie

Dit vereist dat Achtergrondtaken met Celery werkt, en zal effect hebben nadat dat opnieuw is opgestart.

AVATAR_URL_PREFIX

Voorvoegsel voor construeren van avatar-URL’s als: ${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS}. Van de volgende services is bekend dat zij werken:

Gravatar (standaard), vanaf https://gravatar.com/

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

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

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

AUTH_TOKEN_VALID

Hoe lang het token voor authenticatie en het tijdelijke wachtwoord in e-mails voor het herstellen van het wachtwoord geldig is. Stel in op aantal seconden, standaard is 172800 (2 dagen).

AUTH_PASSWORD_DAYS

Hoeveel dagen Weblate weigert een eerder door de gebruiker gebruikt wachtwoord opnieuw te gebruiken.

Het controleren is gebaseerd op het activiteitenlogboek, AUDITLOG_EXPIRY moet ten minste hetzelfde zijn als dit.

Notitie

Wijzigingen voor wachtwoorden voorafgaande aan Weblate 2.15 zullen in dit beleid niet worden meegenomen.

Standaard is 180 dagen.

AUTOFIX_LIST

Lijst met automatische reparaties die moet worden toegepast bij het opslaan van een tekenreeks.

Notitie

Verschaf een volledig gekwalificeerd pad naar de klasse van Python die de interface autofixer implementeert.

Beschikbare reparaties zijn beschreven in Automatisch repareren.

U kunt selecteren welke te gebruiken:

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

BACKGROUND_TASKS

Added in version 4.5.2.

Definieert hoe vaak langdurige taken voor onderhoud zouden moeten worden geactiveerd voor een onderdeel.

Momenteel beheert dit:

Mogelijke keuzes:

  • monthly (dit is de standaard)

  • weekly

  • daily

  • never

Notitie

Verhogen van de frequentie wordt niet aanbevolen als Weblate duizenden onderdelen bevat.

BASIC_LANGUAGES

Added in version 4.4.

Lijst met talen om aan gebruikers aan te bieden voor het beginnen van een nieuwe vertaling. Indien niet gespecificeerd wordt een ingebouwde lijst gebruikt (die alle veel gebruikte talen bevat, maar zonder landspecifieke varianten).

Dit beperkt alleen niet geprivilegieerde gebruikers om niet gewenste talen toe te voegen. Aan projectbeheerders wordt nog steeds de volledige selectie van in Weblate gedefinieerde talen weergegeven.

Notitie

Dit definieert geen nieuwe talen voor Weblate — het filtert alleen de bestaande in de database.

Voorbeeld:

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

Zie ook

Taaldefinities

BORG_EXTRA_ARGS

Added in version 4.9.

U kunt aanvullende argumenten doorgeven aan borg create als ingebouwde back-ups worden geactiveerd.

Voorbeeld:

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

CACHE_DIR

Added in version 4.16.

Map waar Weblate bestanden voor de cache opslaat. Standaard de submap cache in DATA_DIR.

Wijzig dit naar lokaal of tijdelijk bestandssysteem als DATA_DIR op een netwerk-bestandssysteem staat.

Weblate slaat hier gemaakte hulpbestanden op en voert sommige ervan uit, dus CACHE_DIR moet schrijfbaar zijn en gemount op een bestandssysteem dat uitvoering toestaat. Vermijd het gebruiken van opties voor mounten noexec voor deze map.

De Docker container gebruikt hiervoor een afzonderlijk volume, bekijk Docker container volumes.

Gewoonlijk bestaan de volgende submappen:

ssh

Gemaakte hulpbestanden gebruikt voor toegang tot VCS.

fonts

font-config cache voor Lettertypen beheren.

avatar

Gecachete avatars van gebruikers, bekijk Avatars.

static

Standaard locatie voor statische bestanden van Django, gespecificeerd door STATIC_ROOT. Bekijk Statische bestanden serveren.

tesseract

OCR getrainde gegevens voor Schermafdrukken en visuele context.

CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC

Pas de kop Content-Security-Policy aan voor Weblate. De kop wordt automatisch gegenereerd, gebaseerd op ingeschakelde integraties met services van derde partijen (Matomo, Google Analytics, Sentry, …).

Standaard is dit een lege lijst.

Voorbeeld:

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

CHECK_LIST

Lijst van op een vertaling uit te voeren kwaliteitscontroles.

Notitie

Verschaf een volledig gekwalificeerd pad naar de klasse van Python die de interface check implementeert.

Pas de lijst met controles aan zodat hij die bevat die relevant voor u zijn.

Alle ingebouwde Kwaliteitscontroles zijn standaard ingeschakeld, van waaruit u deze instellingen kunt wijzigen. Standaard zijn zij uit gecommenteerd in Voorbeeld configuratie, zodat standaard waarden worden gebruikt. Nieuwe controles worden dan uitgevoerd voor elke nieuwe versie van Weblate.

U kunt alle controles uitschakelen:

CHECK_LIST = ()

U kunt er ook slechts een paar inschakelen:

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

Notitie

Wijzigen van deze instelling beïnvloed nieuw gewijzigde vertalingen. Bestaande controles zullen nog steeds worden opgeslagen in de database. Voer updatechecks uit om ook wijzigingen op de opgeslagen vertalingen toe te passen.

COMMIT_PENDING_HOURS

Aantal uren tussen indienen van openstaande wijzigingen door middel van een taak op de achtergrond.

COMPONENT_ZIP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Configureert de maximale grootte, in bytes, voor geüploade ZIP-bestanden voor onderdelen. Standaard is 50 MB.

In Docker, configureer dat met de omgevingsvariabele WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE.

CONTACT_FORM

Added in version 4.6.

Configureert hoe e-mail vanuit het contactformulier wordt verzonden. Kies een configuratie die overeenkomt met de configuratie van uw mailserver.

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

Schakelt het contactformulier helemaal uit.

Added in version 5.15.

Zie ook

ADMINS_CONTACT

DATA_DIR

De map Weblate slaat alle gegevens op. Het bevat koppelingen naar de opslagruimten van het VCS, een index op de volledige tekst en verscheidene configuratiebestanden voor externe gereedschappen.

Gewoonlijk bestaan de volgende submappen:

home

Thuismap die wordt gebruikt voor het uitvoeren van scripts.

ssh

SSH-sleutels en configuratie.

media

Standaard locatie voor Django mediabestanden, opgegeven door MEDIA_ROOT. Bevat geuploade screenshots, zie Schermafdrukken en visuele context.

vcs

Opslagruimten van versiebeheer voor vertalingen.

backups

Dagelijkse back-upgegevens. Controleer Gedumpte gegevens voor back-ups voor details.

fonts:

Door gebruiker geüploade lettertypen, bekijk Lettertypen beheren.

cache

Verscheidene caches. Kan ergens anders geplaatst worden met CACHE_DIR.

De Docker container gebruikt hiervoor een afzonderlijk volume, bekijk Docker container volumes.

Notitie

Naar deze map moet kunnen worden geschreven door Weblate. Uitvoeren als WSGI betekent dat de gebruiker van www-data toegang voor schrijven zou hebben.

De gemakkelijkste manier om dit te bereiken is door de gebruiker eigenaar van de map te maken:

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

Standaard is /home/weblate/data, maar verwacht wordt dat hij wordt geconfigureerd.

DATABASE_BACKUP

Of de back-ups van de database zouden moeten worden opgeslagen als platte tekst, gecomprimeerd of overgeslagen. De toegestane waarden zijn:

  • "plain"

  • "compressed"

  • "none"

DEFAULT_ACCESS_CONTROL

De standaard instelling voor toegangsbeheer voor nieuwe projecten:

0

Publiek

1

Beveiligd

100

Privé

200

Aangepast

Gebruik Aangepast als u ACL handmatig beheert, wat niet vertrouwen op het interne beheer van Weblate betekent.

DEFAULT_AUTO_WATCH

Added in version 4.5.

Configureert of Projecten automatisch volgen bij deelnemen ingeschakeld zou moeten zijn voor nieuwe gebruikers. Standaard is True.

Zie ook

Meldingen

DEFAULT_RESTRICTED_COMPONENT

Added in version 4.1.

De standaard waarde voor beperkingen van het onderdeel.

DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE

Standaard berichten voor indienen voor verschillende bewerkingen, controleer Configuratie onderdeel voor details.

DEFAULT_ADDONS

Standaard add-ons om te installeren voor elk gemaakt onderdeel.

Notitie

Deze instelling beïnvloedt alleen nieuw gemaakte onderdelen.

Voorbeeld:

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

DEFAULT_COMMITER_EMAIL

E-mailadres van indiener, standaard is noreply@weblate.org.

DEFAULT_COMMITER_NAME

Naam indiener, standaard is Weblate.

DEFAULT_LANGUAGE

Added in version 4.3.2.

Brontaal voor alle nieuwe onderdelen.

Standaard is en. Het overeenkomende taalobject moet in de database bestaan.

DEFAULT_MERGE_STYLE

Manier voor samenvoegen voor alle nieuwe onderdelen.

  • rebase - standaard

  • merge

DEFAULT_SHARED_TM

Configureert de standaard waarde van Gedeeld vertaalgeheugen gebruiken en Bijdragen aan gedeeld vertaalgeheugen.

DEFAULT_TRANSLATION_REVIEW

Added in version 5.16.

Configureert de standaardwaarde voor Beoordelingen inschakelen, standaard uitgeschakeld.

DEFAULT_SOURCE_REVIEW

Added in version 5.16.

Configureert de standaardwaarde van Bronbeoordelingen inschakelen, standaard uitgeschakeld.

DEFAULT_AUTOCLEAN_TM

Added in version 5.13.

Configureert de standaard waarde van Vertaalgeheugen automatisch opschonen.

DEFAULT_TRANSLATION_PROPAGATION

Standaard instelling voor verspreiding van de vertaling, standaard is True.

DEFAULT_PULL_MESSAGE

Configureert de standaard titel en het bericht voor pull requests.

ENABLE_AVATARS

Of op Gravatar gebaseerde avatars voor gebruikers moeten worden ingeschakeld. Standaard aan.

Avatars worden opgehaald en gecachet op de server, wat het risico op het lekken van privé-informatie verlaagd, en de gebruikerservaring versnelt.

ENABLE_HOOKS

Of anonieme externe hooks ingeschakeld moeten worden.

ENABLE_HTTPS

Veranderd in versie 5.7: Weblate vereist nu https voor ondersteuning van WebAuthn.

Of koppelingen naar Weblate als HTTPS of HTTP moeten worden verzonden. Deze instelling beïnvloedt verzonden e-mails en gegenereerde absolute URL’s.

In de standaard configuratie wordt dit ook gebruikt voor verscheidene instellingen van Django, gerelateerd aan HTTPS — het schakelt veilige cookies in, schakelt HSTS of schakelt verwijzing naar een HTTPS URL in.

De verwijzing van HTTPS zou in sommige gevallen problematisch kunnen zijn en u zou tegen een probleem aan kunnen lopen met oneindige verwijzing in het geval u een omgekeerde proxy gebruikt, die een beëindiging van SSL doet die niet op de juiste wijze protocolkoppen doorgeeft aan Django. Pas de configuratie van uw omgekeerde proxy aan om koppen X-Forwarded-Proto of Forwarded te verzenden of configureer SECURE_PROXY_SSL_HEADER om Django de status van SSL correct te detecteren.

In het geval dat dit is uitgeschakeld zal Weblate niet willen starten met een fout otp_webauthn.E031. U kunt deze fout uitschakelen door hem toe te voegen aan SILENCED_SYSTEM_CHECKS, maar WebAuthn zal nog steeds niet werken voor sites zonder HTTPS.

ENABLE_SHARING

Schakel het menu Gemeenschap in/uit, zodat gebruikers de voortgang van de vertaling op sociale netwerken kunnen delen.

EXTRA_HTML_HEAD

Added in version 4.15.

Voeg aanvullende opmaak in de kop van HTML in. Kan bijvoorbeeld worden gebruikt voor verificatie van de eigenaar van de site:

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

Waarschuwing

Geen opschoning wordt op de tekenreeks uitgevoerd. Wordt in de kop van HTML ingevoegd zoals is.

GET_HELP_URL

Added in version 4.5.2.

URL waar ondersteuning voor uw instantie van Weblate kan worden gevonden.

GITEA_CREDENTIALS

Added in version 4.12.

Lijst voor inloggegevens voor servers van Gitea.

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

Het woordenboek voor de configuratie bestaat uit inloggegevens die zijn gedefinieerd voor elke API-host. De lay-out is hetzelfde voor bijna alle integraties voor versiebeheer en is beschreven in Configureren inloggegevens voor het versiebeheersysteem.

GITLAB_CREDENTIALS

Added in version 4.3.

Lijst voor inloggegevens voor servers van GitLab.

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

Notitie

Het persoonlijke toegangstoken moet het bereik api hebben om de API te kunnen gebruiken.

Het woordenboek voor de configuratie bestaat uit inloggegevens die zijn gedefinieerd voor elke API-host. De lay-out is hetzelfde voor bijna alle integraties voor versiebeheer en is beschreven in Configureren inloggegevens voor het versiebeheersysteem.

GITHUB_CREDENTIALS

Added in version 4.3.

Lijst voor inloggegevens voor servers van GitHub.

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

Notitie

Het is mogelijk om zowel fijn afgestemde persoonlijke toegangstokens en klassieke persoonlijke toegangstokens te gebruiken. De fijn afgestemde tokens zijn beperkt tot een enkele organisatie, dus dat zal niet werken als u Weblate wilt forken naar een opslagruimte buiten de organisatie (gewoonlijk naar de naamruimte van de gebruiker).

Voor het klonen, pushen en maken van pull requests zijn lees- en schrijfrechten naar Contents en Pull requests vereist.

Beheren zou ook noodzakelijk kunnen zijn voor het forken van een opslagruimte, als u van plan bent om forken te gebruiken en de originele opslagruimte is niet publiek.

Hint

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

Het woordenboek voor de configuratie bestaat uit inloggegevens die zijn gedefinieerd voor elke API-host. De lay-out is hetzelfde voor bijna alle integraties voor versiebeheer en is beschreven in Configureren inloggegevens voor het versiebeheersysteem.

BITBUCKETSERVER_CREDENTIALS

Added in version 4.16.

Lijst voor inloggegevens voor servers van Bitbucket Data Center.

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

Het woordenboek voor de configuratie bestaat uit inloggegevens die zijn gedefinieerd voor elke API-host. De lay-out is hetzelfde voor bijna alle integraties voor versiebeheer en is beschreven in Configureren inloggegevens voor het versiebeheersysteem.

BITBUCKETCLOUD_CREDENTIALS

Added in version 5.8.

Lijst voor inloggegevens voor servers van Bitbucket Cloud.

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

Het woordenboek voor de configuratie bestaat uit inloggegevens gedefinieerd voor elke API-host. De API-host zou kunnen verschillen van die welke u gebruikt in de webbrowser, toegang tot GitHub API is bijvoorbeeld api.github.com.

De volgende configuratie is beschikbaar voor elke host:

username

API-gebruiker.

workspace

De slug voor de werkruimte van de gebruiker.

token

Het API-token met het recht pullrequest:write.

Aanvullende instellingen, die hier niet worden beschreven, zijn terug te vinden op Configureren inloggegevens voor het versiebeheersysteem.

AZURE_DEVOPS_CREDENTIALS

Added in version 5.2.

Lijst voor inloggegevens voor servers van Azure DevOps.

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

Het woordenboek voor de configuratie bestaat uit inloggegevens gedefinieerd voor elke API-host. De API-host zou kunnen verschillen van die welke u gebruikt in de webbrowser, toegang tot GitHub API is bijvoorbeeld api.github.com.

De volgende configuratie is beschikbaar voor elke host:

username

De naam van het project van Azure DevOps. Dit is niet de naam van de opslagruimte.

organization

De naam van de organisatie van het project.

workItemIds

Een optionele lijst van werkitem-ID’s van uw organisatie. Indien opgegeven zullen nieuwe pull requests deze eraan gekoppeld hebben.

token

API-token voor de API-gebruiker, vereist.

Aanvullende instellingen, die hier niet worden beschreven, zijn terug te vinden op Configureren inloggegevens voor het versiebeheersysteem.

GOOGLE_ANALYTICS_ID

Google Analytics ID om het monitoren van Weblate met Google Universal Analytics in te schakelen.

Notitie

Integratie van Google Analytics 4 is momenteel niet beschikbaar voor Weblate, bekijk https://github.com/WeblateOrg/weblate/issues/14015.

HIDE_REPO_CREDENTIALS

Verberg inloggegevens voor opslagruimte in de webinterface. In het geval u een URL voor een opslagruimte hebt met gebruiker en wachtwoord, zal Weblate die verbergen als gerelateerde informatie wordt weergegeven aan gebruikers.

Bijvoorbeeld in plaats van https://user:password@git.example.com/repo.git zal het slechts weergeven https://git.example.com/repo.git. Het probeert op een soortgelijke manier foutberichten van het VCS op te schonen.

Notitie

Standaard aan.

VERSION_DISPLAY

Added in version 5.17.

Beheert hoe prominent Weblate zijn eigen versie weergeeft.

Ondersteunde waarden zijn:

show

Geef de versie weer in gedeelde UI, zoals de voettekst, en geef het weer in GET /api/metrics/.

soft

Verberg de versie in prominent gedeelde UI, waarbij het niet te ontdekken valt op de pagina Over en in GET /api/metrics/.

hide

Verbergt de versie in de gedeelde gebruikersinterface en GET /api/metrics/. Dit zorgt ook voor anonieme koppelingen voor documentatie die verwijzen naar de laatste documentatie, in plaats van naar de versie die overeenkomt met de geïnstalleerde uitgave.

Verbergen van de versie is een aanbevolen beveiligingsmaatregel voor sommige bedrijven, maar het voorkomt echter niet dat een aanvaller de versie achterhaalt door te proberen.

Notitie

De standaard waarde is show.

HIDE_VERSION

Added in version 4.3.1.

Verouderd sinds versie 5.17.

Alias voor compatibiliteit voor VERSION_DISPLAY. Stel dit in op True om hetzelfde gedrag te verkrijgen als voor VERSION_DISPLAY = "hide".

IP_BEHIND_REVERSE_PROXY

Geeft aan of Weblate wordt uitgevoerd van achter een omgekeerde proxy.

Indien ingesteld op True verkrijgt Weblate IP-adressen van een kop die is gedefinieerd door IP_PROXY_HEADER.

Waarschuwing

Zorg er voor dat u feitelijk een omgekeerde reverse proxy gebruikt en dat het de kop instelt, anders zullen gebruikers in staat zijn het IP-adres na te bootsen.

Notitie

Dit is standaard uitgeschakeld.

IP_PROXY_HEADER

Geeft aan van welke kop Weblate het IP-adres zou moeten verkrijgen als IP_BEHIND_REVERSE_PROXY is ingeschakeld.

Standaard is HTTP_X_FORWARDED_FOR.

IP_PROXY_OFFSET

Veranderd in versie 5.0.1: De standaard is gewijzigd van 1 naar -1.

Geeft aan welk deel van IP_PROXY_HEADER als IP-adres voor de cliënt wordt gebruikt.

Afhankelijk van uw instellingen zou deze kop kunnen bestaan uit verscheidene IP-adressen, (bijvoorbeeld X-Forwarded-For: client-ip, proxy-a, proxy-b) en u kunt configureren welk adres uit de kop hier als IP-adres voor de cliënt wordt gebruikt.

Waarschuwing

Instellen hiervan beïnvloedt de veiligheid van uw installatie. U zou het alleen voor vertrouwde proxy’s moeten configureren om het IP-adres te bepalen. Bekijk<https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns> voor meer details.

Standaard is -1.

LICENSE_EXTRA

Aanvullende licenties om op te nemen in de keuzes voor de licentie.

Notitie

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.

Bijvoorbeeld:

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

Veranderd in versie 4.3: Dit instellen op een lege waarde schakelt nu het alarm voor de licentie uit.

Filter de lijst met weer te geven licenties. Dit schakelt ook het alarm voor de licentie uit indien ingesteld op een lege waarde.

Notitie

Dit filter gebruikt de verkorte namen voor de licentie.

Bijvoorbeeld:

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

Het volgende schakelt het alarm voor de licentie uit:

LICENSE_FILTER = set()

LICENSE_REQUIRED

Definieert of het attribuut voor de licentie in Configuratie onderdeel is vereist.

Notitie

Dit is standaard uitgeschakeld.

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH

Of de lengte van een bepaalde vertaling zou moeten worden beperkt. De beperking is de lengte van de brontekenreeks × 10 tekens.

Hint

Stel dit in op False om langere vertalingen toe te staan (tot maximaal 10.000 tekens), ongeacht de lengte van de brontekenreeks.

Notitie

Standaard is True.

LOCALIZE_CDN_URL en LOCALIZE_CDN_PATH

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

Hint

Op Hosted Weblate gebruikt dit https://weblate-cdn.com/.

MATOMO_SITE_ID

ID van de site in Matomo (voorheen Piwik) die u wilt gebruiken voor het bijhouden van Weblate.

Notitie

Deze integratie ondersteunt niet de Matomo Tag Manager.

Zie ook

MATOMO_URL

MATOMO_URL

Volledige URL (inclusief achterliggende slash) van een installatie van Matomo (voorheen Piwik)die u wilt gebruiken om het gebruik van Weblate bij te houden. Bekijk <https://matomo.org/> voor meer details.

Hint

Deze integratie ondersteunt niet de Matomo Tag Manager.

Bijvoorbeeld:

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

Zie ook

MATOMO_SITE_ID

NEARBY_MESSAGES

Het aantal te tonen tekenreeksen in de buurt in elke richting in de volledige bewerker.

Dit is slechts een standaard waarde, gebruikers kunnen dit aanpassen in Gebruikersprofiel.

DEFAULT_PAGE_LIMIT

Added in version 4.7.

Standaard aantal weer te geven elementen als pagineren actief is.

PAGURE_CREDENTIALS

Added in version 4.3.2.

Lijst voor inloggegevens voor servers van Pagure.

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

Het woordenboek voor de configuratie bestaat uit inloggegevens die zijn gedefinieerd voor elke API-host. De lay-out is hetzelfde voor bijna alle integraties voor versiebeheer en is beschreven in Configureren inloggegevens voor het versiebeheersysteem.

PASSWORD_MINIMAL_STRENGTH

Added in version 5.10.2.

Minimale score voor wachtwoord zoals geëvalueerd door de zxcvbn schatting voor sterkte van wachtwoorden.

Standaard is 0, wat betekent dat het schatten van de sterkte is uitgeschakeld.

PASSWORD_RESET_URL

Added in version 5.17.

URL voor herstellen van wachtwoord wanneer authenticatie wordt afgehandeld door een externe identiteitsprovider, zoals LDAP, SAML of OAuth.

Indien ingesteld linkt, Wachtwoord vergeten? op de aanmeldpagina naar deze URL in plaats van naar de pagina van Weblate’s ingebouwde hersteller voor wachtwoorden.

PRIVACY_URL

Added in version 4.8.1.

URL waar uw instantie van Weblate zijn privacy-beleid weergeeft.

Hint

Nuttig als u uw wettelijke documenten buiten Weblate host om ze in te bedden in Weblate, bekijk Wettelijke module voor details.

Voorbeeld:

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

Zie ook

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN

Added in version 4.15.

Configureert of de privé e-mail voor indienen opt-in of opt-out is (standaard is het opt-in).

Hint

Deze instelling is alleen van toepassing voor gebruikers die niet expliciet een e-mail voor indienen hebben gekozen.

PRIVATE_COMMIT_EMAIL_TEMPLATE

Added in version 4.15.

Sjabloon voor het maken van een privé e-mail voor indienen voor een gebruiker. Standaard is "{username}@users.noreply.{site_domain}".

Het mag {user_id}, {username}, {site_title} en {site_domain} bevatten.

Stel in op lege tekenreeks om uit te schakelen.

Notitie

Gebruiken van andere e-mail voor indienen is opt-in voor gebruikers, tenzij geconfigureerd door PRIVATE_COMMIT_EMAIL_OPT_IN. Gebruikers kunnen hun e-mail voor indienen configureren in het Profiel.

PRIVATE_COMMIT_NAME_OPT_IN

Added in version 5.16.

Configureert of de privé naam voor indienen opt-in of opt-out is (standaard is het opt-in).

Hint

Deze instelling is alleen van toepassing voor gebruikers die niet expliciet een naam voor indienen hebben gekozen.

PRIVATE_COMMIT_NAME_TEMPLATE

Added in version 5.16.

Sjabloon voor het maken van een privé naam voor indienen voor een gebruiker. Standaard is "{site_title} user {user_id}".

Het mag {user_id}, {username}, {site_title} en {site_domain} bevatten.

Stel in op lege tekenreeks om uit te schakelen.

Notitie

Het gebruiken van een andere naam voor indienen is opt-in voor gebruikers, tenzij geconfigureerd door PRIVATE_COMMIT_NAME_OPT_IN. Gebruikers kunnen hun naam voor indienen configureren in het Profiel.

PROJECT_BACKUP_KEEP_COUNT

Added in version 4.14.

Definieert hoeveel back-ups per project worden behouden op de server. Standaard is 3.

PROJECT_BACKUP_KEEP_DAYS

Added in version 4.14.

Definieert hoe lang de back-ups van het project zullen worden behouden op de server. Standaard is 30 dagen.

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, configureer dit met de omgevingsvariabele WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE. Opstellingen van Docker kunnen ook worden beperkt door CLIENT_MAX_BODY_SIZE; andere uitrollen kunnen worden beperkt door hun limiet voor de reverse proxy request body-size.

PROJECT_BACKUP_IMPORT_MAX_MEMBERS

Added in version 5.17.

Definieert het maximale aantal ZIP-items dat is toegestaan bij het importeren van een projectback-up.

Dit is een veiligheidsmaatregel tegen misvormde of opzettelijk gefragmenteerde archieven. Standaard is 100000 items.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS environment variable.

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

Dit beperkt archieven die klein zijn bij het uploaden, maar naar veel meer gegevens uitbreiden bij valideren of herstellen.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE environment variable.

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE

Added in version 5.17.

Definieert de maximale niet gecomprimeerde grootte, in bytes, voor een enkel hoog gecomprimeerd ZIP-item in een geïmporteerde projectback-up.

Deze limiet wordt alleen toegepast op items die groot genoeg en gecomprimeerd genoeg zijn om verdacht te lijken. Grote lage-compressiebestanden zijn hier met opzet toegestaan en van hen wordt verwacht dat ze worden beperkt door de HTTP-uploadlimiet. Standaard 262144000 bytes (250 MiB).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE environment variable.

PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE

Added in version 5.17.

Definieert de minimale niet gecomprimeerde grootte, in bytes, waarbij Weblate begint met het rekening houden van de verhouding voor ZIP-compressie gedurende het importeren van de projectback-up.

Kleinere bestanden worden genegeerd voor het op compressieverhouding gebaseerd valideren om het negeren van redelijk grote bestanden die goed comprimeren te vermijden. Standaard 1048576 bytes (1 MiB).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE environment variable.

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO

Added in version 5.17.

Definieert de maximale toegestane verhouding tussen niet-gecomprimeerde en gecomprimeerde grootte voor een groot ZIP-item gedurende het importeren van de projectback-up.

Dit wordt samen gebruikt met PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE en PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE om verdachte gecomprimeerde items te kunnen detecteren, terwijl nog steeds grote packbestanden voor de opslagruimte en andere lage-compressie inhoud, worden toegestaan. Standaard 250.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO environment variable.

PROJECT_NAME_RESTRICT_RE

Added in version 4.15.

Definieert een reguliere uitdrukking voor het beperken van de naamgeving aan een project. Overeenkomende namen zullen worden geweigerd.

Zie ook

Projectnaam

PROJECT_WEB_RESTRICT_HOST

Added in version 4.16.2.

Weiger het gebruiken van bepaalde hosts op de projectwebsite. Elk subdomein komt overeen, dus opnemen van example.com zal ook test.example.com blokkeren. De lijst zou alleen kleine letters moeten bevatten, het geparsete domein is kleine letters voor het overeenkomen.

Standaard configuratie:

PROJECT_WEB_RESTRICT_HOST = {"localhost"}

PROJECT_WEB_RESTRICT_ALLOWLIST

Added in version 5.17.

Definieert een set uitgesloten projectslugs vanuit PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_PRIVATE en PROJECT_WEB_RESTRICT_RE bij het valideren van de projectwebsite. Projectslugs worden hoofdletterongevoelig vergeleken.

Pas op

Deze uitsluiting verzwakt de uitgaande URL beschermingen voor overeenkomende projecten, inclusief de private-doel beperking die wordt afgedwongen door PROJECT_WEB_RESTRICT_PRIVATE. Gebruik het alleen voor vertrouwde, door beheerders beheerde, projecten waar het ontwijken van deze controles met opzet is.

Standaard configuratie:

PROJECT_WEB_RESTRICT_ALLOWLIST = set()

PROJECT_WEB_RESTRICT_NUMERIC

Added in version 4.16.2.

Weiger het gebruiken van numeriek IP-adres op de projectwebsite. Standaard aan.

PROJECT_WEB_RESTRICT_PRIVATE

Added in version 5.17.

Weiger het gebruiken van projectwebsite- en opslagruimtebrowser-URL’s die wijzen naar interne of niet-publieke adressen. Standaard aan.

PROJECT_WEB_RESTRICT_RE

Added in version 4.15.

Definieert een reguliere uitdrukking voor het beperken van wat kan worden ingevoerd als Projectwebsite. Alle overeenkomende URL’s zullen worden geweigerd.

WEBHOOK_PRIVATE_ALLOWLIST

Added in version 5.17.

Definieert uitgesloten hostnamen of domeinen vanuit WEBHOOK_RESTRICT_PRIVATE voor uitgaande aflevering van webhooks. Items volgen de semantiek die overeenkomst voor Django host, dus waarden als hooks.internal.example of .internal.example mogen worden gebruikt.

Standaard configuratie:

WEBHOOK_PRIVATE_ALLOWLIST = []

WEBHOOK_RESTRICT_PRIVATE

Added in version 5.17.

Weiger URL’s voor webhooks die wijzen naar interne of niet-publieke adressen, tenzij de doelhost is opgenomen in WEBHOOK_PRIVATE_ALLOWLIST. Standaard aan.

Indien ingeschakeld worden hostnamen, die niet kunnen worden opgelost bij het valideren, geweigerd, tenzij ze expliciet zijn opgenomen in WEBHOOK_PRIVATE_ALLOWLIST.

PUBLIC_ENGAGE

Added in version 5.16.2.

Staat gebruik publiek deelnemen van de pagina toe, zelfs met REQUIRE_LOGIN.

RATELIMIT_NOTIFICATION_LIMITS

Added in version 5.14.

Beperkt hoeveel notificaties naar een enkele gebruiker zullen worden verzonden.

De standaard instelling is:

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

RATELIMIT_ATTEMPTS

Maximaal aantal pogingen voor authenticatie voordat de limiet wordt toegepast.

Standaard is 5.

RATELIMIT_WINDOW

Hoe lang authenticatie blijft geaccepteerd nadat de limiet van toepassing is.

Een aantal seconden, standaard 300 (5 minuten).

RATELIMIT_LOCKOUT

Hoe lang authenticatie wordt vergrendeld nadat de limiet wordt toegepast.

Een aantal seconden, standaard is 600 (10 minuten).

REGISTRATION_ALLOW_BACKENDS

Added in version 4.1.

Lijst met backends voor authenticatie waarmee kan worden geregistreerd. Dit beperkt alleen nieuwe registraties, gebruikers kunnen nog steeds authenticeren en authenticatie toevoegen met alle geconfigureerde backends voor authenticatie.

Aanbevolen wordt om REGISTRATION_OPEN ingeschakeld te laten bij het beperken van backends voor registratie, anders zullen gebruikers wel in staat zijn te registreren, maar Weblate zal geen koppelingen om te registreren weergeven in de gebruikersinterface.

Voorbeeld:

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

Hint

De namen van de backends komen overeen met namen die worden gebruikt in de URL voor authenticatie.

REGISTRATION_CAPTCHA

Of registratie van nieuwe accounts wordt beveiligd met een CAPTCHA. Standaard ingeschakeld.

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

  • Registreren nieuw account.

  • Wachtwoord herstellen.

  • E-mail aan account toevoegen.

  • Contactformulier voor gebruikers die niet ingelogd zijn.

De beveiliging bestaat momenteel uit de volgende stappen:

REGISTRATION_EMAIL_MATCH

Maakt het voor u mogelijk te filteren welke e-mailadressen kunnen registreren.

Standaard is .*, wat toestaat dat elk e-mailadres zich registreert.

U kunt het gebruiken om registratie te beperken tot een enkel domein voor e-mail:

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

REGISTRATION_ALLOW_DISPOSABLE_EMAILS

Added in version 5.16.1.

Staat registratie toe met wegwerp e-maildomeinen. Indien ingeschakeld wordt de blokkeerlijst voor wegwerpdomeinen ontweken. Standaard is False.

REGISTRATION_OPEN

Of registratie van nieuwe accounts momenteel is toegestaan. Standaard ingeschakeld.

Deze instelling beïnvloedt ingebouwde authenticatie door e-mailadres of via de Python Social Auth (u kunt bepaalde backends toestaan met REGISTRATION_ALLOW_BACKENDS).

Notitie

Indien methoden voor authenticatie van derde partijen wordt gebruikt, zoals LDAP authenticatie, verbergt het slechts het registratieformulier, maar nieuwe gebruikers zouden nog steeds in staat kunnen zijn in te loggen en accounts te maken.

REGISTRATION_REBIND

Added in version 4.16.

Sta opnieuw verbinden van backends voor authenticatie voor bestaande gebruikers toe. Schakel dit in bij het migreren tussne providers van authenticatie.

Notitie

Standaard uitgeschakeld om het niet toe te staan dat andere backends voor authenticatie worden toegevoegd aan een bestaand account. Opnieuw verbinden kan leiden tot corruptie van het account als meerdere backends voor authenticatie van derde partijen worden gebruikt.

REPOSITORY_ALERT_THRESHOLD

Added in version 4.0.2.

Drempel voor activeren van alarm voor verouderde opslagruimten, of die welke te veel wijzigingen bevatten. Standaard is 25.

REQUIRE_LOGIN

Added in version 4.1.

Dit schakelt django.contrib.auth.middleware.LoginRequiredMiddleware in en configureert REST framewerk om authenticatie te vereisen voor alle eindpunten van de API.

Veranderd in versie 5.15: Weblate vereist nu Django ingebouwde middleware.

Notitie

Dit is geïmplementeerd in de Voorbeeld configuratie. Voor Docker, gebruik WEBLATE_REQUIRE_LOGIN.

SENTRY_DSN

Sentry DSN om te gebruiken voor Foutrapporten verzamelen en prestaties monitoren.

SENTRY_ENVIRONMENT

Configureert de omgeving voor Sentry. Standaard is devel.

SENTRY_MONITOR_BEAT_TASKS

Added in version 5.13.

Configureer of taken van Celery Beat moeten worden gemonitord met Sentry. Standaard is True.

SENTRY_PROFILES_SAMPLE_RATE

Configureer monsterfrequentie voor monitoren van de prestaties. Stel in op 1 om alle gebeurtenissen te traceren, 0 (de standaard) schakelt traceren uit.

SENTRY_SEND_PII

Sta Sentry toe om bepaalde te identificeren persoonlijke informatie te verzamelen. Standaard uitgeschakeld.

Veranderd in versie 5.7: Dit is nu standaard uitgeschakeld, het was vroeger standaard ingeschakeld.

SENTRY_TRACES_SAMPLE_RATE

Configureer monsterfrequentie voor monitoren van profileren. Stel in op 1 om alle gebeurtenissen te traceren, 0 (de standaard) schakelt traceren uit.

SIMPLIFY_LANGUAGES

Gebruik eenvoudige taalcodes voor standaard combinaties van taal/land. Bijvoorbeeld een vertaling fr_FR zal de taalcode fr gebruiken. Dit is gewoonlijk het gewenste gedrag, omdat het vermelden van talen voor deze standaard combinaties eenvoudiger wordt.

Schakel dit uit als u verschillende vertalingen voor elke variant wilt.

HIDE_SHARED_GLOSSARY_COMPONENTS

Added in version 5.16.

Onderdelen Woordenlijst worden gewoonlijk gedeeld met andere projecten om ze beschikbaar te maken voor vertaalwerk. Als deze zichtbaar zijn in de lijst met onderdelen van de projecten die ze gebruiken, kan het voor verwarring zorgen of vertalers afleiden van de feitelijke onderdelen die bedoeld zijn om te worden vertaald.

Dit is nu standaard uitgeschakeld, wat gedeelde onderdelen Woordenlijsten zichtbaar maakt.

SITE_DOMAIN

Configureert het domein voor de site. Noodzakelijk om juiste absolute koppelingen voor vele bereiken te produceren (bijvoorbeeld e-mails voor activeren, notificaties of RSS-feeds).

Als Weblate wordt uitgevoerd op een niet standaard poort, neem dat hier dan ook op.

Voorbeelden:

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

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

Notitie

Deze instelling zou alleen de naam van het domein moeten bevatten. Voor configureren van het protocol (inschakelen en afdwingen van HTTPS), gebruik ENABLE_HTTPS en voor het wijzigen van de URL, gebruik URL_PREFIX.

Hint

In een Docker container wordt het domein voor de site geconfigureerd door WEBLATE_ALLOWED_HOSTS.

SITE_TITLE

Titel voor de site die moet worden gebruikt voor de website en het verzenden van e-mails.

SPECIAL_CHARS

Aanvullende tekens om op te nemen in het visuele toetsenbord, Visueel toetsenbord.

De standaard waarde is:

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

SINGLE_PROJECT

Verwijst gebruikers direct naar een project of onderdeel in plaats van het dashboard weer te geven. U kunt het instellen op True zodat het werkt alsof er in feite, maar slechts een project in Weblate staat. Als alternatief, stel de slug voor het project in en het zal u onvoorwaardelijk naar dat project verwijzen.

Voorbeeld:

SINGLE_PROJECT = "test"

SSH_EXTRA_ARGS

Added in version 4.9.

Staat het toevoegen van aanvullende parameters toe als Weblate SSH uitvoert. Nuttig bij het verbinden met servers die verouderde versleuteling of andere niet standaard mogelijkheden gebruiken.

Als bijvoorbeeld de verbinding van SSH in Weblate mislukt met Unable to negotiate with legacyhost: no matching key exchange method found. Their offer: diffie-hellman-group1-sha1, kunt u dat uitschakelen met:

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

Hint

De tekenreeks wordt geëvalueerd door de shell, zorg er dus voor dat, indien aanwezig, witruimte en speciale tekens tussen aanhalingstekens staan.

STATUS_URL

De URL waar uw instantie van Weblate zijn status rapporteert.

SUPPORT_STATUS_CHECK

Added in version 5.5.

Schakelt de halfjaarlijkse controle voor ondersteuning uit en verwijst superusers bij het inloggen naar de donatiepagina in het geval er geen actief abonnement voor ondersteuning is.

Hint

Verbeter uw ervaring met Weblate door een onderhoudsabonnement te kopen en de voortgang van Weblate een boost te geven in plaats van dit uit te schakelen.

TRANSLATION_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Configureert de maximale grootte, in bytes, voor geüploade vertaalbestanden. Standaard is 50 MB.

In Docker, configureer dat met de omgevingsvariabele WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE.

UNUSED_ALERT_DAYS

Added in version 4.17.

Configureert wanneer het alarm Onderdeel lijkt niet gebruikt wordt geactiveerd.

Standaard is 365 dagen, stel het in op 0 om het uit te schakelen.

UPDATE_LANGUAGES

Added in version 4.3.2.

Beheert of de database met talen zou moeten worden bijgewerkt bij het uitvoeren van een migratie van de database en staat standaard aan. Deze instelling heeft geen effect op het aanroepen van setuplang.

Waarschuwing

De weergave van de talen zou hiermee inconsistent kunnen worden. Taaldefinities van Weblate breiden zich in de tijd uit en het zal de taalcode voor de gedefinieerde talen niet weergeven.

URL_PREFIX

Deze instelling stelt u in staat Weblate uit te voeren op een bepaald pad (anders dan dat het erop vertrouwd te worden uitgevoerd vanuit de bron van de webserver).

Notitie

U moet, om deze instelling te kunnen gebruiken, ook uw server configureren om dit voorvoegsel weg te halen. Bijvoorbeeld met WSGI kan dat worden bereikt door WSGIScriptAlias in te stellen.

Hint

Het voorvoegsel zou moeten beginnen met een /.

Voorbeeld:

URL_PREFIX = "/translations"

Notitie

Deze instelling werkt niet met de ingebouwde server van Django, u zou urls.py moeten aanpassen om dit voorvoegsel daarin op te nemen.

VCS_ALLOW_HOSTS

Added in version 5.15.

Een set toegestane hosts voor het configureren van de URL voor het VCS. Standaard een lege set, die niets filtert.

Wanneer VCS_RESTRICT_PRIVATE is ingeschakeld, worden overeenkomende hosts ook uitgesloten van de beperking voor private-doel.

VCS_ALLOW_SCHEMES

Added in version 5.15.

Een set toegestane schema’s voor URL’s voor het configureren van de URL voor het VCS. Alleen https en ssh zijn standaard toegestaan.

VCS_RESTRICT_PRIVATE

Added in version 5.17.

Weiger URL’s voor VCS-opslagruimte die wijzen naar interne of niet-publieke adressen, tenzij de doelhost is opgenomen in VCS_ALLOW_HOSTS. Standaard aan.

Indien ingeschakeld worden hostnamen, die niet kunnen worden opgelost bij het valideren, geweigerd, tenzij ze expliciet zijn opgenomen in VCS_ALLOW_HOSTS.

VCS_API_DELAY

Added in version 4.15.1.

Configureert de minimale vertraging in seconden tussen aanroepen van derde partijen API in GitHub pull requests, GitLab verzoeken voor samenvoegen, Gitea pull requests, Pagure verzoeken voor samenvoegen en Azure DevOps pull requests.

Deze limiet vertraagt aanroepen naar de API vanuit Weblate naar deze services om het ovebelasten ervan te voorkomen.

Als u wordt beperkt door een tweede limiet op GitHub, zou het verhogen hiervan kunnen helpen.

De standaard waarde is 10.

VCS_API_TIMEOUT

Added in version 5.15.

Configureert de vertraging in seconden voor aanroepen van derde partijen API, zoals forken of merge requests, in GitHub pull requests, GitLab verzoeken voor samenvoegen, Gitea pull requests, Pagure verzoeken voor samenvoegen en Azure DevOps pull requests.

De standaard waarde is 10.

VCS_BACKENDS

Configuratie van beschikbare backends voor VCS (versiebeheersystemen).

Notitie

Weblate probeert alle ondersteunde backends te gebruiken waar u de gereedschappen voor heeft.

Hint

U kunt keuzes beperken of aangepaste backends voor VCS toevoegen door dit te gebruiken.

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

VCS_CLONE_DEPTH

Configureert hoe diep Weblate klonen van opslagruimten zou moeten doen.

Notitie

Momenteel wordt dit alleen ondersteund in Git. Standaard voert Weblate oppervlakkig klonen uit op opslagruimten om het klonen sneller te maken en schijfruimte te besparen. Afhankelijk van uw gebruik (bijvoorbeeld bij het gebruiken van aangepaste Add-ons), zou u de diepte willen verhogen of het oppervlakkig klonen helemaal uitschakelen door die in te stellen op 0.

Hint

In het geval u een fout fatal: protocol error: expected old/new/ref, got 'shallow <commit hash>' krijgt bij het pushen vanuit Weblate, schakel dan oppervlakkig klonen helemaal uit door in te stellen:

VCS_CLONE_DEPTH = 0

WEBLATE_ADDONS

Lijst met te gebruiken beschikbare add-ons. Zij moeten, om te kunnen worden gebruikt, zijn ingeschakeld voor een bepaald vertaalonderdeel. Standaard omvat dit alle ingebouwde add-ons, bij het uitbreiden van de lijst zou u waarschijnlijk de bestaande ingeschakeld willen laten, bijvoorbeeld:

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

Notitie

Verwijderen van de add-on uit de lijst deinstalleert het niet uit de onderdelen. Weblate zal in dat geval crashen. Deinstalleer de add-on uit alle onderdelen voordat u hem uit deze lijst verwijdert.

ADDON_ACTIVITY_LOG_EXPIRY

Added in version 5.6.

Configureert hoe lang activiteitenlogs voor add-ons worden behouden. Standaard is 180 dagen.

WEBLATE_EXPORTERS

Added in version 4.2.

Lijst met beschikbare exporteerders die het downloaden van vertalingen of woordenlijsten in verscheidene indelingen aanbieden.

WEBLATE_FORMATS

Lijst van te gebruiken beschikbare bestandsindelingen.

Notitie

De standaard lijst bevat al de veel voorkomende indelingen.

WEBLATE_MACHINERY

Added in version 4.13.

Lijst met te gebruiken beschikbare services voor machinevertaling.

WEBLATE_GPG_IDENTITY

Identiteit die door Weblate wordt gebruikt om indieningen van Git te ondertekenen, bijvoorbeeld:

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

In de GPG-sleutelring van Weblate wordt gezocht naar een overeenkomende sleutel (home/.gnupg onder DATA_DIR). Indien niet gevonden wordt een sleutel gemaakt, controleer Ondertekenen van indieningen voor Git met GnuPG voor meer details.

WEBSITE_REQUIRED

Definieert of Projectwebsite moet zijn gespecificeerd bij het maken van een project. Standaard ingeschakeld, omdat dat gewenst is bij het instellen van publieke servers.

WEBSITE_ALERTS_ENABLED

Added in version 5.17.

Standaard: True

Definieert of Weblate de beschikbaarheid van projectwebsites zou moeten controleren en laat meldingen zien voor onbereikbare projectwebsites.

Indien ingesteld op False, zal Weblate de controles voor beschikbaarheid van de website overslaan en zal geen meldingen voor de projectwebsite maken. Dit is handig als:

  • Uw websites zich achter firewalls bevinden die Weblate’s verzoeken blokkeren

  • U fouten van de types 403/503 van botbeveiliging wilt vermijden

  • Beschikbaarheid van de projectwebsite is niet van belang voor uw installatie

Configureren inloggegevens voor het versiebeheersysteem

Hint

Dit gedeelte beschrijft variabelen voor inloggegevens voor VCS, zoals GITHUB_CREDENTIALS, GITLAB_CREDENTIALS, GITEA_CREDENTIALS, PAGURE_CREDENTIALS, BITBUCKETSERVER_CREDENTIALS.

Het woordenboek voor de configuratie bestaat uit inloggegevens gedefinieerd voor elke API-host. De API-host zou kunnen verschillen van die welke u gebruikt in de webbrowser, toegang tot GitHub API is bijvoorbeeld api.github.com.

De inloggegevens kunnen worden overschreven in URL voor pushen naar de opslagruimte of Broncode-opslagruimte (als de URL voor pushen niet is geconfigureerd), deze hebben voorrang boven die welke zijn gespecificeerd in het configuratiebestand.

De volgende configuratie is beschikbaar voor elke host:

username

API-gebruiker, vereist.

token

API-token voor de API-gebruiker, vereist.

scheme

Added in version 4.18.

Schema overschrijven. Weblate probeert schema te parsen vanuit de URL van de opslagruimte en valt terug op https. Als u de server voor API intern uitvoert, zou u misschien in plaats daarvan http willen gebruiken, maar denk aan de beveiliging.

Hint

In de Docker container kunnen de inloggegevens worden geconfigureerd met omgevingsvariabelen, bekijk Inloggegevens sites hosten code.