Konfiguration¶

Alle Einstellungen werden in settings.py gespeichert (wie bei Django üblich).

Bemerkung

Nachdem Sie eine dieser Einstellungen geändert haben, müssen Sie Weblate neu starten – sowohl WSGI- als auch Celery-Prozesse.

Wenn es als mod_wsgi ausgeführt wird, müssen Sie Apache neu starten, um die Konfiguration neu zu laden.

Siehe auch

Bitte lesen Sie auch die Django-Dokumentation für Parameter zur Konfiguration von Django selbst.

ADMINS_CONTACT¶

Legt fest, wohin das Kontaktformular E-Mails sendet. Wenn nicht konfiguriert, werden die E-Mail-Adressen aus ADMINS verwendet.

Konfigurieren Sie dies als eine Liste von E-Mail-Adressen:

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

Siehe auch

CONTACT_FORM, ADMINS

AKISMET_API_KEY¶

Weblate kann Akismet verwenden, um eingehende anonyme Übersetzungsvorschläge auf Spam zu prüfen. Besuchen Sie akismet.com, um einen API-Schlüssel zu erwerben und ihn mit einer Plattform zu verknüpfen.

ALTCHA_MAX_NUMBER¶

Added in version 5.9.

Konfiguriert eine maximale Zahl für den ALTCHA-Proof-of-Work-Mechanismus.

Siehe auch

ALTCHA-Proof-of-Work-Mechanismus

ANONYMOUS_USER_NAME¶

Benutzername von Benutzern, die nicht angemeldet sind.

Siehe auch

Zugriffssteuerung

AUDITLOG_EXPIRY¶

Wie viele Tage Weblate Audit-Protokolle (die Informationen über Kontoaktivitäten enthalten) aufbewahren soll.

Der Standardwert ist 180 Tage.

AUTH_LOCK_ATTEMPTS¶

Maximale Anzahl von fehlgeschlagenen Authentifizierungsversuchen, bevor die Ratenbegrenzung angewendet wird.

Dies wird derzeit an den folgenden Standorten angewandt:

Anmelden. Löscht das Passwort des Kontos und verhindert, dass sich der Benutzer anmelden kann, ohne ein neues Passwort anzufordern.
Passwort zurücksetzen. Verhindert, dass neue E-Mails gesendet werden, damit die Benutzer nicht mit zu vielen Versuchen, ihr Passwort zurückzusetzen, belästigt werden.

Der Standardwert ist 10.

Siehe auch

Ratenbegrenzung

AUTO_UPDATE¶

Tägliche Aktualisierung aller Repositorys.

Hinweis

Nützlich, wenn Sie Benachrichtigungs-Hooks nicht verwenden, um Weblate-Repositorys automatisch zu aktualisieren.

Bemerkung

Aus Gründen der Abwärtskompatibilität gibt es neben der Auswahl der Zeichenkette auch Ein/Aus-Optionen.

Die Optionen sind:

"none": Keine täglichen Aktualisierungen.
"remote" auch False: Nur Remote-Repositorys aktualisieren.
"full" auch True: Remote-Repositorys aktualisieren und Arbeitskopien zusammenführen.

Bemerkung

Dies setzt voraus, dass Hintergrundaufgaben mit Celery funktioniert, und wird nach einem Neustart wirksam.

AVATAR_URL_PREFIX¶

Präfix für den Aufbau von Avatar-URLs als: ${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS}. Die folgenden Dienste sind dafür bekannt, dass sie funktionieren:

Gravatar (Standard), wie unter https://gravatar.com/: AVATAR_URL_PREFIX = 'https://www.gravatar.com/'
Libravatar, wie unter https://www.libravatar.org/: AVATAR_URL_PREFIX = 'https://www.libravatar.org/'

Siehe auch

Avatar-Caching, ENABLE_AVATARS, Avatare

AUTH_TOKEN_VALID¶

Dauer der Gültigkeit des Authentifizierungstokens und des temporären Passworts aus E-Mails zum Passwort zurücksetzen. Wird in Sekunden angegeben, Standardwert ist 172800 (2 Tage).

AUTH_PASSWORD_DAYS¶

Für wie viele Tage Weblate die Wiederverwendung eines zuvor verwendeten Passworts für einen Benutzer ablehnt.

Die Überprüfung basiert auf dem Audit-Protokoll, AUDITLOG_EXPIRY muss mindestens so hoch sein wie diese Einstellung.

Bemerkung

Passwortänderungen, die vor Weblate 2.15 vorgenommen wurden, werden in dieser Richtlinie nicht berücksichtigt.

Der Standardwert ist 180 Tage.

AUTOFIX_LIST¶

Liste der automatischen Korrekturen, die beim Speichern einer Zeichenkette anzuwenden sind.

Bemerkung

Geben Sie einen vollqualifizierten Pfad zu der Python-Klasse an, welche die Autofixer-Schnittstelle implementiert.

Verfügbare Korrekturen:

weblate.trans.autofixes.whitespace.SameBookendingWhitespace: Passt Leerzeichen am Anfang und Ende der Zeichenkette an die Ausgangszeichenkette an.
weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis: Ersetzt nachgestellte Punkte (…), wenn die Ausgangszeichenkette entsprechende Auslassungspunkte (…) enthält.
weblate.trans.autofixes.chars.RemoveZeroSpace: Entfernt breitenlose Leerzeichen, wenn die Ausgangszeichenkette keine enthält.
weblate.trans.autofixes.chars.RemoveControlChars: Entfernt Steuerzeichen, wenn die Ausgangszeichenkette keine enthält.
weblate.trans.autofixes.chars.DevanagariDanda: Ersetzt den Satzpunkt in Bangla durch das Devanagari-Danda-Zeichen.
weblate.trans.autofixes.html.BleachHTML: Entfernt unsichere HTML-Auszeichnungen von Zeichenketten, die als safe-html markiert sind (siehe Unsicheres HTML).

Sie können auswählen, welche verwendet werden sollen:

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

Siehe auch

Automatische Korrekturen, Benutzerdefinierte automatische Korrekturen

BACKGROUND_TASKS¶

Added in version 4.5.2.

Legt fest, wie oft langwierige Wartungsmaßnahmen für eine Komponente ausgelöst werden sollen.

Im Moment steuert dies:

Automatische Übersetzung-Erweiterung
Überprüfungen und Korrekturen-Neuberechnung

Mögliche Auswahlmöglichkeiten:

monthly (dies ist die Standardeinstellung)
weekly
daily
never

Bemerkung

Es wird nicht empfohlen, die Häufigkeit zu erhöhen, wenn Weblate Tausende von Komponenten enthält.

BASIC_LANGUAGES¶

Added in version 4.4.

Liste der Sprachen, die den Benutzern für den Start einer neuen Übersetzung angeboten werden. Wenn nichts angegeben ist, wird eine integrierte Liste verwendet (die alle gängigen Sprachen enthält, aber keine länderspezifischen Varianten).

Dies schränkt nur nicht-berechtigte Benutzer ein, unerwünschte Sprachen hinzuzufügen. Den Projektadministratoren steht nach wie vor die gesamte Auswahl der in Weblate definierten Sprachen zur Verfügung.

Bemerkung

Damit werden keine neuen Sprachen für Weblate definiert – es werden nur die in der Datenbank vorhandenen gefiltert.

Beispiel:

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

Siehe auch

Sprachdefinitionen

BORG_EXTRA_ARGS¶

Added in version 4.9.

Es können zusätzliche Argumente an borg create übergeben werden, wenn integrierte Sicherungen ausgelöst werden.

Beispiel:

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

Siehe auch

Sichern und Verschieben von Weblate, borg create

CACHE_DIR¶

Added in version 4.16.

Das Verzeichnis, in dem Weblate Cache-Dateien speichert. Standardmäßig ist dies der Unterordner cache in DATA_DIR.

Ändern Sie dies in lokales oder temporäres Dateisystem, wenn DATA_DIR auf einem Netzwerk-Dateisystem liegt.

Der Docker-Container verwendet dafür ein eigenes Volume, siehe Docker-Container-Volumes.

Üblicherweise existieren folgende Unterverzeichnisse:

fonts: font-config-Cache für Schriftarten verwalten.
avatar: Zwischengespeicherte Benutzer-Avatare, siehe Avatare.
static: Standardspeicherort für statische Django-Dateien, angegeben durch STATIC_ROOT. Siehe Bereitstellung statischer Dateien.
tesseract: OCR-trainierte Daten für Visueller Kontext für Zeichenketten.

CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC¶

Passt den Content-Security-Policy-Header für Weblate an. Der Header wird automatisch auf der Grundlage aktivierter Integrationen mit Drittanbieterdiensten (Matomo, Google Analytics, Sentry, …) erzeugt.

Alle diese Listen sind standardmäßig leer.

Beispiel:

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

Siehe auch

Richtlinie zur Inhaltssicherheit, Content Security Policy (CSP)

CHECK_LIST¶

Liste der an einer Übersetzung durchzuführenden Qualitätsprüfungen.

Bemerkung

Geben Sie einen vollqualifizierten Pfad zu der Python-Klasse an, welche die Prüfschnittstelle implementiert.

Passen Sie die Liste der Qualitätsprüfungen an die für Sie relevanten Prüfungen an.

Alle integrierten Qualitätsprüfungen sind standardmäßig eingeschaltet, von wo aus Sie diese Einstellungen ändern können. Standardmäßig sind sie in der Beispielkonfiguration auskommentiert, so dass Standardwerte verwendet werden. Für jede neue Weblate-Version werden dann neue Qualitätsprüfungen durchgeführt.

Sie können alle Qualitätsprüfungen deaktivieren:

CHECK_LIST = ()

Sie können nur einige wenige einschalten:

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

Bemerkung

Eine Änderung dieser Einstellung wirkt sich nur auf neu geänderte Übersetzungen aus. Bestehende Qualitätsprüfungen werden weiterhin in der Datenbank gespeichert. Um auch Änderungen an den gespeicherten Übersetzungen vorzunehmen, führen Sie updatechecks aus.

Siehe auch

Qualitätsprüfungen, Anpassen des Verhaltens mit Markierungen

COMMENT_CLEANUP_DAYS¶

Anzahl der Tage bis Kommentare gelöscht werden. Der Standardwert ist None, was bedeutet, dass überhaupt nicht gelöscht wird.

COMMIT_PENDING_HOURS¶

Anzahl der Stunden zwischen Commits von ausstehenden Änderungen durch die Hintergrundaufgabe.

Siehe auch

Komponentenkonfiguration, Alter der Änderungen, bis ein Commit erfolgt, Ausführen von Wartungsaufgaben, commit_pending

CONTACT_FORM¶

Added in version 4.6.

Legt fest, wie E-Mails aus dem Kontaktformular gesendet werden sollen. Wählen Sie eine Konfiguration, die der Konfiguration Ihres Mailservers entspricht.

"reply-to": Der Absender wird in Reply-To verwendet, dies ist das Standardverhalten.
"from": Der Absender wird in From verwendet. Ihr Mailserver muss den Versand solcher E-Mails erlauben.

Siehe auch

ADMINS_CONTACT

DATA_DIR¶

Der Ordner, in dem Weblate alle Daten speichert. Er enthält Links zu VCS-Repositorys, einen Volltextindex und verschiedene Konfigurationsdateien für externe Tools.

Üblicherweise existieren folgende Unterverzeichnisse:

home

Basisverzeichnis, das zum Aufrufen von Skripts verwendet wird.

ssh

SSH-Schlüssel und Konfiguration.

media

Standardspeicherort für Django-Mediendateien, angegeben durch MEDIA_ROOT. Enthält hochgeladene Bildschirmfotos, siehe Visueller Kontext für Zeichenketten.

vcs

Versionsverwaltungs-Repositorys für Übersetzungen.

backups

Tägliche Sicherungsdaten. Für Details sehen Sie sich bitte Ausgegebene Daten für Sicherungen an.

fonts:

Vom Benutzer hochgeladene Schriftarten, siehe Schriftarten verwalten.

cache

Verschiedene Caches. Kann mit CACHE_DIR an anderer Stelle platziert werden.

Der Docker-Container verwendet dafür ein eigenes Volume, siehe Docker-Container-Volumes.

Bemerkung

Dieses Verzeichnis muss für Weblate beschreibbar sein. Die Ausführung als WSGI bedeutet, dass der Benutzer www-data Schreibzugriff darauf haben sollte.

Der einfachste Weg, dies zu erreichen, ist, den Benutzer zum Eigentümer des Verzeichnisses zu machen:

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

Die Standardeinstellung ist /home/weblate/data, aber es wird erwartet, dass sie konfiguriert wird.

Siehe auch

Dateisystemberechtigungen, Sichern und Verschieben von Weblate, CACHE_DIR

DATABASE_BACKUP¶

Ob die Datenbanksicherungen als reiner Text oder komprimiert gespeichert, oder übersprungen werden sollen. Die zulässigen Werte sind:

"plain"
"compressed"
"none"

Siehe auch

Sichern und Verschieben von Weblate

DEFAULT_ACCESS_CONTROL¶

Die Standardeinstellung der Zugriffssteuerung für neue Projekte:

0: Öffentlich
1: Geschützt
100: Privat
200: Benutzerdefiniert

Verwenden Sie Benutzerdefiniert, wenn Sie die Zugriffssteuerungsliste manuell verwalten, d. h. sich nicht auf die interne Weblate-Verwaltung verlassen.

Siehe auch

Projekt-Zugriffssteuerung, Zugriffssteuerung

DEFAULT_AUTO_WATCH¶

Added in version 4.5.

Legt fest, ob Automatisch Projekte nach einem Beitrag beobachten für neue Benutzer aktiviert werden soll. Der Standardwert ist True.

Siehe auch

Benachrichtigungen

DEFAULT_RESTRICTED_COMPONENT¶

Added in version 4.1.

Der Standardwert für die Komponenteneinschränkung.

Siehe auch

Eingeschränkter Zugriff, Umfang der Teams

DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE¶

Voreingestellte Commit-Nachrichten für verschiedene Operationen, siehe Komponentenkonfiguration für Details.

Siehe auch

Auszeichnungsvorlage, Komponentenkonfiguration, Commit-, Add-, Delete-, Merge-, Erweiterungs- und Merge-Request-Nachrichten

DEFAULT_ADDONS¶

Standarderweiterungen, die für jede erstellte Komponente installiert werden.

Bemerkung

Diese Einstellung wirkt sich nur auf neu erstellte Komponenten aus.

Beispiel:

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

Siehe auch

install_addon, Erweiterungen, WEBLATE_ADDONS

DEFAULT_COMMITER_EMAIL¶

E-Mail-Adresse des Committers, standardmäßig noreply@weblate.org.

Siehe auch

DEFAULT_COMMITER_NAME

DEFAULT_COMMITER_NAME¶

Name des Committers, standardmäßig Weblate.

Siehe auch

DEFAULT_COMMITER_EMAIL

DEFAULT_LANGUAGE¶

Added in version 4.3.2.

Ausgangssprache für alle neuen Komponenten.

Der Standardwert ist en. Das entsprechende Sprachobjekt muss in der Datenbank vorhanden sein.

Siehe auch

Sprachdefinitionen, Ausgangssprache

DEFAULT_MERGE_STYLE¶

Git-Strategie für alle neuen Komponenten.

rebase – Standard
merge

Siehe auch

Komponentenkonfiguration, Git-Strategie

DEFAULT_SHARED_TM¶

Konfiguriert den Standardwert von Gemeinsamen Übersetzungsspeicher verwenden und Zu einem gemeinsamen Übersetzungsspeicher beitragen.

DEFAULT_TRANSLATION_PROPAGATION¶

Standardeinstellung für die Übersetzungsweitergabe, ist standardmäßig True.

Siehe auch

Komponentenkonfiguration, Weitergabe von Übersetzungen erlauben

DEFAULT_PULL_MESSAGE¶

Konfiguriert den Standardtitel und die Standardnachricht für Pull Requests.

ENABLE_AVATARS¶

Ob Gravatar-basierte Avatare für Benutzer aktiviert werden sollen. Standardmäßig eingeschaltet.

Avatare werden abgerufen und auf dem Server zwischengespeichert, wodurch das Risiko des Durchsickerns privater Informationen verringert und das Benutzererlebnis beschleunigt wird.

Siehe auch

Avatar-Caching, AVATAR_URL_PREFIX, Avatare

ENABLE_HOOKS¶

Ob anonyme Remote-Hooks eingeschaltet werden sollen.

Siehe auch

Benachrichtigungs-Hooks

ENABLE_HTTPS¶

Geändert in Version 5.7: Weblate erfordert jetzt https für WebAuthn-Unterstützung.

Ob Links per HTTPS oder HTTP an Weblate gesendet werden sollen. Diese Einstellung wirkt sich auf gesendete E-Mails und erzeugte absolute URLs aus.

In der Grundeinstellung wird dies auch für viele Django-Einstellungen im Rahmen von HTTPS verwendet – es aktiviert sichere Cookies, schaltet HSTS um oder aktiviert die Weiterleitung zu einer HTTPS-URL.

Die HTTPS-Weiterleitung könnte in einigen Fällen problematisch sein und Sie könnten auf ein Problem mit unendlicher Weiterleitung stoßen, wenn Sie einen Reverse-Proxy verwenden, der eine SSL-Terminierung durchführt und Protokoll-Header nicht korrekt an Django weitergibt. Bitte passen Sie Ihre Reverse-Proxy-Konfiguration so an, dass X-Forwarded-Proto- oder Forwarded-Header ausgegeben werden oder konfigurieren Sie SECURE_PROXY_SSL_HEADER, damit Django den SSL-Status korrekt erkennt.

Wenn dies deaktiviert ist, schlägt der Start von Weblate mit einem otp_webauthn.E031-Fehler fehl. Sie können diesen Fehler unterdrücken, indem Sie ihn zu SILENCED_SYSTEM_CHECKS hinzufügen, aber WebAuthn wird trotzdem nicht für Websites ohne HTTPS funktionieren.

Siehe auch

SESSION_COOKIE_SECURE, CSRF_COOKIE_SECURE, SECURE_SSL_REDIRECT, SECURE_PROXY_SSL_HEADER Seitendomain richtig einstellen

EXTRA_HTML_HEAD¶

Added in version 4.15.

Fügt eine zusätzliche Auszeichnung in den HTML-Header ein. Kann zum Beispiel für die Verifizierung der Eigentümerschaft einer Website verwendet werden:

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

Warnung

Die Zeichenkette wird nicht bereinigt, sondern unverändert in den HTML-Header eingefügt.

GET_HELP_URL¶

Added in version 4.5.2.

URL, unter der Unterstützung für Ihre Weblate-Instanz zu finden ist.

GITEA_CREDENTIALS¶

Added in version 4.12.

Liste der Zugangsdaten für Gitea-Server.

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

Das Konfigurationswörterbuch besteht aus Anmeldeinformationen, die für jeden API-Host definiert sind. Das Layout ist für fast alle Integrationen der Versionsverwaltung gleich und wird unter Zugangsdaten der Versionsverwaltung konfigurieren beschrieben.

Siehe auch

Gitea-Pull-Requests, Erstellen eines persönlichen Gitea-Zugangstokens

GITLAB_CREDENTIALS¶

Added in version 4.3.

Liste der Zugangsdaten für GitLab-Server.

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

Siehe auch

GitLab-Merge-Requests, GitLab: Persönliche Zugangstoken

GITHUB_CREDENTIALS¶

Added in version 4.3.

Liste der Zugangsdaten für GitHub-Server.

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

Bemerkung

Beim Erstellen eines fein abgestuften persönlichen Tokens gewähren Sie Lese- und Schreibzugriff auf Contents und Pull Requests.

Hinweis

Verwenden Sie api.github.com als API-Host für https://github.com/.

Siehe auch

GitHub-Pull-Requests, Erstellen eines persönlichen GitHub-Zugangstokens

BITBUCKETSERVER_CREDENTIALS¶

Added in version 4.16.

Liste der Zugangsdaten für Bitbucket-Server.

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

Siehe auch

Bitbucket-Server-Pull-Request, Bitbucket: HTTP-Zugangstoken

BITBUCKETCLOUD_CREDENTIALS¶

Added in version 5.8.

Liste der Zugangsdaten für Bitbucket-Cloud-Server.

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

Das Konfigurationswörterbuch besteht aus Anmeldeinformationen, die für jeden API-Host definiert sind. Der API-Host kann sich von dem unterscheiden, den Sie im Webbrowser verwenden, z. B. wird auf die GitHub-API als api.github.com zugegriffen.

Die folgende Konfiguration ist für jeden Host verfügbar:

username: API-Benutzer.
workspace: Der Benutzer-Workspace-Slug.
token: Das App-Passwort mit der Berechtigung pullrequest:write.

Zusätzliche Einstellungen, die hier nicht beschrieben sind, finden Sie unter Zugangsdaten der Versionsverwaltung konfigurieren.

Siehe auch

Bitbucket-Cloud-Pull-Requests, Ein App-Passwort erstellen <https://support.atlassian.com/bitbucket-cloud/docs/create-an-app-password/>, App-Passwort-Berechtigungen

AZURE_DEVOPS_CREDENTIALS¶

Added in version 5.2.

Liste der Zugangsdaten für Azure-DevOps-Server.

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

Die folgende Konfiguration ist für jeden Host verfügbar:

username: Der Name des Azure-DevOps-Projekts. Dies ist nicht der Name des Repositorys.
organization: Der Name der Organisation des Projekts.
workItemIds: Eine optionale Liste von Work-Item-IDs aus Ihrer Organisation. Wenn angegeben, werden neue Pull Requests mit diesen IDs versehen.
token: API-Token für den API-Benutzer, erforderlich.

Zusätzliche Einstellungen, die hier nicht beschrieben sind, finden Sie unter Zugangsdaten der Versionsverwaltung konfigurieren.

Siehe auch

Azure-DevOps-Pull-Request, Azure DevOps: Persönliche Zugangstoken

GOOGLE_ANALYTICS_ID¶

Google-Analytics-ID, um die Überwachung von Weblate mit Google Analytics zu aktivieren.

HIDE_REPO_CREDENTIALS¶

Blendet die Repository-Zugangsdaten auf der Weboberfläche aus. Falls Sie eine Repository-URL mit Benutzer und Passwort haben, wird Weblate diese ausblenden, wenn zugehörige Informationen den Benutzern angezeigt werden.

Zum Beispiel wird anstelle von https://Benutzer:Passwort@git.beispiel.de/repo.git nur https://git.beispiel.de/repo.git angezeigt. In ähnlicher Weise versucht es auch, VCS-Fehlermeldungen zu bereinigen.

Bemerkung

Standardmäßig eingeschaltet.

HIDE_VERSION¶

Added in version 4.3.1.

Versteckt Versionsinformationen vor nicht authentifizierten Benutzern. Dies führt auch dazu, dass alle Links zur Dokumentation auf die neueste Version verweisen, anstatt auf die Dokumentation, die der aktuell installierten Version entspricht.

Das Verstecken der Version ist in einigen Unternehmen eine empfohlene Sicherheitspraxis, es verhindert aber nicht, dass ein Angreifer die Version durch Ausprobieren des Verhaltens herausfinden kann.

Bemerkung

Diese Funktion ist standardmäßig ausgeschaltet.

INTERLEDGER_PAYMENT_POINTERS¶

Added in version 4.12.1.

Liste der Interledger Payment Pointers (ILPs) für Web-Monetarisierung.

Wenn mehrere angegeben werden, wird eine probabilistische Aufteilung der Einnahmen durch zufällige Auswahl erreicht.

Weitere Einzelheiten finden Sie unter <https://webmonetization.org/>.

Hinweis

Mit dem Standardwert können Benutzer Weblate selbst finanzieren.

IP_BEHIND_REVERSE_PROXY¶

Gibt an, ob Weblate hinter einem Reverse-Proxy ausgeführt wird.

Wenn auf True gesetzt, bezieht Weblate die IP-Adresse aus einem Header, der durch IP_PROXY_HEADER definiert ist.

Warnung

Vergewissern Sie sich, dass Sie tatsächlich einen Reverse-Proxy verwenden und dass dieser diesen Header setzt, da die Benutzer sonst die IP-Adresse fälschen können.

Bemerkung

Diese Funktion ist nicht standardmäßig eingeschaltet.

Siehe auch

Hinter einem Reverse-Proxy ausführen, Ratenbegrenzung, IP_PROXY_HEADER, IP_PROXY_OFFSET

IP_PROXY_HEADER¶

Gibt an, aus welchem Header Weblate die IP-Adresse beziehen soll, wenn IP_BEHIND_REVERSE_PROXY eingeschaltet ist.

Die Standardeinstellung ist HTTP_X_FORWARDED_FOR.

Siehe auch

Hinter einem Reverse-Proxy ausführen, Ratenbegrenzung, SECURE_PROXY_SSL_HEADER, IP_BEHIND_REVERSE_PROXY, IP_PROXY_OFFSET

IP_PROXY_OFFSET¶

Geändert in Version 5.0.1: Der Standardwert wurde von 1 auf -1 geändert.

Gibt an, welcher Teil von IP_PROXY_HEADER als Client-IP-Adresse verwendet wird.

Je nach Ihrer Einrichtung kann dieser Header aus mehreren IP-Adressen bestehen (z. B. X-Forwarded-For: client-ip, proxy-a, proxy-b) und Sie können hier konfigurieren, welche Adresse aus dem Header als Client-IP-Adresse verwendet wird.

Warnung

Diese Einstellung wirkt sich auf die Sicherheit Ihrer Installation aus. Sie sollten sie nur so konfigurieren, dass vertrauenswürdige Proxys zur Ermittlung der IP-Adresse verwendet werden. Weitere Einzelheiten finden Sie unter <https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For#security_and_privacy_concerns>.

Der Standardwert ist -1.

Siehe auch

Hinter einem Reverse-Proxy ausführen, Ratenbegrenzung, SECURE_PROXY_SSL_HEADER, IP_BEHIND_REVERSE_PROXY, IP_PROXY_HEADER

LEGAL_TOS_DATE¶

Added in version 4.15.

Bemerkung

Sie müssen Rechtliche Grundlagen installiert haben, damit dies funktioniert.

Datum der letzten Aktualisierung der Dokumente zu den Nutzungsbedingungen. Immer, wenn sich das Datum ändert, müssen die Nutzer den aktualisierten Nutzungsbedingungen zustimmen.

from datetime import date

LEGAL_TOS_DATE = date(2022, 2, 2)

LEGAL_URL¶

URL, unter der Ihre Weblate-Instanz ihre rechtlichen Dokumente anzeigt.

Hinweis

Nützlich, wenn Sie Ihre rechtlichen Dokumente außerhalb von Weblate hosten, um sie in Weblate einzubetten. Bitte schauen Sie sich Rechtliche Grundlagen für Details an.

Beispiel:

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

Siehe auch

PRIVACY_URL

LICENSE_EXTRA¶

Zusätzliche Lizenzen, die in die Lizenzauswahl einbezogen werden sollen.

Bemerkung

Jede Lizenzdefinition sollte ein Tupel aus einem Kurznamen, einem Langnamen und einer URL sein.

Zum Beispiel:

LICENSE_EXTRA = [
    (
        "AGPL-3.0",
        "GNU Affero General Public License v3.0",
        "https://www.gnu.org/licenses/agpl-3.0-standalone.html",
    ),
]

LICENSE_FILTER¶

Geändert in Version 4.3: Wenn Sie diesen Wert auf einen leeren Wert setzen, wird die Lizenzwarnung deaktiviert.

Filtert die Liste der anzuzeigenden Lizenzen. Dadurch wird auch die Lizenzwarnung deaktiviert, wenn sie auf leer gesetzt ist.

Bemerkung

Dieser Filter verwendet die kurzen Lizenznamen.

Zum Beispiel:

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

Folgendes deaktiviert die Lizenzwarnung:

LICENSE_FILTER = set()

Siehe auch

Warnungen der Übersetzungskomponente

LICENSE_REQUIRED¶

Legt fest, ob das Lizenzattribut in Komponentenkonfiguration erforderlich ist.

Bemerkung

Diese Funktion ist standardmäßig ausgeschaltet.

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH¶

Ob die Länge einer bestimmten Übersetzung begrenzt werden soll. Die Beschränkung ist die Länge der Ausgangszeichenkette × 10 Zeichen.

Hinweis

Setzen Sie dies auf False, um längere Übersetzungen (bis zu 10.000 Zeichen) unabhängig von der Länge der Ausgangszeichenkette zu ermöglichen.

Bemerkung

Der Standardwert ist True.

LOCALIZE_CDN_URL und LOCALIZE_CDN_PATH¶

Diese Einstellungen konfigurieren die JavaScript-Lokalisierungs-CDN-Erweiterung. LOCALIZE_CDN_URL definiert die Root-URL, unter der das Lokalisierungs-CDN verfügbar ist und LOCALIZE_CDN_PATH definiert den Pfad, unter dem Weblate die erzeugten Dateien speichern soll, die unter der LOCALIZE_CDN_URL ausgeliefert werden.

Hinweis

Hosted Weblate verwendet https://weblate-cdn.com/.

Siehe auch

JavaScript-Lokalisierungs-CDN

LOGIN_REQUIRED_URLS¶

Eine Liste von URLs, für die eine Anmeldung erforderlich sein soll. (Neben den in Weblate integrierten Standardregeln).

Hinweis

Damit können Sie eine ganze Installation mit einem Passwort schützen:

LOGIN_REQUIRED_URLS = (r"/(.*)$",)
REST_FRAMEWORK["DEFAULT_PERMISSION_CLASSES"] = [
    "rest_framework.permissions.IsAuthenticated"
]

Hinweis

Es ist wünschenswert, auch den API-Zugang zu sperren, wie im obigen Beispiel gezeigt.

Siehe auch

REQUIRE_LOGIN

MATOMO_SITE_ID¶

ID der Website in Matomo (ehemals Piwik), die Sie für die Nachverfolgung von Weblate verwenden möchten.

Bemerkung

Diese Integration unterstützt den Matomo Tag Manager nicht.

Siehe auch

MATOMO_URL

MATOMO_URL¶

Vollständige URL (einschließlich nachgestelltem Schrägstrich) einer Matomo (ehemals Piwik)-Installation, um die Nutzung von Weblate nachzuverfolgen. Weitere Einzelheiten finden Sie unter <https://matomo.org/>.

Hinweis

Diese Integration unterstützt den Matomo Tag Manager nicht.

Zum Beispiel:

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

Siehe auch

MATOMO_SITE_ID

NEARBY_MESSAGES¶

Anzahl der benachbarten Zeichenketten, die im vollständigen Editor in jeder Richtung angezeigt werden sollen.

Dies ist nur ein Standardwert, Benutzer können dies im Benutzerprofil anpassen.

DEFAULT_PAGE_LIMIT¶

Added in version 4.7.

Standardanzahl der Elemente, die bei aktivem Seitenumbruch angezeigt werden.

PAGURE_CREDENTIALS¶

Added in version 4.3.2.

Liste der Zugangsdaten für Pagure-Server.

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

Siehe auch

Pagure-Merge-Requests, Pagure-API

PRIVACY_URL¶

Added in version 4.8.1.

URL, unter der Ihre Weblate-Instanz die Datenschutzerklärung anzeigt.

Hinweis

Nützlich, wenn Sie Ihre rechtlichen Dokumente außerhalb von Weblate hosten, um sie in Weblate einzubetten. Bitte schauen Sie sich Rechtliche Grundlagen für Details an.

Beispiel:

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

Siehe auch

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN¶

Added in version 4.15.

Legt fest, ob es sich bei der privaten Commit-E-Mail um eine Opt-In- oder Opt-Out-E-Mail handelt (standardmäßig ist sie Opt-In).

Hinweis

Diese Einstellung gilt nur für Benutzer, die nicht explizit eine Commit-E-Mail ausgewählt haben.

Siehe auch

Benutzerprofil, PRIVATE_COMMIT_EMAIL_TEMPLATE

PRIVATE_COMMIT_EMAIL_TEMPLATE¶

Added in version 4.15.

Vorlage zur Erstellung einer privaten E-Mail für einen Benutzer. Der Standardwert ist "{username}@users.noreply.{site_domain}".

Zum Deaktivieren ein leere Zeichenkette einsetzen.

Bemerkung

Die Verwendung anderer Commit-E-Mails ist für Benutzer freiwillig, es sei denn, sie werden durch PRIVATE_COMMIT_EMAIL_OPT_IN konfiguriert. Benutzer können Commit-E-Mails im Profil konfigurieren.

PROJECT_BACKUP_KEEP_COUNT¶

Added in version 4.14.

Legt fest, wie viele Sicherungen pro Projekt auf dem Server gespeichert werden. Der Standardwert ist 3.

Siehe auch

Sicherungen auf Projektebene

PROJECT_BACKUP_KEEP_DAYS¶

Added in version 4.14.

Legt fest, wie lange die Projektsicherungen auf dem Server aufbewahrt werden sollen. Die Standardeinstellung ist 30 Tage.

Siehe auch

Sicherungen auf Projektebene

PROJECT_NAME_RESTRICT_RE¶

Added in version 4.15.

Definiert einen regulären Ausdruck zur Einschränkung der Projektbenennung. Alle übereinstimmenden Namen werden abgelehnt.

Siehe auch

Projektname

PROJECT_WEB_RESTRICT_HOST¶

Added in version 4.16.2.

Verhindert das Benutzen von gewissen Hosts auf der Projektwebsite. Jede Subdomain wird abgeglichen, d. h. beim Blockieren von example.com wird auch test.example.com blockiert. Die Liste sollte nur kleingeschriebene Zeichenfolgen enthalten, die zu vergleichende Domain wird vor dem Prüfen kleingeschrieben.

Standardkonfiguration:

PROJECT_WEB_RESTRICT_HOST = {"localhost"}

Siehe auch

Projektseite PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_RE,

PROJECT_WEB_RESTRICT_NUMERIC¶

Added in version 4.16.2.

Verhindert die Nutzung von numerischen IP-Adressen auf der Projektwebsite. Standardmäßig eingeschaltet.

Siehe auch

Projektseite PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_RE,

PROJECT_WEB_RESTRICT_RE¶

Added in version 4.15.

Definiert einen regulären Ausdruck zur Einschränkung von Projekt-Websites. Alle übereinstimmenden URLs werden abgelehnt.

Siehe auch

Projektseite PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC

RATELIMIT_ATTEMPTS¶

Maximale Anzahl von Authentifizierungsversuchen, bevor die Ratenbegrenzung angewendet wird.

Der Standardwert ist 5.

Siehe auch

Ratenbegrenzung, RATELIMIT_WINDOW, RATELIMIT_LOCKOUT

RATELIMIT_WINDOW¶

Wie lange die Authentifizierung nach angewendeter Ratenbegrenzung akzeptiert wird.

Eine Anzahl von Sekunden, standardmäßig 300 (5 Minuten).

Siehe auch

Ratenbegrenzung, RATELIMIT_ATTEMPTS, RATELIMIT_LOCKOUT

RATELIMIT_LOCKOUT¶

Wie lange die Authentifizierung nach angewendeter Ratenbegrenzung gesperrt ist.

Eine Anzahl von Sekunden, standardmäßig 600 (10 Minuten).

Siehe auch

Ratenbegrenzung, RATELIMIT_ATTEMPTS, RATELIMIT_WINDOW

REGISTRATION_ALLOW_BACKENDS¶

Added in version 4.1.

Liste der Authentifizierungs-Backends, von denen aus die Registrierung erlaubt werden soll. Dies schränkt nur neue Registrierungen ein, Benutzer können sich weiterhin über alle konfigurierten Authentifizierungs-Backends authentifizieren und Authentifizierungen hinzufügen.

Es wird empfohlen, REGISTRATION_OPEN eingeschaltet zu lassen, während man die Registrierungs-Backends einschränkt. Andernfalls können sich Benutzer zwar registrieren, aber Weblate zeigt keine Links zur Registrierung in der Bedienoberfläche an.

Beispiel:

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

Hinweis

Die Backend-Namen entsprechen den in der URL für die Authentifizierung verwendeten Namen.

Siehe auch

REGISTRATION_OPEN, Authentifizierung

REGISTRATION_CAPTCHA¶

Ob die Registrierung von neuen Konten durch ein CAPTCHA geschützt ist. Standardmäßig aktiviert.

Wenn diese Option aktiviert ist, wird ein CAPTCHA zu allen Seiten hinzugefügt, auf denen ein Benutzer seine E-Mail-Adresse eingibt:

Registrierung eines neuen Kontos.
Passwortwiederherstellung.
E-Mail zu einem Konto hinzufügen.
Kontaktformular für nicht angemeldete Benutzer.

Der Schutz besteht aktuell aus folgenden Schritten:

Mathematisches Captcha, das vom Benutzer gelöst werden muss.
Vom Browser berechnete Proof-of-Work-Challenge. Die Schwierigkeit kann mit ALTCHA_MAX_NUMBER angepasst werden.

REGISTRATION_EMAIL_MATCH¶

Hier können Sie filtern, welche E-Mail-Adressen sich registrieren können.

Die Standardeinstellung ist .*, sodass sich jede beliebige E-Mail-Adresse registrieren kann.

Sie können damit die Registrierung auf eine einzige E-Mail-Domain beschränken:

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

REGISTRATION_OPEN¶

Ob die Registrierung von neuen Konten derzeit erlaubt ist. Standardmäßig aktiviert.

Diese Einstellung wirkt sich auf die integrierte Authentifizierung per E-Mail-Adresse oder über Python Social Auth aus (Sie können bestimmte Backends mit REGISTRATION_ALLOW_BACKENDS auf eine Positivliste setzen).

Bemerkung

Bei der Verwendung von Authentifizierungsmethoden von Drittanbietern, wie z. B. LDAP-Authentifizierung, wird lediglich das Registrierungsformular ausgeblendet, aber neue Benutzer können sich möglicherweise trotzdem anmelden und Konten erstellen.

Siehe auch

REGISTRATION_ALLOW_BACKENDS, REGISTRATION_EMAIL_MATCH, Authentifizierung

REGISTRATION_REBIND¶

Added in version 4.16.

Erlaubt das erneute Binden von Authentifizierungs-Backends für bestehende Benutzer. Aktivieren Sie dies, wenn Sie zwischen Authentifizierungsanbietern migrieren.

Bemerkung

Standardmäßig ausgeschaltet, um das Hinzufügen anderer Authentifizierungs-Backends zu einem bestehenden Konto zu verhindern. Eine erneute Bindung kann zu einer Kompromittierung des Kontos führen, wenn mehr Authentifizierungs-Backends von Drittanbietern verwendet werden.

REPOSITORY_ALERT_THRESHOLD¶

Added in version 4.0.2.

Schwellenwert für die Auslösung einer Warnung bei veralteten Repositorys oder zu viele Änderungen enthaltende Repositorys. Der Standardwert ist 25.

Siehe auch

Warnungen der Übersetzungskomponente

REQUIRE_LOGIN¶

Added in version 4.1.

Dies aktiviert LOGIN_REQUIRED_URLS und konfiguriert das REST-Framework so, dass eine Authentifizierung für alle API-Endpunkte erforderlich ist.

Bemerkung

Dies ist in der Beispielkonfiguration implementiert. Für Docker, verwenden Sie WEBLATE_REQUIRE_LOGIN.

SENTRY_DSN¶

Sentry-DSN zur Verwendung für das Sammeln von Fehlerberichten und Überwachen der Leistung.

Siehe auch

Django-Integration für Sentry

SENTRY_ENVIRONMENT¶

Konfiguriert die Umgebung für Sentry. Der Standardwert ist devel.

SENTRY_PROFILES_SAMPLE_RATE¶

Konfiguriert die Abtastrate für die Leistungsüberwachung. Auf 1 setzen, um alle Ereignisse zu verfolgen, 0 (Standard) deaktiviert die Verfolgung.

Siehe auch

Sentry-Leistungsüberwachung

SENTRY_SEND_PII¶

Ermöglicht Sentry, bestimmte personenbezogene Informationen zu sammeln. Standardmäßig ausgeschaltet.

Geändert in Version 5.7: Diese Funktion ist jetzt standardmäßig deaktiviert, früher war sie standardmäßig aktiviert.

SENTRY_TRACES_SAMPLE_RATE¶

Konfiguriert die Abtastrate für die Profilüberwachung. Auf 1 setzen, um alle Ereignisse zu verfolgen, 0 (Standard) deaktiviert die Verfolgung.

Siehe auch

Sentry-Profiling

SIMPLIFY_LANGUAGES¶

Um einfache Sprachcodes für Standard-Sprach/Länder-Kombinationen zu verwenden. Zum Beispiel wird eine fr_FR-Übersetzung den fr Sprachcode verwenden. Dies ist normalerweise das gewünschte Verhalten, da es die Auflistung von Sprachen für diese Standardkombinationen vereinfacht.

Deaktivieren Sie diese Option, wenn Sie für jede Variante eine andere Übersetzung wünschen.

SITE_DOMAIN¶

Konfiguriert die Seitendomain. Notwendig, um in vielen Bereichen (z. B. Aktivierungs-E-Mails, Benachrichtigungen oder RSS-Feeds) korrekte absolute Links zu erzeugen.

Wenn Weblate auf einem nicht standardmäßigen Port läuft, geben Sie ihn hier ebenfalls an.

Beispiele:

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

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

Bemerkung

Diese Einstellung sollte nur den Domainnamen enthalten. Für die Konfiguration des Protokolls (Einschalten und Erzwingen von HTTPS) verwenden Sie ENABLE_HTTPS und zum Ändern der URL verwenden Sie URL_PREFIX.

Hinweis

In einem Docker-Container wird die Seitendomain über WEBLATE_ALLOWED_HOSTS konfiguriert.

Siehe auch

Seitendomain richtig einstellen, Einrichtung zulässiger Hosts, HTTPS richtig konfigurieren WEBLATE_SITE_DOMAIN, ENABLE_HTTPS

SITE_TITLE¶

Seitentitel, der für die Website und gesendete E-Mails verwendet werden soll.

SPECIAL_CHARS¶

Zusätzliche Zeichen, die in die visuelle Tastatur aufgenommen werden sollen, Visuelle Tastatur.

Der Standardwert ist:

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

SINGLE_PROJECT¶

Leitet Benutzer direkt zu einem Projekt oder einer Komponente um, anstatt die Übersichtsseite anzuzeigen. Sie können es entweder auf True setzen, so dass es nur funktioniert, wenn es tatsächlich nur ein einziges Projekt in Weblate gibt. Alternativ können Sie auch den Projekt-Slug angeben, dann wird bedingungslos zu diesem Projekt umgeleitet.

Beispiel:

SINGLE_PROJECT = "test"

SSH_EXTRA_ARGS¶

Added in version 4.9.

Ermöglicht das Hinzufügen benutzerdefinierter Parameter, wenn Weblate SSH aufruft. Nützlich, wenn Sie sich mit Servern verbinden, die eine ältere Verschlüsselung oder andere nicht standardisierte Funktionen verwenden.

Wenn zum Beispiel die SSH-Verbindung in Weblate mit der Meldung Unable to negotiate with legacyhost: no matching key exchange method found. Their offer: diffie-hellman-group1-sha1, können Sie dies aktivieren mit:

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

Hinweis

Die Zeichenkette wird von der Shell ausgewertet, also achten Sie darauf, dass alle Leer- und Sonderzeichen in Anführungszeichen gesetzt werden.

Siehe auch

OpenSSH-Legacy-Optionen

STATUS_URL¶

Die URL, unter der Ihre Weblate-Instanz ihren Status meldet.

SUGGESTION_CLEANUP_DAYS¶

Löscht Vorschläge automatisch nach einer bestimmten Anzahl von Tagen. Der Standardwert ist None, was bedeutet, dass keine Löschungen vorgenommen werden.

SUPPORT_STATUS_CHECK¶

Added in version 5.5.

Deaktiviert die halbjährliche Prüfung des Support-Status und leitet Superuser beim Anmelden auf die Spendenseite um, wenn kein aktives Abonnement besteht.

Hinweis

Verbessern Sie Ihre Weblate-Erfahrung, indem Sie ein Support-Abonnement abschließen und den Fortschritt von Weblate fördern, anstatt diese Funktion zu deaktivieren.

UNUSED_ALERT_DAYS¶

Added in version 4.17.

Legt fest, wann die Warnung Die Komponente scheint nicht verwendet zu werden ausgelöst wird.

Standardmäßig 365 Tage, zum Ausschalten auf 0 setzen.

UPDATE_LANGUAGES¶

Added in version 4.3.2.

Steuert, ob die Sprachdatenbank bei der Datenbankmigration aktualisiert werden soll und ist standardmäßig eingeschaltet. Diese Einstellung hat keinen Einfluss auf den Aufruf von setuplang.

Warnung

Die Anzeige der Sprachen kann dadurch inkonsistent werden. Die Sprachdefinitionen von Weblate werden im Laufe der Zeit erweitert und es werden keine Sprachcodes für die definierten Sprachen angezeigt.

Siehe auch

Integrierte Sprachdefinitionen

URL_PREFIX¶

Mit dieser Einstellung können Sie Weblate unter einem bestimmten Pfad ausführen (andernfalls muss es vom Webserver-Root aus gestartet werden).

Bemerkung

Um diese Einstellung zu verwenden, müssen Sie auch Ihren Server so konfigurieren, dass er dieses Präfix entfernt. Bei WSGI kann dies zum Beispiel durch die Einstellung WSGIScriptAlias erreicht werden.

Hinweis

Das Präfix sollte mit einem / beginnen.

Beispiel:

URL_PREFIX = "/translations"

Bemerkung

Diese Einstellung funktioniert nicht mit dem in Django integrierten Server, Sie müssen urls.py so anpassen, dass es dieses Präfix enthält.

VCS_API_DELAY¶

Added in version 4.15.1.

Konfiguriert die minimale Verzögerung in Sekunden zwischen API-Aufrufen von Drittanbietern in GitHub-Pull-Requests, GitLab-Merge-Requests, Gitea-Pull-Requests, Pagure-Merge-Requests, und Azure-DevOps-Pull-Request.

Dadurch werden die API-Aufrufe von Weblate an diese Dienste begrenzt, um sie nicht zu überlasten.

Wenn Sie durch den sekundären Ratenbegrenzer bei GitHub eingeschränkt sind, könnte eine Erhöhung dieses Wertes helfen.

Der Standardwert ist 10.

VCS_BACKENDS¶

Konfiguration der verfügbaren VCS-Backends.

Bemerkung

Weblate versucht, alle unterstützten Backends zu verwenden, für die Sie die Werkzeuge haben.

Hinweis

Sie können damit die Auswahl einschränken oder eigene VCS-Backends hinzufügen.

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

Siehe auch

Integration der Versionsverwaltung

VCS_CLONE_DEPTH¶

Legt fest, wie tief das Klonen von Repositorys in Weblate gehen soll.

Bemerkung

Derzeit wird dies nur in Git unterstützt. Standardmäßig führt Weblate flache Klone der Repositorys aus, um das Klonen zu beschleunigen und Speicherplatz zu sparen. Je nach Nutzung (z. B. bei der Verwendung von benutzerdefinierten Erweiterungen) kann es sinnvoll sein, die Tiefe zu erhöhen oder flache Klone komplett abzuschalten, indem man den Wert 0 setzt.

Hinweis

Falls Sie beim Pushen von Weblate die Fehlermeldung fatal: protocol error: expected old/new/ref, got 'shallow <commit hash>' erhalten, schalten Sie flache Klone komplett aus, durch Einstellung von:

VCS_CLONE_DEPTH = 0

WEBLATE_ADDONS¶

Liste der zur Verwendung verfügbaren Erweiterungen. Um sie zu verwenden, müssen sie für eine bestimmte Übersetzungskomponente aktiviert werden. Standardmäßig sind alle integrierten Erweiterungen enthalten. Wenn Sie die Liste erweitern, werden Sie wahrscheinlich vorhandene Erweiterungen aktiviert lassen wollen, z. B.:

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

Bemerkung

Wenn Sie die Erweiterung aus der Liste entfernen, wird es nicht aus den Komponenten deinstalliert. Weblate wird in diesem Fall abstürzen. Bitte deinstallieren Sie die Erweiterung aus allen Komponenten, bevor Sie es aus dieser Liste entfernen.

Siehe auch

Erweiterungen, DEFAULT_ADDONS, ADDON_ACTIVITY_LOG_EXPIRY

ADDON_ACTIVITY_LOG_EXPIRY¶

Added in version 5.6.

Legt fest, wie lange Aktivitätsprotokolle für Erweiterungen aufbewahrt werden. Standardmäßig 180 Tage.

WEBLATE_EXPORTERS¶

Added in version 4.2.

Liste der verfügbaren Exporter, die das Herunterladen von Übersetzungen oder Glossaren in verschiedenen Dateiformaten anbieten.

Siehe auch

Unterstützte Dateiformate

WEBLATE_FORMATS¶

Liste der Dateiformate, die verwendet werden können.

Bemerkung

Die Standardliste enthält bereits die gängigen Formate.

Siehe auch

Unterstützte Dateiformate

WEBLATE_MACHINERY¶

Added in version 4.13.

Liste der zur Verfügung stehenden Maschinendienste.

Siehe auch

Automatische Vorschläge

WEBLATE_GPG_IDENTITY¶

Identität, die von Weblate zum Signieren von Git-Commits verwendet wird, zum Beispiel:

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

Der Weblate-GPG-Keyring wird nach einem passenden Schlüssel durchsucht (home/.gnupg unter DATA_DIR). Wenn er nicht gefunden wird, wird ein Schlüssel erzeugt, siehe Git-Commits mit GnuPG signieren für weitere Details.

Siehe auch

Git-Commits mit GnuPG signieren

WEBSITE_REQUIRED¶

Legt fest, ob Projektseite beim Erstellen eines Projekts angegeben werden muss. Standardmäßig eingeschaltet, da dies für öffentliche Serverkonfigurationen geeignet ist.

Zugangsdaten der Versionsverwaltung konfigurieren¶

Hinweis

Dieser Abschnitt beschreibt Variablen von VCS-Zugangsdaten wie GITHUB_CREDENTIALS, GITLAB_CREDENTIALS, GITEA_CREDENTIALS, PAGURE_CREDENTIALS, BITBUCKETSERVER_CREDENTIALS.

Die Zugangsdaten können auch in Repository-Push-URL oder Quellcode-Repository überschrieben werden (falls die Push-URL nicht konfiguriert wurde), diese haben Vorrang vor den in der Konfigurationsdatei angegebenen Daten.

Die folgende Konfiguration ist für jeden Host verfügbar:

username: API-Benutzer, erforderlich.
token: API-Token für den API-Benutzer, erforderlich.
scheme: Added in version 4.18.

Schema überschreiben. Weblate versucht, das Schema aus der URL des Repositorys zu analysieren und greift auf https zurück. Wenn Sie den API-Server intern betreiben, können Sie stattdessen http verwenden, aber beachten Sie die Sicherheit.

Hinweis

Im Docker-Container können die Zugangsdaten mithilfe von Umgebungsvariablen konfiguriert werden, siehe Anmeldedaten für Code-Hosting-Sites.

Konfiguration¶

ADMINS_CONTACT¶

AKISMET_API_KEY¶

ALTCHA_MAX_NUMBER¶

ANONYMOUS_USER_NAME¶

AUDITLOG_EXPIRY¶

AUTH_LOCK_ATTEMPTS¶

AUTO_UPDATE¶

AVATAR_URL_PREFIX¶

AUTH_TOKEN_VALID¶

AUTH_PASSWORD_DAYS¶

AUTOFIX_LIST¶

BACKGROUND_TASKS¶

BASIC_LANGUAGES¶

BORG_EXTRA_ARGS¶

CACHE_DIR¶

CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC¶

CHECK_LIST¶

COMMENT_CLEANUP_DAYS¶

COMMIT_PENDING_HOURS¶

CONTACT_FORM¶

DATA_DIR¶

DATABASE_BACKUP¶

DEFAULT_ACCESS_CONTROL¶

DEFAULT_AUTO_WATCH¶

DEFAULT_RESTRICTED_COMPONENT¶

DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE¶

DEFAULT_ADDONS¶

DEFAULT_COMMITER_EMAIL¶

DEFAULT_COMMITER_NAME¶

DEFAULT_LANGUAGE¶

DEFAULT_MERGE_STYLE¶

DEFAULT_SHARED_TM¶

DEFAULT_TRANSLATION_PROPAGATION¶

DEFAULT_PULL_MESSAGE¶

ENABLE_AVATARS¶

ENABLE_HOOKS¶

ENABLE_HTTPS¶

ENABLE_SHARING¶

EXTRA_HTML_HEAD¶

GET_HELP_URL¶

GITEA_CREDENTIALS¶

GITLAB_CREDENTIALS¶

GITHUB_CREDENTIALS¶

BITBUCKETSERVER_CREDENTIALS¶

BITBUCKETCLOUD_CREDENTIALS¶

AZURE_DEVOPS_CREDENTIALS¶

GOOGLE_ANALYTICS_ID¶

HIDE_REPO_CREDENTIALS¶

HIDE_VERSION¶

INTERLEDGER_PAYMENT_POINTERS¶

IP_BEHIND_REVERSE_PROXY¶

IP_PROXY_HEADER¶

IP_PROXY_OFFSET¶

LEGAL_TOS_DATE¶

LEGAL_URL¶

LICENSE_EXTRA¶

LICENSE_FILTER¶

LICENSE_REQUIRED¶

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH¶

LOCALIZE_CDN_URL und LOCALIZE_CDN_PATH¶

LOGIN_REQUIRED_URLS¶

LOGIN_REQUIRED_URLS_EXCEPTIONS¶

MATOMO_SITE_ID¶

MATOMO_URL¶

NEARBY_MESSAGES¶

DEFAULT_PAGE_LIMIT¶

PAGURE_CREDENTIALS¶

PRIVACY_URL¶

PRIVATE_COMMIT_EMAIL_OPT_IN¶

PRIVATE_COMMIT_EMAIL_TEMPLATE¶

PROJECT_BACKUP_KEEP_COUNT¶

PROJECT_BACKUP_KEEP_DAYS¶

PROJECT_NAME_RESTRICT_RE¶

PROJECT_WEB_RESTRICT_HOST¶

PROJECT_WEB_RESTRICT_NUMERIC¶

PROJECT_WEB_RESTRICT_RE¶

RATELIMIT_ATTEMPTS¶

RATELIMIT_WINDOW¶

RATELIMIT_LOCKOUT¶