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

ALLOWED_ASSET_DOMAINS

Added in version 5.14.

Legt fest, welche Domains zum Abrufen von Assets in Weblate zugelassen sind.

Dies erhöht die Sicherheit, da das Laden von Inhalten aus nicht vertrauenswürdigen Quellen verhindert wird. Assets werden einmal vom Weblate-Server heruntergeladen und lokal gespeichert, anstatt direkt von externen Domains an die Benutzer ausgeliefert zu werden.

Die Positivliste wird auf die ursprüngliche URL und auf jedes Ziel einer HTTP-Weiterleitung angewendet, bevor Weblate dieser folgt. Weiterleitungen zu Hosts außerhalb dieser Liste werden abgelehnt.

Es wird eine Liste von Host/Domain-Namen erwartet. Sie können voll qualifizierte Namen verwenden (z. B. www.example.com) oder einen Punkt als Platzhalter voranstellen, um alle Subdomains zu finden (z. B. .example.com passt zu cdn.example.com oder static.example.com).

Der Standardwert ist ["*"], der alle Domains zulässt.

Beispiel

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

Dies wird derzeit an folgenden Stellen verwendet:

Siehe auch

ALLOWED_MACHINERY_DOMAINS

Legt fest, welche benutzerdefinierten Domains von Maschinendiensten in der Konfiguration der maschinellen Übersetzungen auf Projektebene explizit erlaubt sind.

Diese Einstellung gilt nur für Maschinendienste und hat keinen Einfluss auf ALLOWED_ASSET_DOMAINS.

Es wird eine Liste von Host/Domain-Namen erwartet. Sie können voll qualifizierte Namen verwenden oder einen Punkt als Platzhalter voranstellen, um alle Subdomains zu finden.

Der Standardwert ist [].

Die Positivliste wirkt sich auf zwei Arten auf projektverwaltete Maschinendienste aus: Sie lässt den konfigurierten Endpunkt während der Validierung ausgehender Verbindungen zu und markiert übereinstimmende Hosts als vertrauenswürdig, wenn es darum geht zu entscheiden, ob dem Benutzer Fehlerdetails oder Antwortinhalte von Remote-Anbietern angezeigt werden können. Bei direkten Verbindungen lehnen die Laufzeitprüfungen weiterhin Ziele ab, die auf private oder anderweitig nicht-öffentliche Adressen verweisen. Wenn ein HTTP(S)-Proxy verwendet wird, greift die Laufzeitvalidierung auf die Validierung des Rechnernamens zurück und führt nicht die gleichen lokalen DNS- oder Peer-IP-Prüfungen durch.

ALLOWED_ASSET_SIZE

Added in version 5.14.

Konfiguriert das Größenlimit für den Abruf von Assets in Weblate. Der Standardwert ist 10 MB.

Siehe auch

ASSET_PRIVATE_ALLOWLIST

Added in version 2025.5.

Defines hostnames or domains exempt from ASSET_RESTRICT_PRIVATE for remote asset downloads that enforce private-target checks. Entries follow Django host matching semantics, so values such as assets.internal.example or .internal.example can be used.

This does not replace ALLOWED_ASSET_DOMAINS; remote assets must still match the asset domain allowlist.

Standardkonfiguration:

ASSET_PRIVATE_ALLOWLIST = []

Siehe auch

ASSET_RESTRICT_PRIVATE

Added in version 2025.5.

Reject remote asset URLs pointing to internal or non-public addresses unless the target host is included in ASSET_PRIVATE_ALLOWLIST. On by default.

When enabled, hostnames that cannot be resolved during validation are rejected unless they are explicitly included in ASSET_PRIVATE_ALLOWLIST. This currently applies to screenshot URL uploads and remote HTML downloads for the JavaScript-Lokalisierungs-CDN add-on.

Siehe auch

ALTCHA_COST

Added in version 5.18.

Argon2id time cost for the ALTCHA proof-of-work challenge. Defaults to 3.

Replaces ALTCHA_MAX_NUMBER, which applied to the removed ALTCHA widget v2.

ALTCHA_MEMORY_COST

Added in version 5.18.

Argon2id memory cost in KiB. Defaults to 65536.

ALTCHA_PARALLELISM

Added in version 5.18.

Argon2id parallelism factor. Defaults to 1.

Siehe auch

ALTCHA-Proof-of-Work-Mechanismus

ANONYMOUS_USER_NAME

Benutzername von Benutzern, die nicht angemeldet sind.

Siehe auch

Zugriffssteuerung

AUDITLOG_EXPIRY

Die maximale Anzahl von Tagen, die Weblate Auditprotokolle mit Informationen über die Kontoaktivitäten aufbewahrt.

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

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 Auditprotokoll, 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.

Die verfügbaren Korrekturen sind unter Automatische Korrekturen beschrieben.

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

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

Siehe auch

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:

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

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.

Weblate stores generated helper files here and executes some of them, so CACHE_DIR has to be writable and mounted on a filesystem that allows execution. Avoid using noexec mount options for this directory.

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

Üblicherweise existieren folgende Unterverzeichnisse:

ssh

Generated helper files used for VCS access.

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 Statische Dateien bereitstellen.

tesseract

OCR-trainierte Daten für Bildschirmfotos und visueller Kontext.

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

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

COMMIT_PENDING_HOURS

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

Siehe auch

COMPONENT_ZIP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Legt die maximale Größe in Bytes für hochgeladene ZIP-Dateien von Komponenten fest. Der Standardwert ist 50 MB.

In Docker konfigurieren Sie dies mit der Umgebungsvariable WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE.

Siehe auch

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"

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"

Deaktiviert das Kontaktformular vollständig.

Added in version 5.15.

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 für den Aufruf von Skripten verwendet wird.

ssh

SSH-Schlüssel und Konfiguration.

media

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

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

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

Weblate sichern und verschieben

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

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

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

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

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

DEFAULT_MERGE_STYLE

Git-Strategie für alle neuen Komponenten.

  • rebase – Standard

  • merge

Siehe auch

DEFAULT_SHARED_TM

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

DEFAULT_TRANSLATION_REVIEW

Added in version 5.16.

Konfiguriert den Standardwert von Überprüfung aktivieren, standardmäßig ausgeschaltet.

DEFAULT_SOURCE_REVIEW

Added in version 5.16.

Konfiguriert den Standardwert von Quellenüberprüfung aktivieren, standardmäßig ausgeschaltet.

DEFAULT_AUTOCLEAN_TM

Added in version 5.13.

Konfiguriert den Standardwert von Übersetzungsspeicher automatisch bereinigen.

DEFAULT_TRANSLATION_PROPAGATION

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

Siehe auch

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 auf dem Server abgerufen und zwischengespeichert, was das Risiko der Weitergabe privater Informationen verringert und das Nutzungserlebnis verbessert.

Siehe auch

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

ENABLE_SHARING

Schaltet das Menü Community ein oder aus, damit Benutzer den Übersetzungsfortschritt in sozialen Netzwerken teilen können.

Siehe auch

Die Übersetzungscommunity aufbauen

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

GITLAB_CREDENTIALS

Added in version 4.3.

Liste der Zugangsdaten für GitLab-Server.

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

Bemerkung

Das persönliche Zugangstoken benötigt die Berechtigung api, um die API nutzen zu können.

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

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

Es ist möglich, sowohl fein abgestufte persönliche Zugangstoken als auch klassische persönliche Zugangstoken zu verwenden. Die fein abgestuften Token sind auf eine einzelne Organisation beschränkt. Daher funktionieren sie nicht, wenn Weblate ein Repository außerhalb der Organisation (normalerweise in den Benutzernamensraum) forken soll.

Um Pull Requests zu klonen, zu pushen und zu erstellen, ist der Lese- und Schreibzugriff auf Contents und Pull requests erforderlich.

Administration kann für das Forken eines Repositorys auch notwendig sein, wenn Sie Forken verwenden möchten und das ursprüngliche Repository nicht öffentlich ist.

Hinweis

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

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

BITBUCKETSERVER_CREDENTIALS

Added in version 4.16.

Liste der Zugangsdaten für Bitbucket Data Center.

BITBUCKETSERVER_CREDENTIALS = {
    "git.self-hosted.com": {
        "username": "weblate",
        "token": "http-access-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

BITBUCKETCLOUD_CREDENTIALS

Added in version 5.8.

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

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

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 API-Token mit der Berechtigung pullrequest:write.

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

Siehe auch

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

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

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

GOOGLE_ANALYTICS_ID

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

Bemerkung

Die Integration von Google Analytics 4 ist aktuell nicht für Weblate verfügbar, siehe https://github.com/WeblateOrg/weblate/issues/14015.

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.

VERSION_DISPLAY

Added in version 5.17.

Steuert, wie prominent Weblate seine eigene Version offenlegt.

Unterstützte Werte sind:

show

Die Version in der gemeinsamen Bedienoberfläche (z. B. in der Fußzeile) anzeigen und in GET /api/metrics/ bereitstellen.

soft

Die Version in der sichtbaren gemeinsamen Bedienoberfläche ausblenden, während sie auf der Seite Über und unter GET /api/metrics/ auffindbar bleibt.

hide

Die Version in der gemeinsamen Bedienoberfläche und GET /api/metrics/ ausblenden. Dies führt auch dazu, dass anonyme Links zur Dokumentation auf die neueste Dokumentation verweisen und nicht auf die Version, die der installierten Version entspricht.

Das Verbergen der Version ist eine empfohlene Sicherheitspraxis in einigen Unternehmen, aber es verhindert nicht, dass ein Angreifer die Version durch Sondierungsverhalten herausfinden kann.

Bemerkung

Der Standard ist show.

HIDE_VERSION

Added in version 4.3.1.

Veraltet ab Version 5.17.

Kompatibilitäts-Alias für VERSION_DISPLAY. Auf True setzen, um das gleiche Verhalten wie VERSION_DISPLAY = "hide" zu erhalten.

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

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

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/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns>.

Der Standardwert ist -1.

Siehe auch

LICENSE_EXTRA

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

Bemerkung

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.

Zum Beispiel:

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

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

Übersetzungskomponente-Warnungen

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

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

Hinweis

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

Siehe auch

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

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

PASSWORD_MINIMAL_STRENGTH

Added in version 5.10.2.

Minimaler Passwortwert, wie er vom zxcvbn-Passwortstärke-Schätzer ermittelt wurde.

Der Standardwert ist 0, d. h. die Prüfung der Stärke ist deaktiviert.

Siehe auch

PASSWORD_RESET_URL

Added in version 5.17.

URL für das Zurücksetzen des Passworts, wenn die Authentifizierung über einen externen Identitätsanbieter erfolgt, wie LDAP, SAML oder OAuth.

Wenn eingestellt, verlinkt Passwort vergessen? auf der Anmeldeseite auf diese URL anstatt auf die in Weblate integrierte Seite zum Zurücksetzen des Passworts.

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

PRIVATE_COMMIT_EMAIL_TEMPLATE

Added in version 4.15.

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

Sie kann {user_id}, {username}, {site_title}, und {site_domain} enthalten.

Zum Deaktivieren ein leere Zeichenkette einsetzen.

Bemerkung

Das Verwenden einer anderen Commit-E-Mail ist für Benutzer freiwillig, es sei denn, sie wird durch PRIVATE_COMMIT_EMAIL_OPT_IN konfiguriert. Benutzer können ihre Commit-E-Mails im Benutzerprofil konfigurieren.

PRIVATE_COMMIT_NAME_OPT_IN

Added in version 5.16.

Legt fest, ob der private Commit-Name Opt-In- oder Opt-Out ist(standardmäßig ist er Opt-In).

Hinweis

Diese Einstellung gilt nur für Benutzer, die nicht explizit einen Commit-Namen ausgewählt haben.

Siehe auch

PRIVATE_COMMIT_NAME_TEMPLATE

Added in version 5.16.

Vorlage zur Erstellung eines privaten Commit-Namens für einen Benutzer. Der Standardwert ist "{site_title} user {user_id}".

Sie kann {user_id}, {username}, {site_title}, und {site_domain} enthalten.

Zum Deaktivieren ein leere Zeichenkette einsetzen.

Bemerkung

Das Verwenden eines anderen Commit-Namens ist für Benutzer freiwillig, es sei denn, er wird durch PRIVATE_COMMIT_NAME_OPT_IN konfiguriert. Benutzer können ihren Commit-Namen im Benutzerprofil 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_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 konfigurieren Sie dies mit der Umgebungsvariable WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE. Docker-Einrichtungen können auch durch CLIENT_MAX_BODY_SIZE eingeschränkt werden; andere Bereitstellungen können durch die Größenbeschränkung der Reverse-Proxy-Anfrage eingeschränkt werden.

Siehe auch

Sicherungen auf Projektebene

PROJECT_BACKUP_IMPORT_MAX_MEMBERS

Added in version 5.17.

Legt die maximale Anzahl von ZIP-Einträgen fest, die beim Importieren einer Projektsicherung zulässig sind.

Dies dient als Schutz vor fehlerhaften oder absichtlich fragmentierten Archiven. Die Standardeinstellung ist 100.000 Einträge.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS environment variable.

Siehe auch

Sicherungen auf Projektebene

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

Dies schränkt Archive ein, die beim Hochladen klein sind, aber während der Validierung oder Wiederherstellung auf viel mehr Daten anwachsen.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE environment variable.

Siehe auch

Sicherungen auf Projektebene

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE

Added in version 5.17.

Legt die maximale unkomprimierte Größe in Bytes für einen einzelnen hochkomprimierten ZIP-Eintrag in einer importierten Projektsicherung fest.

Dieses Limit gilt nur für Einträge, die groß genug und ausreichend komprimiert sind, um verdächtig zu wirken. Große Dateien mit geringer Komprimierung sind hier bewusst erlaubt und werden voraussichtlich durch das HTTP-Upload-Limit eingeschränkt. Der Standardwert ist 262.144.000 Bytes (250 MiB).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE environment variable.

Siehe auch

Sicherungen auf Projektebene

PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE

Added in version 5.17.

Legt die minimale unkomprimierte Größe in Bytes fest, ab der Weblate die ZIP-Komprimierung beim Import von Projektsicherungen berücksichtigt.

Kleinere Dateien werden bei der Validierung auf der Grundlage des Kompressionsverhältnisses ignoriert, um zu vermeiden, dass auch gut komprimierte Dateien von angemessener Größe zurückgewiesen werden. Der Standardwert ist 1048.576 Bytes (1 MiB).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE environment variable.

Siehe auch

Sicherungen auf Projektebene

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO

Added in version 5.17.

Legt das maximal zulässige Verhältnis zwischen der unkomprimierten und der komprimierten Größe für einen großen ZIP-Eintrag beim Import von Projektsicherungen fest.

Dies wird zusammen mit PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE und PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE verwendet, um verdächtig komprimierte Einträge zu erkennen, während große Repository-Paketdateien und andere gering komprimierte Inhalte weiterhin zugelassen werden. Der Standardwert ist 250.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO environment variable.

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

PROJECT_WEB_RESTRICT_ALLOWLIST

Added in version 5.17.

Definiert eine Reihe von Projekt-Slugs, die von PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_PRIVATE, und PROJECT_WEB_RESTRICT_RE ausgenommen sind, wenn die Projektwebsite validiert wird. Projekt-Slugs werden ohne Berücksichtigung der Groß- und Kleinschreibung abgeglichen.

Vorsicht

Diese Ausnahme schwächt den Schutz ausgehender URLs für entsprechende Projekte, einschließlich der durch PROJECT_WEB_RESTRICT_PRIVATE erzwungenen Einschränkung für private Ziele. Verwenden Sie dies nur für vertrauenswürdige, vom Administrator verwaltete Projekte, bei denen das Umgehen dieser Prüfungen beabsichtigt ist.

Standardkonfiguration:

PROJECT_WEB_RESTRICT_ALLOWLIST = set()

Siehe auch

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

PROJECT_WEB_RESTRICT_PRIVATE

Added in version 5.17.

Lehnt URLs der Projektwebsite und des Repository-Browsers ab, die auf interne oder nicht-öffentliche Adressen verweisen. Standardmäßig eingeschaltet.

Siehe auch

PROJECT_WEB_RESTRICT_RE

Added in version 4.15.

Definiert einen regulären Ausdruck, um einzuschränken, was als Projektwebsite eingegeben werden kann. Alle übereinstimmenden URLs werden abgelehnt.

Siehe auch

WEBHOOK_PRIVATE_ALLOWLIST

Added in version 5.17.

Definiert Hostnamen oder Domains, die von WEBHOOK_RESTRICT_PRIVATE für ausgehende Webhook-Zustellung ausgenommen sind. Die Einträge folgen der Semantik von Django für die Host-Übereinstimmung, sodass Werte wie hooks.internal.example oder .internal.example verwendet werden können.

Standardkonfiguration:

WEBHOOK_PRIVATE_ALLOWLIST = []

Siehe auch

WEBHOOK_RESTRICT_PRIVATE

Added in version 5.17.

Lehnt Webhook-URLs die auf interne oder nicht öffentliche Adressen verweisen ab, sofern der Ziel-Host nicht in WEBHOOK_PRIVATE_ALLOWLIST enthalten ist. Standardmäßig aktiviert.

Wenn aktiviert, werden Hostnamen, die beim Validieren nicht aufgelöst werden können, zurückgewiesen, sofern sie nicht explizit in WEBHOOK_PRIVATE_ALLOWLIST enthalten sind.

Siehe auch

PUBLIC_ENGAGE

Added in version 5.16.2.

Ermöglicht eine öffentliche Beteiligungsseite auch mit REQUIRE_LOGIN.

Siehe auch

RATELIMIT_NOTIFICATION_LIMITS

Added in version 5.14.

Begrenzt, wie viele Benachrichtigungen für einen einzelnen Benutzer verschickt werden.

Die Standardeinstellung ist:

# 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

Maximale Anzahl von Authentifizierungsversuchen, bevor die Ratenbegrenzung angewendet wird.

Der Standardwert ist 5.

Siehe auch

RATELIMIT_WINDOW

Wie lange die Authentifizierung nach angewendeter Ratenbegrenzung akzeptiert wird.

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

Siehe auch

RATELIMIT_LOCKOUT

Wie lange die Authentifizierung nach angewendeter Ratenbegrenzung gesperrt ist.

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

Siehe auch

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_CAPTCHA

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

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

  • Registrierung eines neuen Kontos.

  • Passwortwiederherstellung.

  • E-Mail-Adresse zu einem Konto hinzufügen.

  • Kontaktformular für nicht angemeldete Benutzer.

Der Schutz besteht aktuell aus folgenden Schritten:

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_ALLOW_DISPOSABLE_EMAILS

Added in version 5.16.1.

Ermöglicht die Registrierung mit Einweg-E-Mail-Domains. Bei Aktivierung wird die Sperrliste für Einweg-Domains umgangen. Der Standardwert ist False.

Siehe auch

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 über REGISTRATION_ALLOW_BACKENDS zulassen).

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

Übersetzungskomponente-Warnungen

REQUIRE_LOGIN

Added in version 4.1.

Damit wird django.contrib.auth.middleware.LoginRequiredMiddleware aktiviert und das REST-Framework so konfiguriert, dass für alle API-Endpunkte eine Authentifizierung erforderlich ist.

Geändert in Version 5.15: Weblate nutzt jetzt die integrierte Middleware von Django.

Bemerkung

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

SENTRY_DSN

Sentry-DSN zur Verwendung für das Fehlerberichte sammeln und Leistung überwachen.

Siehe auch

Django-Integration für Sentry

SENTRY_ENVIRONMENT

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

SENTRY_MONITOR_BEAT_TASKS

Added in version 5.13.

Konfiguriert, ob Celery-Beat-Aufgaben mit Sentry überwacht werden sollen. Der Standardwert ist True.

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.

HIDE_SHARED_GLOSSARY_COMPONENTS

Added in version 5.16.

Glossarkomponenten werden normalerweise mit anderen Projekte geteilt, damit sie für Übersetzungsarbeiten verfügbar sind. Wenn diese in der Komponentenliste von Projekten, die sie verwenden, sichtbar sind, kann dies zu Verwirrung führen oder Übersetzer von den eigentlichen Komponenten ablenken, die übersetzt werden sollen.

Diese Funktion ist standardmäßig deaktiviert, so dass die gemeinsamen Komponenten des Glossars sichtbar sind.

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

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.

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.

TRANSLATION_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Legt die maximale Größe in Bytes für hochgeladene Übersetzungsdateien fest. Der Standardwert ist 50 MB.

In Docker konfigurieren Sie dies mit der Umgebungsvariable WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE.

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_ALLOW_HOSTS

Added in version 5.15.

Ein Satz von Hosts, die bei der Konfiguration der VCS-URL zugelassen werden. Der Standardwert ist ein leerer Satz, der überhaupt keine Filterung vornimmt.

Wenn VCS_RESTRICT_PRIVATE aktiviert ist, sind übereinstimmende Hosts ebenfalls von der Beschränkung auf private Ziele ausgenommen.

VCS_ALLOW_SCHEMES

Added in version 5.15.

Ein Satz von URL-Schemata, die bei der Konfiguration der VCS-URL zugelassen werden. Standardmäßig sind nur https und ssh zugelassen.

VCS_RESTRICT_PRIVATE

Added in version 5.17.

Lehnt VCS-Repository-URLs die auf interne oder nicht öffentliche Adressen verweisen ab, sofern der Ziel-Host nicht in VCS_ALLOW_HOSTS enthalten ist. Standardmäßig aktiviert.

Wenn aktiviert, werden Hostnamen, die beim Validieren nicht aufgelöst werden können, zurückgewiesen, sofern sie nicht explizit in VCS_ALLOW_HOSTS enthalten sind.

VCS_API_DELAY

Added in version 4.15.1.

Configures minimal delay in seconds between third-party API calls in GitHub-Pull-Requests, GitLab-Merge-Requests, Gitea-Pull-Requests, Pagure-Merge-Requests, and Azure-DevOps-Pull-Requests.

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_API_TIMEOUT

Added in version 5.15.

Configures timeout in seconds for third-party API calls such as forking or creating merge requests in GitHub-Pull-Requests, GitLab-Merge-Requests, Gitea-Pull-Requests, Pagure-Merge-Requests, and Azure-DevOps-Pull-Requests.

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

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

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

Lokalisierungsdateiformate

WEBLATE_FORMATS

Liste der Dateiformate, die verwendet werden können.

Bemerkung

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

Siehe auch

Lokalisierungsdateiformate

WEBLATE_MACHINERY

Added in version 4.13.

Liste der zur Verfügung stehenden Maschinendienste.

Siehe auch

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 Projektwebsite beim Erstellen eines Projekts angegeben werden muss. Standardmäßig eingeschaltet, da dies für öffentliche Serverkonfigurationen geeignet ist.

WEBSITE_ALERTS_ENABLED

Added in version 5.17.

Standardwert: True

Legt fest, ob Weblate die Verfügbarkeit von Projektwebsites prüfen und Warnungen für nicht erreichbare Projektwebsites anzeigen soll.

Wenn auf False gesetzt, überspringt Weblate Prüfungen der Website-Verfügbarkeit und generiert keine Projektwebsite-Warnungen. Dies ist nützlich, wenn:

  • Ihre Websites sich hinter Firewalls befinden, welche die Anfragen von Weblate blockieren

  • Sie möchten Fehler vom Typ 403/503 aufgrund des Bot-Schutzes vermeiden

  • Die Verfügbarkeit der Projektwebsite ist für Ihre Installation nicht von Belang

Siehe auch

WEBSITE_REQUIRED

Zugangsdaten der Versionsverwaltung konfigurieren

Hinweis

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

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 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 Zugangsdaten für Code-Hosting-Sites.