Konfiguration#
Alle Einstellungen werden in settings.py gespeichert (wie bei Django üblich).
Bemerkung
After changing any of these settings, you need to restart Weblate — both WSGI and Celery processes.
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.
AKISMET_API_KEY#
Weblate kann Akismet verwenden, um eingehende anonyme Vorschläge auf Spam zu überprüfen. Besuchen Sie akismet.com, um einen API-Schlüssel zu erwerben und ihn mit einer Website zu verknüpfen.
ANONYMOUS_USER_NAME#
Benutzername von Benutzern, die nicht angemeldet sind.
Siehe auch
AUDITLOG_EXPIRY#
Neu in Version 3.6.
How many days Weblate should keep audit logs (which contain info about account activity).
Der Standardwert ist 180 Tage.
AUTH_LOCK_ATTEMPTS#
Maximale Anzahl der fehlgeschlagenen Authentifizierungsversuche, bevor die Ratenbegrenzung angewendet wird.
Dies wird derzeit an den folgenden Standorten angewandt:
Anmelden. Löscht das Kennwort des Kontos und verhindert, dass sich der Benutzer anmelden kann, ohne ein neues Kennwort anzufordern.
Password reset. Prevents new e-mails from being sent, avoiding spamming users with too many password-reset attempts.
Der Standardwert ist 10.
Siehe auch
AUTO_UPDATE#
Neu in Version 3.2.
Geändert in Version 3.11: Die ursprüngliche Option „Ein/Aus“ wurde geändert, um zu unterscheiden, welche Zeichenketten akzeptiert werden.
Aktualisiert täglich alle 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"auchFalseAktualisieren Sie nur Remotes.
"full"auchTrueAktualisieren Sie Remotes und führen Sie Arbeitskopien zusammen.
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 Kennworts aus E-Mails zum Zurücksetzen des Kennworts. Wird in Sekunden angegeben, Standardwert ist 172800 (2 Tage).
AUTH_PASSWORD_DAYS#
How many days Weblate rejects reusing a previously used password for a user.
Die Prü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
Provide a fully-qualified path to the Python class that implements the autofixer interface.
Verfügbare Korrekturen:
weblate.trans.autofixes.whitespace.SameBookendingWhitespacePasst Leerzeichen am Anfang und Ende der Zeichenkette an die Ausgangszeichenkette an.
weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsisErsetzt nachgestellte Punkte (…), wenn die Ausgangszeichenkette entsprechende Auslassungspunkte (…) enthält.
weblate.trans.autofixes.chars.RemoveZeroSpaceEntfernt Leerzeichen ohne Breite, wenn die Ausgangszeichenkette keine enthält.
weblate.trans.autofixes.chars.RemoveControlCharsEntfernt Steuerzeichen, wenn die Ausgangszeichenkette keine enthält.
weblate.trans.autofixes.chars.DevanagariDandaReplaces sentence full stop in Bangla by the devanagari danda character.
weblate.trans.autofixes.html.BleachHTMLEntfernt unsichere HTML-Auszeichnungen aus Zeichenketten, die als
safe-htmlgekennzeichnet 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",
)
BACKGROUND_TASKS#
Neu 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)weeklydailynever
Bemerkung
Es wird nicht empfohlen, die Häufigkeit zu erhöhen, wenn Weblate Tausende von Komponenten enthält.
BASIC_LANGUAGES#
Neu in Version 4.4.
List of languages to offer users for starting a new translation. When not specified, a built-in list is used (which includes all commonly used languages, but without country specific variants).
This only limits non privileged users to add unwanted languages. Project admins are still presented with the full selection of languages defined in Weblate.
Bemerkung
This does not define new languages for Weblate — it only filters existing ones in the database.
Beispiel:
BASIC_LANGUAGES = {"cs", "it", "ja", "en"}
Siehe auch
BORG_EXTRA_ARGS#
Neu in Version 4.9.
Sie können zusätzliche Argumente an borg create übergeben, wenn integrierte Backups ausgelöst werden.
Beispiel:
BORG_EXTRA_ARGS = ["--exclude", "vcs/"]
Siehe auch
CACHE_DIR#
Neu 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.
CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC#
Passen Sie den Header Content-Security-Policy für Weblate an. Die Kopfzeile wird automatisch auf der Grundlage der aktivierten Integrationen mit Diensten von Drittanbietern (Matomo, Google Analytics, Sentry, …) generiert.
Alle diese Listen sind standardmäßig leer.
Beispiel:
# Enable Cloudflare Javascript optimizations
CSP_SCRIPT_SRC = ["ajax.cloudflare.com"]
CHECK_LIST#
Liste der an einer Übersetzung durchzuführenden Qualitätsprüfungen.
Bemerkung
Geben Sie einen vollqualifizierten Pfad zu der Python-Klasse an, die die Prüfschnittstelle implementiert.
Passen Sie die Liste der Qualitätsprüfungen an die für Sie relevanten Prüfungen an.
All built-in Qualitätsprüfungen are turned on by default, from where you can change these settings. By default they are commented out in Beispielkonfiguration so that default values are used. New checks are then carried out for each new Weblate version.
Sie können alle Qualitätsprüfungen deaktivieren:
CHECK_LIST = ()
Sie können nur ein paar einschalten:
CHECK_LIST = (
"weblate.checks.chars.BeginNewlineCheck",
"weblate.checks.chars.EndNewlineCheck",
"weblate.checks.chars.MaxLengthCheck",
)
Bemerkung
Changing this setting only affects newly changed translations. Existing checks
will still be stored in the database. To also apply changes to the stored translations, run
weblate updatechecks.
COMMIT_PENDING_HOURS#
Anzahl der Stunden zwischen Commits von ausstehenden Änderungen durch die Hintergrundaufgabe.
CONTACT_FORM#
Neu in Version 4.6.
Configures how e-mail from the contact form is being sent. Choose a configuration that matches the configuration of your mail server.
"reply-to"Der Absender wird in Reply-To verwendet, dies ist das Standardverhalten.
"from"Der Absender wird in From verwendet. Ihr Mail-Server muss den Versand solcher E-Mails erlauben.
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:
homeBasisverzeichnis, das zum Aufrufen von Skripts verwendet wird.
sshSSH-Schlüssel und Konfiguration.
staticStandardspeicherort für statische Django-Dateien, angegeben durch
STATIC_ROOT. Siehe Bereitstellung statischer Dateien.Der Docker-Container verwendet dafür ein eigenes Volume, siehe Docker-Container-Volumes.
mediaStandardspeicherort für Django-Mediendateien, angegeben durch
MEDIA_ROOT. Enthält hochgeladene Bildschirmfotos, siehe Bildschirmfotos.vcsVersionsverwaltung-Repositorys für Übersetzungen.
backupsDaily backup data. Please check Gedumpte Daten für Backups for details.
fonts:Vom Benutzer hochgeladene Schriftarten, siehe Schriftarten verwalten.
cacheVarious caches. Can be placed elsewhere using
CACHE_DIR.Der Docker-Container verwendet dafür ein eigenes Volume, siehe Docker-Container-Volumes.
Bemerkung
Dieses Verzeichnis muss von Weblate beschreibbar sein. Die Ausführung als uWSGI 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.
DATABASE_BACKUP#
Neu in Version 3.1.
Ob die Datenbank-Backups als reiner Text oder komprimiert gespeichert oder übersprungen werden sollen, die zulässigen Werte sind:
"plain""compressed""none"
Siehe auch
DEFAULT_ACCESS_CONTROL#
Neu in Version 3.3.
The default access-control setting for new projects:
0Öffentlich
1Geschützt
100Privat
200Benutzerdefiniert
Verwenden Sie Benutzerdefiniert, wenn Sie die ACL manuell verwalten, d. h. sich nicht auf die interne Weblate-Verwaltung verlassen.
Siehe auch
DEFAULT_AUTO_WATCH#
Neu in Version 4.5.
Konfiguriert, ob Projekte nach Beitrag automatisch beobachten für neue Benutzer aktiviert werden soll. Der Standardwert ist True.
Siehe auch
DEFAULT_RESTRICTED_COMPONENT#
Neu 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.
DEFAULT_ADDONS#
Default add-ons to install for every created component.
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#
Committer e-mail address, defaulting to noreply@weblate.org.
Siehe auch
DEFAULT_COMMITER_NAME#
Committer name, defaulting to Weblate.
Siehe auch
DEFAULT_LANGUAGE#
Neu 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#
Neu in Version 3.4.
Git-Strategie für alle neuen Komponenten.
rebase – Standard
merge
Siehe auch
DEFAULT_TRANSLATION_PROPAGATION#
Standardeinstellung für die Übersetzungsweitergabe, ist standardmäßig ‚‘True‘‘.
DEFAULT_PULL_MESSAGE#
Konfiguriert den Standardtitel und die Standardnachricht für Pull Requests.
ENABLE_AVATARS#
Whether to turn on Gravatar-based avatars for users. On by default.
Avatare werden abgerufen und auf dem Server zwischengespeichert, wodurch das Risiko des Durchsickerns privater Informationen verringert und das Benutzererlebnis beschleunigt wird.
Siehe auch
ENABLE_HOOKS#
Whether to turn on anonymous remote hooks.
Siehe auch
ENABLE_HTTPS#
Ob Links per HTTPS oder HTTP an Weblate gesendet werden sollen. Diese Einstellung wirkt sich auf gesendete E-Mails und generierte 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.
The HTTPS redirection might be problematic in some cases and you might hit
an issue with infinite redirection in case you are using a reverse proxy doing
an SSL termination which does not correctly pass protocol headers to Django.
Please tweak your reverse proxy configuration to emit X-Forwarded-Proto or
Forwarded headers or configure SECURE_PROXY_SSL_HEADER to
let Django correctly detect the SSL status.
ENABLE_SHARING#
Schalten Sie das Menü Teilen ein oder aus, damit Benutzer den Übersetzungsfortschritt in sozialen Netzwerken teilen können.
EXTRA_HTML_HEAD#
Neu in Version 4.15.
Fügen Sie zusätzliches Markup in den HTML-Header ein. Kann zum Beispiel für die Überprüfung der Eigentümerschaft einer Website verwendet werden:
EXTRA_HTML_HEAD = '<link href="https://fosstodon.org/@weblate" rel="me">'
Warnung
No sanitization is performed on the string. It is inserted as-is into the HTML header.
GET_HELP_URL#
Neu in Version 4.5.2.
URL, unter der Unterstützung für Ihre Weblate-Instanz zu finden ist.
GITEA_CREDENTIALS#
Neu in Version 4.12.
Liste der Zugangsdaten für Gitea-Server.
GITEA_CREDENTIALS = {
"try.gitea.io": {
"username": "weblate",
"token": "your-api-token",
},
}
The configuration dictionary consists of credentials defined for each API host.
The API host might be different from what you use in the web browser, for
example GitHub API is accessed as api.github.com.
The following configuration is available for each host:
usernameAPI user, required.
tokenAPI token for the API user, required.
schemeNeu in Version 4.18.
Scheme override. Weblate attempts to parse scheme from the repository URL and falls backs to
https. If you are running the API server internally, you might want to usehttpinstead, but consider security.
Hinweis
In the Docker container, the credentials are configured in three variables and the credentials are built out of that. An example configuration for GitHub might look like:
WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com
Will be used as:
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "api-user",
"token": "api-token",
}
}
GITLAB_CREDENTIALS#
Neu in Version 4.3.
Liste der Zugangsdaten für GitLab-Server.
GITLAB_CREDENTIALS = {
"gitlab.com": {
"username": "weblate",
"token": "your-api-token",
},
}
The configuration dictionary consists of credentials defined for each API host.
The API host might be different from what you use in the web browser, for
example GitHub API is accessed as api.github.com.
The following configuration is available for each host:
usernameAPI user, required.
tokenAPI token for the API user, required.
schemeNeu in Version 4.18.
Scheme override. Weblate attempts to parse scheme from the repository URL and falls backs to
https. If you are running the API server internally, you might want to usehttpinstead, but consider security.
Hinweis
In the Docker container, the credentials are configured in three variables and the credentials are built out of that. An example configuration for GitHub might look like:
WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com
Will be used as:
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "api-user",
"token": "api-token",
}
}
GITHUB_CREDENTIALS#
Neu in Version 4.3.
Liste für Zugangsdaten für GitHub-Server.
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "weblate",
"token": "your-api-token",
},
}
The configuration dictionary consists of credentials defined for each API host.
The API host might be different from what you use in the web browser, for
example GitHub API is accessed as api.github.com.
The following configuration is available for each host:
usernameAPI user, required.
tokenAPI token for the API user, required.
schemeNeu in Version 4.18.
Scheme override. Weblate attempts to parse scheme from the repository URL and falls backs to
https. If you are running the API server internally, you might want to usehttpinstead, but consider security.
Hinweis
In the Docker container, the credentials are configured in three variables and the credentials are built out of that. An example configuration for GitHub might look like:
WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com
Will be used as:
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "api-user",
"token": "api-token",
}
}
BITBUCKETSERVER_CREDENTIALS#
Neu in Version 4.16.
Liste der Zugangsdaten für Bitbucket-Server.
BITBUCKETSERVER_CREDENTIALS = {
"git.self-hosted.com": {
"username": "weblate",
"token": "http-access-token",
},
}
The configuration dictionary consists of credentials defined for each API host.
The API host might be different from what you use in the web browser, for
example GitHub API is accessed as api.github.com.
The following configuration is available for each host:
usernameAPI user, required.
tokenAPI token for the API user, required.
schemeNeu in Version 4.18.
Scheme override. Weblate attempts to parse scheme from the repository URL and falls backs to
https. If you are running the API server internally, you might want to usehttpinstead, but consider security.
Hinweis
In the Docker container, the credentials are configured in three variables and the credentials are built out of that. An example configuration for GitHub might look like:
WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com
Will be used as:
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "api-user",
"token": "api-token",
}
}
GOOGLE_ANALYTICS_ID#
Google Analytics-ID, um die Überwachung von Weblate mit Google Analytics zu aktivieren.
HIDE_REPO_CREDENTIALS#
Ausblenden der Repository-Zugangsdaten auf der Weboberfläche. 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#
Neu in Version 4.3.1.
Hides version info from unauthenticated users. This also makes all documentation links point to the latest version instead of the documentation matching the currently installed version.
Hiding the version is a recommended security practice in some corporations, does not prevent an attacker from figuring out version by probing behavior.
Bemerkung
Diese Funktion ist standardmäßig ausgeschaltet.
INTERLEDGER_PAYMENT_POINTERS#
Neu 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.
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.
IP_PROXY_OFFSET#
Gibt an, welcher Teil von IP_PROXY_HEADER als Client-IP-Adresse verwendet wird.
Abhängig von Ihrer Einstellung kann dieser Header aus mehreren IP-Adressen bestehen (z. B. X-Forwarded-For: a, b, client-ip) und Sie können hier konfigurieren, welche Adresse aus dem Header als Client-IP-Adresse verwendet wird.
Warnung
Setting this affects the security of your installation. You should only configure it to use trusted proxies for determining the IP address.
Der Standardwert ist 0.
LEGAL_TOS_DATE#
Neu in Version 4.15.
Bemerkung
Sie müssen Rechtliche Grundlagen installiert haben, damit dies funktioniert.
Date of last update of terms of service documents. Whenever the date changes, users are required to agree with the updated terms of service.
from datetime import date
LEGAL_TOS_DATE = date(2022, 2, 2)
LEGAL_URL#
Neu in Version 3.5.
URL, unter der Ihre Weblate-Instanz ihre juristischen Dokumente anzeigt.
Hinweis
Useful if you host your legal documents outside Weblate for embedding them inside Weblate. Please check Rechtliche Grundlagen for details.
Beispiel:
LEGAL_URL = "https://weblate.org/terms/"
Siehe auch
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.
Liste der anzuzeigenden Lizenzen filtern. 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
LICENSE_REQUIRED#
Legt fest, ob das Lizenzattribut in Komponentenkonfiguration erforderlich ist.
Bemerkung
Diese Funktion ist standardmäßig deaktiviert.
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-Lokalisierung 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
LOGIN_REQUIRED_URLS#
Eine Liste von URLs, für die eine Anmeldung erforderlich sein soll. (Neben den in Weblate eingebauten 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
LOGIN_REQUIRED_URLS_EXCEPTIONS#
List of exceptions for LOGIN_REQUIRED_URLS.
If not specified, users are allowed to access the sign-in page.
Einige Ausnahmen, die Sie möglicherweise einschließen möchten:
LOGIN_REQUIRED_URLS_EXCEPTIONS = (
r"/accounts/(.*)$", # Required for sign-in
r"/static/(.*)$", # Required for development mode
r"/widgets/(.*)$", # Allowing public access to widgets
r"/data/(.*)$", # Allowing public access to data exports
r"/hooks/(.*)$", # Allowing public access to notification hooks
r"/api/(.*)$", # Allowing access to API
r"/js/i18n/$", # JavaScript localization
)
MATOMO_SITE_ID#
ID of the site in Matomo (formerly Piwik) you want to use for tracking Weblate.
Bemerkung
Diese Integration unterstützt den Matomo Tag Manager nicht.
Siehe auch
MATOMO_URL#
Vollständige URL (einschließlich nachgestelltem Schrägstrich) einer Matomo (ehemals Piwik)-Installation, mit der Sie die Nutzung von Weblate verfolgen möchten. 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
NEARBY_MESSAGES#
Wie viele Zeichenketten um die aktuell übersetzte Zeichenkette herum angezeigt werden sollen. Dies ist nur ein Standardwert, Benutzer können dies in Benutzerprofil anpassen.
DEFAULT_PAGE_LIMIT#
Neu in Version 4.7.
Standardanzahl der Elemente, die bei aktivem Seitenumbruch angezeigt werden.
PAGURE_CREDENTIALS#
Neu in Version 4.3.2.
Liste der Zugangsdaten für Pagure-Server.
PAGURE_CREDENTIALS = {
"pagure.io": {
"username": "weblate",
"token": "your-api-token",
},
}
The configuration dictionary consists of credentials defined for each API host.
The API host might be different from what you use in the web browser, for
example GitHub API is accessed as api.github.com.
The following configuration is available for each host:
usernameAPI user, required.
tokenAPI token for the API user, required.
schemeNeu in Version 4.18.
Scheme override. Weblate attempts to parse scheme from the repository URL and falls backs to
https. If you are running the API server internally, you might want to usehttpinstead, but consider security.
Hinweis
In the Docker container, the credentials are configured in three variables and the credentials are built out of that. An example configuration for GitHub might look like:
WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com
Will be used as:
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "api-user",
"token": "api-token",
}
}
Siehe auch
PRIVACY_URL#
Neu in Version 4.8.1.
URL, unter der Ihre Weblate-Instanz ihre Datenschutzrichtlinie anzeigt.
Hinweis
Nützlich, wenn Sie Ihre juristischen 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
PRIVATE_COMMIT_EMAIL_OPT_IN#
Neu 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).
Siehe auch
PRIVATE_COMMIT_EMAIL_TEMPLATE#
Neu 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#
Neu in Version 4.14.
Defines how many backups per project are kept on the server. Defaults to 3.
Siehe auch
PROJECT_BACKUP_KEEP_DAYS#
Neu in Version 4.14.
Legt fest, wie lange die Projekt-Backups auf dem Server aufbewahrt werden sollen. Die Standardeinstellung ist 30 Tage.
Siehe auch
PROJECT_NAME_RESTRICT_RE#
Neu in Version 4.15.
Definiert einen regulären Ausdruck zur Einschränkung der Projektbenennung. Alle übereinstimmenden Namen werden abgelehnt.
Siehe auch
PROJECT_WEB_RESTRICT_HOST#
Neu in Version 4.16.2.
Verhindert das Benutzen von gewissen Hosts auf der Projektwebsite. Jede Subdomain wird blockiert, 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"}
PROJECT_WEB_RESTRICT_NUMERIC#
Neu in Version 4.16.2.
Reject using numeric IP address in project website. On by default.
Siehe auch
Projektseite
PROJECT_WEB_RESTRICT_HOST,
PROJECT_WEB_RESTRICT_RE,
PROJECT_WEB_RESTRICT_RE#
Neu in Version 4.15.
Definiert einen regulären Ausdruck zur Einschränkung von Projekt-Websites. Alle übereinstimmenden URLs werden abgelehnt.
RATELIMIT_ATTEMPTS#
Neu in Version 3.2.
Maximale Anzahl von Authentifizierungsversuchen, bevor eine Ratenbegrenzung angewendet wird.
Der Standardwert ist 5.
Siehe auch
RATELIMIT_WINDOW#
Neu in Version 3.2.
Wie lange die Authentifizierung nach der Ratenbegrenzung akzeptiert wird.
An amount of seconds, defaulting to 300 (5 minutes).
Siehe auch
RATELIMIT_LOCKOUT#
Neu in Version 3.2.
Wie lange die Authentifizierung nach der Ratenbegrenzung akzeptiert wird.
Eine Anzahl von Sekunden, die standardmäßig 600 (10 Minuten) beträgt.
Siehe auch
REGISTRATION_ALLOW_BACKENDS#
Neu 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.
It is recommended to keep REGISTRATION_OPEN on while limiting
registration backends, otherwise users will be able to register, but Weblate
will not show links to register in the user interface.
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#
Whether registration of new accounts is protected by a CAPTCHA. Defaults to enabled.
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.
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-Domäne beschränken:
REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"
REGISTRATION_OPEN#
Whether registration of new accounts is currently permitted. Defaults to enabled.
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.
REGISTRATION_REBIND#
Neu in Version 4.16.
Erlaubt das erneute Binden von Authentifizierungs-Backends für bestehende Benutzer. Aktivieren Sie dies, wenn Sie zwischen Authentifizierungsanbietern migrieren.
Bemerkung
Off by default to not allow adding other authentication backends to an existing account. Rebinding can lead to account compromise when using more third-party authentication backends.
REPOSITORY_ALERT_THRESHOLD#
Neu in Version 4.0.2.
Schwellenwert für die Auslösung eines Alarms bei veralteten Repositorys oder Repositorys, die zu viele Änderungen enthalten. Der Standardwert ist 25.
Siehe auch
REQUIRE_LOGIN#
Neu 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#
Neu in Version 3.9.
Sentry-DSN zur Verwendung für das Sammeln von Fehlerberichten.
Siehe auch
SIMPLIFY_LANGUAGES#
Verwenden Sie einfache Sprachcodes für Standard-Sprach/Länder-Kombinationen. 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#
Configures site domain. Necessary to produce correct absolute links in many scopes (for example activation e-mails, notifications or RSS feeds).
If Weblate is running on a non-standard port, include it here as well.
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
This setting should only contain the domain name. For configuring protocol,
(turning on and enforcing HTTPS) use ENABLE_HTTPS and for changing
the URL, use URL_PREFIX.
Hinweis
In einem Docker-Container wird die Site-Domäne über WEBLATE_ALLOWED_HOSTS konfiguriert.
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#
Neu in Version 3.8.
Redirects users directly to a project or component instead of showing
the dashboard. You can either set it to True so it only works
if there is actually only single project in Weblate. Alternatively, set
the project slug, and it will redirect unconditionally to this project.
Geändert in Version 3.11: Die Einstellung akzeptiert jetzt auch einen Projekt-Slug, um die Anzeige des einzelnen Projekts zu erzwingen.
Beispiel:
SINGLE_PROJECT = "test"
SSH_EXTRA_ARGS#
Neu in Version 4.9.
Allows adding custom parameters when Weblate is invoking SSH. Useful when connecting to servers using legacy encryption or other non-standard features.
For example when SSH connection in Weblate fails with Unable to negotiate with legacyhost: no matching key exchange method found. Their offer: diffie-hellman-group1-sha1, you can turn that on using:
SSH_EXTRA_ARGS = "-oKexAlgorithms=+diffie-hellman-group1-sha1"
Hinweis
The string is evaluated by the shell, so ensure any whitespace and special characters is quoted.
Siehe auch
STATUS_URL#
Die URL, unter der Ihre Weblate-Instanz ihren Status meldet.
SUGGESTION_CLEANUP_DAYS#
Neu in Version 3.2.1.
Löscht Vorschläge automatisch nach einer bestimmten Anzahl von Tagen. Der Standardwert ist None, was bedeutet, dass keine Löschungen vorgenommen werden.
UNUSED_ALERT_DAYS#
Neu in Version 4.17.
Configures when the Component seems unused alert is triggered.
Standardmäßig 365 Tage, zum Ausschalten auf 0 setzen.
UPDATE_LANGUAGES#
Neu in Version 4.3.2.
Steuert, ob die Sprachdatenbank bei der Datenbankmigration aktualisiert werden soll und ist standardmäßig aktiviert. Diese Einstellung hat keinen Einfluss auf den Aufruf von weblate setuplang.
Warnung
The languages display might become inconsistent with this. Weblate language definitions expand over time and it will not display language code for the defined languages.
Siehe auch
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 eingebauten Server, Sie müssen urls.py so anpassen, dass es dieses Präfix enthält.
VCS_API_DELAY#
Neu 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, und Pagure-Merge-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_BACKENDS#
Konfiguration der verfügbaren VCS-Backends.
Bemerkung
Weblate versucht, alle unterstützten Back-Ends zu nutzen, für die Sie 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
VCS_CLONE_DEPTH#
Neu in Version 3.10.2.
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 durch, 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 bestehende 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.LangaugeConsistencyAddon",
"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
WEBLATE_EXPORTERS#
Neu in Version 4.2.
Liste der verfügbaren Exporteure, die das Herunterladen von Übersetzungen oder Glossaren in verschiedenen Dateiformaten anbieten.
Siehe auch
WEBLATE_FORMATS#
Neu in Version 3.0.
Liste der Dateiformate, die verwendet werden können.
Bemerkung
Die Standardliste enthält bereits die gängigen Formate.
Siehe auch
WEBLATE_MACHINERY#
Neu in Version 4.13.
Liste der zur Verfügung stehenden Maschinendienste.
Siehe auch
WEBLATE_GPG_IDENTITY#
Neu in Version 3.1.
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 generiert, siehe Signing Git commits with GnuPG für weitere Details.
Siehe auch
WEBSITE_REQUIRED#
Legt fest, ob Projektseite beim Erstellen eines Projekts angegeben werden muss. Standardmäßig eingeschaltet, da dies für öffentliche Serverkonfigurationen geeignet ist.
COMMENT_CLEANUP_DAYS#
Neu in Version 3.6.
Löscht Kommentare nach einer bestimmten Anzahl von Tagen. Der Standardwert ist
None, was bedeutet, dass überhaupt nicht gelöscht wird.