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"]
Zie ook
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:
Schermafdrukken uploads, bekijk Schermafdrukken en visuele context
HTML-downloads op afstand voor de add-on JavaScript-vertaling CDN
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.
Zie ook
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.
Zie ook
ANONYMOUS_USER_NAME¶
Gebruikersnaam van gebruikers die niet zijn ingelogd.
Zie ook
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.
Zie ook
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"ookFalseAlleen bijwerken op afstand.
"full"ookTrueBijwerken 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/'
Zie ook
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:
add-on Automatische vertaling
herberekenen van Controles en reparaties
Mogelijke keuzes:
monthly(dit is de standaard)weeklydailynever
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
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:
sshGemaakte hulpbestanden gebruikt voor toegang tot VCS.
fontsfont-config cache voor Lettertypen beheren.
avatarGecachete avatars van gebruikers, bekijk Avatars.
staticStandaard locatie voor statische bestanden van Django, gespecificeerd door
STATIC_ROOT. Bekijk Statische bestanden serveren.tesseractOCR 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.
Zie ook
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
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:
homeThuismap die wordt gebruikt voor het uitvoeren van scripts.
sshSSH-sleutels en configuratie.
mediaStandaard locatie voor Django mediabestanden, opgegeven door
MEDIA_ROOT. Bevat geuploade screenshots, zie Schermafdrukken en visuele context.vcsOpslagruimten van versiebeheer voor vertalingen.
backupsDagelijkse back-upgegevens. Controleer Gedumpte gegevens voor back-ups voor details.
fonts:Door gebruiker geüploade lettertypen, bekijk Lettertypen beheren.
cacheVerscheidene 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:
0Publiek
1Beveiligd
100Privé
200Aangepast
Gebruik Aangepast als u ACL handmatig beheert, wat niet vertrouwen op het interne beheer van Weblate betekent.
Zie ook
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
DEFAULT_RESTRICTED_COMPONENT¶
Added in version 4.1.
De standaard waarde voor beperkingen van het onderdeel.
Zie ook
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",
},
}
Zie ook
DEFAULT_COMMITER_EMAIL¶
E-mailadres van indiener, standaard is noreply@weblate.org.
Zie ook
DEFAULT_COMMITER_NAME¶
Naam indiener, standaard is Weblate.
Zie ook
DEFAULT_LANGUAGE¶
Added in version 4.3.2.
Brontaal voor alle nieuwe onderdelen.
Standaard is en. Het overeenkomende taalobject moet in de database bestaan.
Zie ook
DEFAULT_MERGE_STYLE¶
Manier voor samenvoegen voor alle nieuwe onderdelen.
rebase - standaard
merge
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.
Zie ook
ENABLE_HOOKS¶
Of anonieme externe hooks ingeschakeld moeten worden.
Zie ook
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:
usernameAPI-gebruiker.
workspaceDe slug voor de werkruimte van de gebruiker.
tokenHet 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:
usernameDe naam van het project van Azure DevOps. Dit is niet de naam van de opslagruimte.
organizationDe naam van de organisatie van het project.
workItemIdsEen optionele lijst van werkitem-ID’s van uw organisatie. Indien opgegeven zullen nieuwe pull requests deze eraan gekoppeld hebben.
tokenAPI-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:
showGeef de versie weer in gedeelde UI, zoals de voettekst, en geef het weer in
GET /api/metrics/.softVerberg de versie in prominent gedeelde UI, waarbij het niet te ontdekken valt op de pagina Over en in
GET /api/metrics/.hideVerbergt 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.
LEGAL_TOS_DATE¶
Added in version 4.15.
Notitie
U moet Wettelijke module hebben geïnstalleerd om dit te laten werken.
Datum van laatste bijwerken van de termen van de documenten voor de service. Wanneer de datum wijzigt moeten gebruikers instemmen met de bijgewerkte termen voor de service.
from datetime import date
LEGAL_TOS_DATE = date(2022, 2, 2)
LEGAL_URL¶
URL waar uw instantie van Weblate zijn wettelijke documenten weergeeft.
Hint
Nuttig als u uw wettelijke documenten buiten Weblate host om ze in te bedden in Weblate. Bekijk Wettelijke module voor details.
Voorbeeld:
LEGAL_URL = "https://weblate.org/terms/"
Zie ook
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()
Zie ook
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¶
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
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
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.
Zie ook
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.
Zie ook
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.
Zie ook
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.
Zie ook
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.
Zie ook
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.
Zie ook
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.
Zie ook
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.
Zie ook
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.
Zie ook
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.
Zie ook
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
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 = []
Zie ook
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.
Zie ook
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.
Zie ook
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:
Wiskundige captcha, door de gebruiker op te lossen.
Uitdaging van Proof of work, berekend door de browser. De moeilijkheid kan worden aangepast met
ALTCHA_COST,ALTCHA_MEMORY_COSTenALTCHA_PARALLELISM.
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.
Zie ook
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.
Zie ook
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.
Zie ook
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.
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.
Zie ook
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.
Zie ook
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",)
Zie ook
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.
Zie ook
WEBLATE_FORMATS¶
Lijst van te gebruiken beschikbare bestandsindelingen.
Notitie
De standaard lijst bevat al de veel voorkomende indelingen.
Zie ook
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
Zie ook
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:
usernameAPI-gebruiker, vereist.
tokenAPI-token voor de API-gebruiker, vereist.
schemeAdded 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 daarvanhttpwillen gebruiken, maar denk aan de beveiliging.
Hint
In de Docker container kunnen de inloggegevens worden geconfigureerd met omgevingsvariabelen, bekijk Inloggegevens sites hosten code.