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
AKISMET_API_KEY¶
Weblate kan Akismet gebruiken voor het controleren van anonieme suggesties op spam. Bezoek akismet.com om een API-sleutel te kopen en die te koppelen aan een site.
ALTCHA_MAX_NUMBER¶
Added in version 5.9.
Configureert een maximaal getal voor het proof-of-work mechanisme van ALTCHA.
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"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/'
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.
De Docker container gebruikt hiervoor een afzonderlijk volume, bekijk Docker container volumes.
Gewoonlijk bestaan de volgende submappen:
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 Visuele context voor tekenreeksen.
CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC¶
Aangepaste kop Content-Security-Policy voor Weblate. De kop wordt automatisch gegenereerd, gebaseerd op ingeschakelde integraties met services van derde partijen (Matomo, Google Analytics, Sentry, …).
Standaard zijn dit lege lijsten.
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.
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"De afzender wordt gebruikt in Reply-To, dit is het standaard gedrag.
"from"De afzender wordt gebruikt in From. Uw mailserver moet het verzenden van dergelijke e-mails toestaan.
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 Visuele context voor tekenreeksen.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_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 Delen 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",
},
}
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
Bij het maken van een fijn afgestemd persoonlijk toegangstoken, geef lees- en schrijfrechten aan Contents en Pull requests.
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
Gebruik api.github.com als een API-host voor 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-username",
"workspace": "your-workspace-slug",
"token": "your-app-password",
},
}
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 wachtwoord voor de App 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 ingeschakeld.
HIDE_VERSION¶
Added in version 4.3.1.
Verbergt informatie over de versie voor niet geauthenticeerde gebruikers. Dit zorgt er ook voor dat alle koppelingen voor documentatie verwijzen naar de laatste versie, in plaats van naar de documentatie die overeenkomt met de momenteel geïnstalleerde versie.
Verbergen van de versie is een aanbevolen beveiligingsmaatregel voor sommige bedrijven, voorkomt echter niet dat een aanvaller de versie uitvogelt door te proberen.
Notitie
Dit is standaard uitgeschakeld.
INTERLEDGER_PAYMENT_POINTERS¶
Added in version 4.12.1.
Lijst van Interledger Payment Pointers (ILPs) voor Web Monetization.
Indien meerdere zijn gespecificeerd wordt het delen van probabilistische opbrengst bereikt door er willekeurig een te kiezen.
Bekijk <https://webmonetization.org/> voor meer details.
Hint
De standaardwaarde laat gebruikers Weblate zelf financieren.
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/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 Wettelijk 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 Wettelijk 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
Elke definitie van een licentie zou een tuple moeten zijn met zijn verkorte naam, een lange naam en een URL.
Bijvoorbeeld:
LICENSE_EXTRA = [
(
"AGPL-3.0",
"GNU Affero General Public License v3.0",
"https://www.gnu.org/licenses/agpl-3.0-standalone.html",
),
]
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¶
Deze instellingen configureren de add-on JavaScript-vertaling CDN. LOCALIZE_CDN_URL definieert de bron-URL waar de CDN voor de vertaling beschikbaar is en LOCALIZE_CDN_PATH definieert het pad waar Weblate gegenereerde bestanden zouden moeten opslaan die zullen worden geserveerd op de LOCALIZE_CDN_URL.
Hint
Op Hosted Weblate gebruikt dit https://weblate-cdn.com/.
Zie ook
LOGIN_REQUIRED_URLS¶
Een lijst met URL’s waarvoor u inloggen vereist. (Naast de ingebouwde standaard regels in Weblate).
Hint
Dit stelt u in staat een gehele installatie met een wachtwoord te beveiligen met:
LOGIN_REQUIRED_URLS = (r"/(.*)$",)
REST_FRAMEWORK["DEFAULT_PERMISSION_CLASSES"] = [
"rest_framework.permissions.IsAuthenticated"
]
Hint
Het is gewenst om ook toegang tot de API te vergrendelen, zoals weergegeven in bovenstaand voorbeeld.
Zie ook
LOGIN_REQUIRED_URLS_EXCEPTIONS¶
Lijst met uitzonderingen voor LOGIN_REQUIRED_URLS. Indien niet gespecificeerd is gebruikers toegang toegestaan tot de inlogpagina.
Bekijk de Voorbeeld configuratie voor de aanbevolen configuratie van deze instelling.
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.
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 Wettelijk 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}".
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 de e-mail 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_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_NUMERIC¶
Added in version 4.16.2.
Weiger het gebruiken van numeriek IP-adres op de projectwebsite. 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.
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.
Indien ingeschakeld wordt een CAPTCHA toegevoegd aan alle pagina’s waar gebruikers hun e-mailadres invoeren:
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_MAX_NUMBER.
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_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 LOGIN_REQUIRED_URLS in en configureert REST framework om authenticatie te vereisen voor alle eindpunten van de API.
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_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.
SUGGESTION_CLEANUP_DAYS¶
Verwijdert automatisch suggesties na een bepaald aantal dagen. Standaard None, wat betekent dat er niets verwijderd wordt.
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.
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_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_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.GettextCustomizeAddon",
"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.json.JSONCustomizeAddon",
"weblate.addons.xml.XMLCustomizeAddon",
"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.yaml.YAMLCustomizeAddon",
"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.
Zie ook
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.
Zie ook
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.
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.
COMMENT_CLEANUP_DAYS¶
Verwijder opmerkingen na een opgegeven aantal dagen. Standaard
None, wat betekent dat er niets verwijderd wordt.