Configuração¶
Todas as configurações estão armazenadas em settings.py (como é habitual no Django).
Nota
Após alterar qualquer uma dessas configurações, precisa de reiniciar o Weblate — tanto os processos WSGI quanto os Celery.
Caso seja executado como mod_wsgi:, precisa reiniciar o Apache para recarregar a configuração.
Veja também
Verifique também Django’s documentation para parâmetros de configuração do próprio Django.
ADMINS_CONTACT¶
Configura para onde o formulário de contacto envia as mensagens. Se não estiver configurado, serão utilizados os endereços de correio eletrónico de ADMINS.
Configure isto como uma lista de endereços de correio eletrónico:
ADMINS_CONTACT = ["admin@example.com", "support@example.com"]
Veja também
ALLOWED_ASSET_DOMAINS¶
Added in version 5.14.
Configures which domains are allowed for fetching assets in Weblate.
This enhances security by preventing loading assets from untrusted sources. Assets are downloaded once by the Weblate server and stored locally, rather than being served directly from external domains to users.
The allowlist is applied to the initial URL and to every HTTP redirect target before Weblate follows it. Redirects to hosts outside of this allowlist are rejected.
It expects a list of host/domain names. You can use fully qualified names
(e.g www.example.com) or prepend with a period as a wildcard to match
all subdomains (e.g .example.com will match cdn.example.com or static.example.com).
Defaults to ["*"], which allows all domains.
Exemplo
ALLOWED_ASSET_DOMAINS = [
# Allows only cdn.anotherdomain.org
"cdn.anotherdomain.org",
# Allows example.com and all its subdomains
".example.com",
]
Atualmente, isto é utilizado nos seguintes locais:
Carregamento de capturas de ecrã, ver Screenshots and visual context
Remote HTML downloads for the CDN de localização JavaScript add-on
ALLOWED_MACHINERY_DOMAINS¶
Configures which custom machinery domains are explicitly allowed in project-level machine translation configuration.
This setting applies only to machinery services and does not affect
ALLOWED_ASSET_DOMAINS.
It expects a list of host/domain names. You can use fully qualified names or prepend with a period as a wildcard to match all subdomains.
Defaults to [].
The allowlist affects project-managed machinery in two ways: it permits the configured endpoint during outbound validation, and it marks matching hosts as trusted when deciding whether remote provider error details or response bodies can be shown to the user. For direct connections, runtime checks still reject destinations that resolve to private or otherwise non-public addresses. When an HTTP(S) proxy is used, runtime validation falls back to hostname validation and does not perform the same local DNS or peer-IP checks.
ALLOWED_ASSET_SIZE¶
Added in version 5.14.
Configures size limit for fetching assets in Weblate. Defaults to 10 MB.
Veja também
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.
Configuração padrão:
ASSET_PRIVATE_ALLOWLIST = []
Veja também
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 CDN de localização JavaScript add-on.
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.
Veja também
ANONYMOUS_USER_NAME¶
O nome de utilizadores não autenticados.
Veja também
AUDITLOG_EXPIRY¶
A quantidade máxima de dias que o Weblate manterá registos de auditoria contendo informações sobre a atividade da conta.
A predefinição é de 180 dias.
AUTH_LOCK_ATTEMPTS¶
Quantidade máxima de tentativas de autenticação que falharam antes da aplicação da limitação de taxa.
Atualmente, isto é aplicado nos locais seguintes:
Autenticação. Apaga a senha da conta, impedindo que o utilizador entre sem solicitar uma nova senha.
Redefinição de palavra-passe. Impede que novos e-mails sejam enviados, evitando o envio de spam aos utilizadores com muitas tentativas de redefinição de palavra-passe.
A predefinição é 10.
Veja também
AUTO_UPDATE¶
Atualiza todos repositórios diariamente.
Dica
Útil se não estiver a user Hooks de notificação para atualizar os repositórios do Weblate automaticamente.
Nota
Existem opções de ligar/desligar, além da seleção de cadeias para compatibilidade com versões anteriores.
As opções são:
"none"Sem atualizações diárias.
"remote"e tambémFalseAtualizar apenas os repositórios remotos.
"full"e tambémTrueAtualizar repositórios remotos e mesclar a cópia de trabalho.
Nota
Isto requer que Tarefas de fundo a usar o Celery esteja a funcionar e entrará em vigor após ser reiniciado.
AVATAR_URL_PREFIX¶
Prefixo para construção de URLs de avatars: ${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS}. Os serviços seguintes funcionam:
- Gravatar (predefinição), conforme https://gravatar.com/
AVATAR_URL_PREFIX = 'https://www.gravatar.com/'- Libravatar, conforme https://www.libravatar.org/
AVATAR_URL_PREFIX = 'https://www.libravatar.org/'
Veja também
AUTH_TOKEN_VALID¶
Por quanto tempo o token de autenticação e a palavra-passe temporária dos e-mails de redefinição de palavra-passe são válidos. Definido em número de segundos, usando 172800 (2 dias) como predefinição.
AUTH_PASSWORD_DAYS¶
Quantos dias o Weblate rejeita a reutilização de uma palavra-passe usada anteriormente para um utilizador.
A verificação é baseada no registo da auditoria, AUDITLOG_EXPIRY tem de ser pelo menos o mesmo que isto.
Nota
Mudanças de palavra-passe feitas anteriormente ao Weblate 2.15 não serão consideradas para essa política.
A predefinição é de 180 dias.
AUTOFIX_LIST¶
Lista de correções automáticas para aplicar ao gravar uma cadeia.
Nota
Forneça um caminho totalmente qualificado para a classe Python que implementa a interface de correção automática.
Correções disponíveis são descritas em Correções automáticas.
Pode selecionar quais usar:
AUTOFIX_LIST = (
"weblate.trans.autofixes.whitespace.SameBookendingWhitespace",
"weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis",
)
BACKGROUND_TASKS¶
Added in version 4.5.2.
Define com que frequência as tarefas de manutenção demoradas devem ser acionadas para um componente.
No momento, isso controla:
Extensão Tradução Automática
Recálculo de Verificações e correções
Escolhas possíveis:
monthly(este é o padrão)weeklydailynever
Nota
O aumento da frequência não é recomendado quando o Weblate contém milhares de componentes.
BASIC_LANGUAGES¶
Added in version 4.4.
Lista de idiomas para oferecer aos utilizadores para iniciar uma nova tradução. Quando não especificado, a lista embutida é usada, o que inclui todos os idiomas comumente usados, mas sem variantes específicas de país.
Isto só limita utilizadores não privilegiados a adicionar idiomas indesejados. Os administradores do projeto ainda são apresentados com seleção completa de idiomas definidos no Weblate.
Nota
Isto não define novos idiomas para o Weblate — apenas filtra os existentes na base de dados.
Exemplo:
BASIC_LANGUAGES = {"cs", "it", "ja", "en"}
Veja também
BORG_EXTRA_ARGS¶
Added in version 4.9.
Pode passar argumentos adicionais para borg create quando backups embutidos forem acionados.
Exemplo:
BORG_EXTRA_ARGS = ["--exclude", "vcs/"]
CACHE_DIR¶
Added in version 4.16.
Diretório onde o Weblate armazena ficheiros de cache. O padrão é a subpasta cache em DATA_DIR.
Altere isto para o sistema de ficheiros local ou temporário se DATA_DIR estiver num sistema de ficheiros de rede.
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.
O contentor de Docker utiliza um volume separado para isto, consulte Volumes de contentor Docker.
Os subdiretórios seguintes geralmente existem:
sshGenerated helper files used for VCS access.
fontsfont-config cache para Gerir letras.
avatarAvatares de utilizador em cache, consulte Avatares.
staticLocalização padrão para ficheiros de Django estáticos, especificados por
STATIC_ROOT. Veja Servir ficheiros estáticos.tesseractDados treinados em OCR para Screenshots and visual context.
CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC¶
Customize the Content-Security-Policy header for Weblate. The header is automatically generated based on enabled integrations with third-party services (Matomo, Google Analytics, Sentry, …).
All these default to an empty list.
Exemplo:
# Enable Cloudflare Javascript optimizations
CSP_SCRIPT_SRC = ["ajax.cloudflare.com"]
CHECK_LIST¶
Lista de verificações de qualidade para realizar numa tradução.
Nota
Forneça um caminho totalmente qualificado à classe Python que implementa a interface de verificação.
Ajuste a lista de verificações para incluir as relevantes para si.
Todas as Verificações de qualidade embutidas estão ativadas por padrão, de onde pode alterar estas configurações. Por padrão, eles são comentados em Configuração de amostra para que os valores padrão sejam usados. Novas verificações são então realizadas para cada nova versão do Weblate.
Pode desativar todas as verificações:
CHECK_LIST = ()
Pode ativar apenas algumas:
CHECK_LIST = (
"weblate.checks.chars.BeginNewlineCheck",
"weblate.checks.chars.EndNewlineCheck",
"weblate.checks.chars.MaxLengthCheck",
)
Nota
Alterar esta configuração afeta apenas as traduções recém alteradas. As verificações existentes ainda serão armazenadas na base de dados. Para aplicar as alterações também às traduções armazenadas, execute: updatechecks.
COMMIT_PENDING_HOURS¶
Quantidade de horas entre fazer o commit de alterações pendentes por meio da tarefa de segundo plano.
COMPONENT_ZIP_UPLOAD_MAX_SIZE¶
Added in version 5.17.1.
Configures the maximum size, in bytes, for uploaded component ZIP files. Defaults to 50 MB.
In Docker, configure this using the WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE
environment variable.
Veja também
CONTACT_FORM¶
Added in version 4.6.
Configura como o e-mail do formulário de contato é enviado. Escolha uma configuração que corresponda à configuração do seu servidor de e-mail.
"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"Disables the contact form entirely.
Added in version 5.15.
Veja também
DATA_DIR¶
A pasta na qual Weblate armazena todos os dados. Ela contém ligações para repositórios VCS, um índice de texto e vários ficheiros de configuração para ferramentas externas.
Os subdiretórios seguintes geralmente existem:
homeO diretório pessoal usado para invocar scripts.
sshChaves e configuração de SSH.
mediaLocalização padrão para ficheiros de mídia Django, especificado por
MEDIA_ROOT. Contém capturas de ecrã enviadas, veja Screenshots and visual context.vcsRepositórios de controle de versão para traduções.
backupsBackup diário de dados. Por favor, verifique Dados despejados para backups para pormenores.
fonts:Fontes enviadas pelo utilizador, veja Gerir letras.
cacheVários caches. Pode ser posto em outro lugar usando
CACHE_DIR.O contentor de Docker utiliza um volume separado para isto, consulte Volumes de contentor Docker.
Nota
Esta pasta tem de poder ser escrita pelo Weblate. Executá-lo como WSGI significa que o utilizador www-data deve ter acesso de escrita.
A maneira mais fácil de conseguir isto é fazer do utilizador o proprietário da pasta:
sudo chown www-data:www-data -R $DATA_DIR
O padrão é /home/weblate/data, mas espera-se que seja configurado.
DATABASE_BACKUP¶
Se as cópias de segurança da base de dados devem ser armazenadas como texto simples, compactado ou ignorado. Os valores autorizados são:
"plain""compressed""none"
Veja também
DEFAULT_ACCESS_CONTROL¶
A configuração padrão de controle de acesso para novos projetos:
0Público
1Protegido
100Privado
200Personalizado
Use Personalizado se está a gerir a ACL manualmente, o que significa não confiar na gestão interna do Weblate.
Veja também
DEFAULT_AUTO_WATCH¶
Added in version 4.5.
Configura se Monitorizar automaticamente projetos onde colabore deve ser ativado para novos utilizadores. O padrão é True.
Veja também
DEFAULT_RESTRICTED_COMPONENT¶
Added in version 4.1.
O valor predefinido para a restrição de componentes.
Veja também
DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE¶
Enviar mensagens predefinidas para diferentes operações, consulte Configuração de componente para detalhes.
DEFAULT_ADDONS¶
Extensões padrão para instalar para cada componente criado.
Nota
Essa configuração afeta apenas componentes recém-criados.
Exemplo:
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",
},
}
Veja também
DEFAULT_COMMITER_EMAIL¶
Endereço de e-mail do committer, padrão para noreply@weblate.org.
Veja também
DEFAULT_COMMITER_NAME¶
Nome do committer, padrão para Weblate.
Veja também
DEFAULT_LANGUAGE¶
Added in version 4.3.2.
Idioma fonte para quaisquer novos componentes.
Predefine para en. O objeto de idioma correspondente tem de existir na base de dados.
Veja também
DEFAULT_MERGE_STYLE¶
Estilo de união para quaisquer novos componentes.
rebase - predefinição
merge
Veja também
DEFAULT_TRANSLATION_REVIEW¶
Added in version 5.16.
Configures the default value for Activar revisões, turned off by default.
DEFAULT_SOURCE_REVIEW¶
Added in version 5.16.
Configures the default value for Ativar revisões de fontes, turned off by default.
DEFAULT_AUTOCLEAN_TM¶
Added in version 5.13.
Configures the default value of Limpar memória de tradução automaticamente.
DEFAULT_TRANSLATION_PROPAGATION¶
Configuração predefinida para propagação de tradução, a predefinição é True.
DEFAULT_PULL_MESSAGE¶
Configura o título e a mensagem padrão para pull requests.
ENABLE_AVATARS¶
Se deve ativar os avatares baseados em Gravatar para os utilizadores. Ativado por padrão.
Avatares são buscados e armazenados em cache no servidor, diminuindo o risco de vazamento de informações privadas, acelerando a experiência do utilizador.
Veja também
ENABLE_HOOKS¶
Se deve ativar os ganchos remotos anônimos.
Veja também
ENABLE_HTTPS¶
Alterado na versão 5.7: Weblate agora requer https para suporte ao WebAuthn.
Se se deve enviar ligações para Weblate como HTTPS ou HTTP. Esta configuração afeta os e-mails enviados e as URLs absolutas geradas.
Na configuração padrão, este também é usado para várias configurações de Django relacionadas ao HTTPS — ele ativa cookies seguros, ativa/desativa HSTS ou ativa redirecionamento para um URL HTTPS .
O redirecionamento HTTPS pode ser problemático em alguns casos e pode encontrar um problema com o redirecionamento infinito caso esteja usando um proxy reverso fazendo uma terminação SSL que não passa corretamente os cabeçalhos de protocolo para o Django. Por favor ajuste a sua configuração de proxy reverso para emitir X-Forwarded-Proto ou Forwarded cabeçalhos ou configure SECURE_PROXY_SSL_HEADER para permitir que o Django detete corretamente o estado SSL.
Caso isto esteja desativado, o Weblate falhará ao iniciar com um erro otp_webauthn.E031. Pode silenciar este erro adicionando-o a SILENCED_SYSTEM_CHECKS, mas mesmo assim o WebAuthn não funcionará para sites sem HTTPS.
ENABLE_SHARING¶
Turn on/off the Community menu so users can share translation progress on social networks.
Veja também
EXTRA_HTML_HEAD¶
Added in version 4.15.
Insira marcação adicional no cabeçalho HTML. Pode ser usado para verificação da propriedade do site, por exemplo:
EXTRA_HTML_HEAD = '<link href="https://fosstodon.org/@weblate" rel="me">'
Aviso
Nenhuma sanitização é executada no cadeia, é inserido como está no cabeçalho HTML.
GET_HELP_URL¶
Added in version 4.5.2.
URL onde o suporte para sua instância do Weblate encontra-se.
GITEA_CREDENTIALS¶
Added in version 4.12.
Lista para credenciais para servidores Gitea.
GITEA_CREDENTIALS = {
"try.gitea.io": {
"username": "weblate",
"token": "your-api-token",
},
}
O dicionário de configuração consiste em credenciais definidas para cada host de API. O layout é o mesmo para quase todas as integrações de controle de versão e é descrito em Configurar credenciais para controle de versão.
GITLAB_CREDENTIALS¶
Added in version 4.3.
Lista para credenciais para servidores de GitLab.
GITLAB_CREDENTIALS = {
"gitlab.com": {
"username": "weblate",
"token": "your-api-token",
},
}
Nota
The personal access token needs the api scope to be able to use the API.
O dicionário de configuração consiste em credenciais definidas para cada host de API. O layout é o mesmo para quase todas as integrações de controle de versão e é descrito em Configurar credenciais para controle de versão.
GITHUB_CREDENTIALS¶
Added in version 4.3.
Lista para credenciais para servidores GitHub.
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "weblate",
"token": "your-api-token",
},
}
Nota
É possível usar tanto os tokens de acesso pessoal refinado quanto os tokens de acesso pessoal clássico. Os tokens refinados são limitados a uma única organização, portanto, não funcionarão se quiser que o Weblate faça o fork de um repositório fora da organização (normalmente para o espaço de nomes do utilizador).
To clone, push and create pull requests, the read and write access to Contents and Pull requests is required.
Administração também pode ser necessário para fazer fork de um repositório se pretende usar fork e o repositório original não for público.
Dica
Use api.github.com as an API host for https://github.com/.
O dicionário de configuração consiste em credenciais definidas para cada host de API. O layout é o mesmo para quase todas as integrações de controle de versão e é descrito em Configurar credenciais para controle de versão.
BITBUCKETSERVER_CREDENTIALS¶
Added in version 4.16.
Lista de credenciais para Data Center Bitbucket.
BITBUCKETSERVER_CREDENTIALS = {
"git.self-hosted.com": {
"username": "weblate",
"token": "http-access-token",
},
}
O dicionário de configuração consiste em credenciais definidas para cada host de API. O layout é o mesmo para quase todas as integrações de controle de versão e é descrito em Configurar credenciais para controle de versão.
BITBUCKETCLOUD_CREDENTIALS¶
Added in version 5.8.
Lista de credenciais para servidores de Nuvem Bitbucket.
BITBUCKETCLOUD_CREDENTIALS = {
"bitbucket.org": {
"username": "your-email",
"workspace": "your-workspace-slug",
"token": "your-api-token",
},
}
O dicionário de configuração consiste em credenciais definidas para cada host de API. O host da API pode ser diferente do que usa no navegador web, por exemplo, a API do GitHub é acedida como api.github.com.
A seguinte configuração está disponível para cada host:
usernameAPI do utilizador.
workspaceO slug do espaço de trabalho do utilizador.
tokenThe API token with pullrequest:write permission.
Configurações adicionais não descritas aqui encontram-se em Configurar credenciais para controle de versão.
AZURE_DEVOPS_CREDENTIALS¶
Added in version 5.2.
Lista de credenciais para servidores do Azure DevOps.
AZURE_DEVOPS_CREDENTIALS = {
"dev.azure.com": {
"username": "project-name",
"token": "your-api-token",
"organization": "organization-name",
},
}
O dicionário de configuração consiste em credenciais definidas para cada host de API. O host da API pode ser diferente do que usa no navegador web, por exemplo, a API do GitHub é acedida como api.github.com.
A seguinte configuração está disponível para cada host:
usernameO nome do projeto Azure DevOps. Este não é o nome do repositório.
organizationO nome da organização do projeto.
workItemIdsUma lista opcional de IDs de elementos de trabalho da sua organização. Quando fornecida, novos pull requests terão estes elementos anexados.
tokenToken de API para o utilizador da API, obrigatório.
Configurações adicionais não descritas aqui encontram-se em Configurar credenciais para controle de versão.
GOOGLE_ANALYTICS_ID¶
ID do Google Analytics para ativar o monitoramento do Weblate usando o Google Universal Analytics.
Nota
No momento, a integração com o Google Analytics 4 não está disponível para o Weblate; consulte https://github.com/WeblateOrg/weblate/issues/14015.
HIDE_REPO_CREDENTIALS¶
Oculta credenciais de repositório da interface web. No caso de ter URL do repositório com utilizador e palavra-passe, o Weblate irá ocultá-la quando as informações relacionadas são mostradas aos utilizadores.
For example instead of https://user:password@git.example.com/repo.git it
will show just https://git.example.com/repo.git. It tries to clean up VCS
error messages too in a similar manner.
Nota
Ativado por padrão.
VERSION_DISPLAY¶
Added in version 5.17.
Controls how prominently Weblate exposes its own version.
Supported values are:
showShow the version in shared UI such as the footer and expose it in
GET /api/metrics/.softHide the version from prominent shared UI, while keeping it discoverable on the About page and in
GET /api/metrics/.hideHide the version from shared UI and
GET /api/metrics/. This also makes anonymous documentation links point to the latest documentation instead of the version matching the installed release.
Hiding the version is a recommended security practice in some corporations, but it does not prevent an attacker from inferring the version by probing behavior.
Nota
The default is show.
HIDE_VERSION¶
Added in version 4.3.1.
Obsoleto desde a versão 5.17.
Compatibility alias for VERSION_DISPLAY. Set this to True to
get the same behavior as VERSION_DISPLAY = "hide".
IP_BEHIND_REVERSE_PROXY¶
Indica se o Weblate está a ser usado através de um proxy reverso.
Se for definido como True, o Weblate obtém o endereço IP de um cabeçalho definido por IP_PROXY_HEADER.
Aviso
Certifique-se de que está realmente a usar um proxy reverso e que ele define este cabeçalho, caso contrário, os utilizadores poderão falsificar o endereço IP.
Nota
Isto está ligado por predefinição.
IP_PROXY_HEADER¶
Indica de qual cabeçalho o Weblate deve obter o endereço IP quando IP_BEHIND_REVERSE_PROXY está ativado.
A predefinição é HTTP_X_FORWARDED_FOR.
IP_PROXY_OFFSET¶
Alterado na versão 5.0.1: O padrão mudou de 1 para -1.
Indica qual parte de IP_PROXY_HEADER é usada como endereço IP do cliente.
Dependendo da sua configuração, este cabeçalho pode consistir em vários endereços IP (por exemplo, X-Forwarded-For: client-ip, proxy-a, proxy-b) e pode configurar qual endereço do cabeçalho é usado como endereço IP do cliente aqui.
Aviso
Esta configuração afeta a segurança da sua instalação. Só a deveria configurar para utilizar proxies confiáveis para determinar o endereço de IP. Consulte <https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns> para obter mais pormenores.
O padrão é -1.
LEGAL_TOS_DATE¶
Added in version 4.15.
Nota
Precisa de Módulo legal instalado para fazer isso funcionar.
Data da última atualização dos documentos de termos de serviço. Sempre que a data for alterada, os utilizadores deverão concordar com os termos de serviço atualizados.
from datetime import date
LEGAL_TOS_DATE = date(2022, 2, 2)
LEGAL_URL¶
URL onde a sua instância de Weblate mostra os documentos legais dela.
Dica
Útil se hospedar os seus documentos legais fora do Weblate para incorporá-los ao Weblate. Consulte Módulo legal para obter pormenores.
Exemplo:
LEGAL_URL = "https://weblate.org/terms/"
Veja também
LICENSE_EXTRA¶
Licenças adicionais para incluir nas opções de licença.
Nota
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.
Por exemplo:
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¶
Alterado na versão 4.3: A configurar este para valor em branco desativa o alerta de licença.
Filtrar licenças da lista para mostrar. Isto também desativa o alerta de licença quando configurado para vazio.
Nota
Este filtro usa os nomes de licença curtos.
Por exemplo:
LICENSE_FILTER = {"AGPL-3.0", "GPL-3.0-or-later"}
O seguinte desativa o alerta de licença:
LICENSE_FILTER = set()
Veja também
LICENSE_REQUIRED¶
Define se o atributo de licença em Configuração de componente é necessário.
Nota
Isto está desativado por predefinição.
LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH¶
Se o comprimento de uma determinada tradução deve ser limitado. A restrição é o comprimento da cadeia fonte × 10 caracteres.
Dica
Defina isso como False para permitir traduções mais longas (até 10.000 caracteres) independentemente do comprimento da cadeia fonte.
Nota
Defaults to True.
LOCALIZE_CDN_URL e LOCALIZE_CDN_PATH¶
These settings configure the CDN add-ons, including
CDN de localização JavaScript 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
CDN de localização for secure serving guidance.
Dica
O Hosted Weblate usa o https://weblate-cdn.com/.
Veja também
MATOMO_SITE_ID¶
ID do site no Matomo (antigo Piwik) que deseja usar para rastrear o Weblate.
Nota
Esta integração não suporta o Matomo Tag Manager.
Veja também
MATOMO_URL¶
URL completa (incluindo barra ao final) de uma instalação Matomo (anteriormente Piwik) que deseja usar para rastrear o uso do Weblate. Por favor, consulte <https://matomo.org/> para mais detalhes.
Dica
Esta integração não suporta o Matomo Tag Manager.
Por exemplo:
MATOMO_SITE_ID = 1
MATOMO_URL = "https://example.matomo.cloud/"
Veja também
NEARBY_MESSAGES¶
Quantidade de cadeias próximas para mostrar em cada direção no editor completo.
Este é apenas um valor padrão, os utilizadores podem ajustar isto em Perfil do utilizador.
DEFAULT_PAGE_LIMIT¶
Added in version 4.7.
Número padrão de elementos a serem exibidos quando a paginação está ativa.
PAGURE_CREDENTIALS¶
Added in version 4.3.2.
Lista para credenciais para servidores de Pagure.
PAGURE_CREDENTIALS = {
"pagure.io": {
"username": "weblate",
"token": "your-api-token",
},
}
O dicionário de configuração consiste em credenciais definidas para cada host de API. O layout é o mesmo para quase todas as integrações de controle de versão e é descrito em Configurar credenciais para controle de versão.
Veja também
PASSWORD_MINIMAL_STRENGTH¶
Added in version 5.10.2.
Pontuação mínima da palavra-passe conforme avaliada pelo estimador que verifica a força da palavra-passe zxcvbn.
Predefine para 0, o que significa que a verificação de força está desativada.
PASSWORD_RESET_URL¶
Added in version 5.17.
URL for password reset when authentication is handled by an external identity provider, such as LDAP, SAML, or OAuth.
When set, Forgot your password? on the sign-in page links to this URL instead of Weblate’s built-in password reset page.
PRIVACY_URL¶
Added in version 4.8.1.
URL onde a sua instância de Weblate mostra sua política de privacidade.
Dica
Útil se hospeda os seus documentos legais fora do Weblate para incorporá-los ao Weblate, verifique Módulo legal para obter detalhes.
Exemplo:
PRIVACY_URL = "https://weblate.org/terms/"
Veja também
PRIVATE_COMMIT_EMAIL_OPT_IN¶
Added in version 4.15.
Configura se o “”e-mail”” de submissão privado foi optado ou não (por predefinição é optado).
Dica
Esta configuração só se aplica a utilizadores que não escolheram explicitamente um e-mail commit.
Veja também
PRIVATE_COMMIT_EMAIL_TEMPLATE¶
Added in version 4.15.
Template to generate a private commit e-mail for a user. Defaults to "{username}@users.noreply.{site_domain}".
It can contain {user_id}, {username}, {site_title}, and {site_domain}.
Defina para cadeia vazia para desativar.
Nota
Using a different commit e-mail is opt-in for users unless configured by
PRIVATE_COMMIT_EMAIL_OPT_IN. Users can configure their commit e-mail in
the Perfil.
PRIVATE_COMMIT_NAME_OPT_IN¶
Added in version 5.16.
Configures whether the private commit name is opt-in or opt-out (by default it is opt-in).
Dica
This setting only applies to users which have not explicitly chosen a commit name.
Veja também
PRIVATE_COMMIT_NAME_TEMPLATE¶
Added in version 5.16.
Template to generate a private commit name for a user. Defaults to "{site_title} user {user_id}".
It can contain {user_id}, {username}, {site_title}, and {site_domain}.
Defina para cadeia vazia para desativar.
Nota
Using a different commit name is opt-in for users unless configured by
PRIVATE_COMMIT_NAME_OPT_IN. Users can configure their commit name in
the Perfil.
PROJECT_BACKUP_KEEP_COUNT¶
Added in version 4.14.
Define quantos backups por projeto são mantidos no servidor. O padrão é 3.
Veja também
PROJECT_BACKUP_KEEP_DAYS¶
Added in version 4.14.
Define por quanto tempo os backups do projeto serão mantidos no servidor. O tempo padrão é de 30 dias.
Veja também
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, configure this using the WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE
environment variable. Docker setups can also be constrained by
CLIENT_MAX_BODY_SIZE; other deployments can be constrained by their
reverse proxy request body-size limit.
Veja também
PROJECT_BACKUP_IMPORT_MAX_MEMBERS¶
Added in version 5.17.
Defines the maximum number of ZIP entries allowed when importing a project backup.
This is a safeguard against malformed or intentionally fragmented archives. Defaults to 100000 entries.
In Docker, configure this using the
WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS environment variable.
Veja também
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).
This limits archives that are small when uploaded but expand to much more data during validation or restore.
In Docker, configure this using the
WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE environment
variable.
Veja também
PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE¶
Added in version 5.17.
Defines the maximum uncompressed size, in bytes, for a single highly compressed ZIP entry in an imported project backup.
This limit is only applied to entries that are large enough and compress enough to look suspicious. Large low-compression files are intentionally allowed here and are expected to be constrained by the HTTP upload limit. Defaults to 262144000 bytes (250 MiB).
In Docker, configure this using the
WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE environment
variable.
Veja também
PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE¶
Added in version 5.17.
Defines the minimum uncompressed size, in bytes, at which Weblate starts considering the ZIP compression ratio during project backup import.
Smaller files are ignored for the compression-ratio-based validation to avoid rejecting reasonably sized files that compress well. Defaults to 1048576 bytes (1 MiB).
In Docker, configure this using the
WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE environment variable.
Veja também
PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO¶
Added in version 5.17.
Defines the maximum allowed ratio between the uncompressed and compressed size for a large ZIP entry during project backup import.
This is used together with
PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE and
PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE to detect suspiciously
compressed entries while still allowing large repository pack files and other
low-compression content. Defaults to 250.
In Docker, configure this using the
WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO environment
variable.
Veja também
PROJECT_NAME_RESTRICT_RE¶
Added in version 4.15.
Define uma expressão regular para restringir a nomenclatura do projeto. Quaisquer nomes correspondentes serão rejeitados.
Veja também
PROJECT_WEB_RESTRICT_HOST¶
Added in version 4.16.2.
Rejeitar o uso de determinados hosts no site do projeto. Qualquer subdomínio é correspondido, então incluir example.com também irá bloquear test.example.com. A lista deve conter apenas cadeias em letras minúsculas, o domínio analisado é transformado em letras minúsculas antes da corresponder.
Configuração padrão:
PROJECT_WEB_RESTRICT_HOST = {"localhost"}
PROJECT_WEB_RESTRICT_ALLOWLIST¶
Added in version 5.17.
Defines a set of project slugs exempt from
PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC,
PROJECT_WEB_RESTRICT_PRIVATE, and
PROJECT_WEB_RESTRICT_RE when validating the project website.
Project slugs are matched case-insensitively.
Cuidado
This exemption weakens outbound URL protections for matching projects,
including the private-target restriction enforced by
PROJECT_WEB_RESTRICT_PRIVATE. Use it only for trusted,
administrator-managed projects where bypassing these checks is intentional.
Configuração padrão:
PROJECT_WEB_RESTRICT_ALLOWLIST = set()
PROJECT_WEB_RESTRICT_NUMERIC¶
Added in version 4.16.2.
Rejeite o uso de endereço IP numérico no site do projeto. Ativado por padrão.
PROJECT_WEB_RESTRICT_PRIVATE¶
Added in version 5.17.
Reject using project website and repository browser URLs pointing to internal or non-public addresses. On by default.
PROJECT_WEB_RESTRICT_RE¶
Added in version 4.15.
Define uma expressão regular para limitar o qua pode ser inserido como Site da Web do Projeto. Quaisquer URLs correspondentes serão rejeitadas.
WEBHOOK_PRIVATE_ALLOWLIST¶
Added in version 5.17.
Defines hostnames or domains exempt from WEBHOOK_RESTRICT_PRIVATE
for outbound webhook delivery. Entries follow Django host matching semantics,
so values such as hooks.internal.example or .internal.example can be
used.
Configuração padrão:
WEBHOOK_PRIVATE_ALLOWLIST = []
Veja também
WEBHOOK_RESTRICT_PRIVATE¶
Added in version 5.17.
Reject webhook URLs pointing to internal or non-public addresses unless the
target host is included in WEBHOOK_PRIVATE_ALLOWLIST. On by default.
When enabled, hostnames that cannot be resolved during validation are rejected
unless they are explicitly included in WEBHOOK_PRIVATE_ALLOWLIST.
Veja também
PUBLIC_ENGAGE¶
Added in version 5.16.2.
Allows public engage page even with REQUIRE_LOGIN.
Veja também
RATELIMIT_NOTIFICATION_LIMITS¶
Added in version 5.14.
Limits how many notifications for a single user will be sent out.
The default setting is:
# Multi-level rate limiting for email notifications
# Each tuple contains (max_emails, time_window_seconds)
RATELIMIT_NOTIFICATION_LIMITS = [
# Prevent burst sends - 3 emails per 2 minutes
(3, 120),
# Equalize to avoid getting blocked for too long - 10 emails per hour
(10, 3600),
# Daily limit: 50 emails per day
(50, 86400),
]
RATELIMIT_ATTEMPTS¶
A quantidade máxima de tentativas de autenticação antes da limitação da taxa ser aplicada.
A predefinição é 5.
Veja também
RATELIMIT_WINDOW¶
Por quanto tempo a autenticação é aceita após a limitação da taxa ser aplicada.
Uma quantidade de segundos, padrão para 300 (5 minutos).
Veja também
RATELIMIT_LOCKOUT¶
Por quanto tempo a autenticação é bloqueada após a limitação da taxa ser aplicada.
Uma quantidade de segundos com a predefinição de 600 (10 minutos).
Veja também
REGISTRATION_ALLOW_BACKENDS¶
Added in version 4.1.
A lista de backends de autenticação de onde permite o registo. Isso só limita novos registos, os utilizadores ainda se podem autenticar e adicionar autenticação por todos os backends de autenticação configurados.
É recomendado para manter REGISTRATION_OPEN ativado enquanto limita os «backends» de registo, caso contrário, os utilizadores poderão registar-se, mas o Weblate não mostrará as hiperligações para registar na interface do utilizador.
Exemplo:
REGISTRATION_ALLOW_BACKENDS = ["azuread-oauth2", "azuread-tenant-oauth2"]
Dica
Os nomes de backend correspondem aos nomes usados na URL para autenticação.
Veja também
REGISTRATION_CAPTCHA¶
Se o registo de novas contas está protegido por CAPTCHA. O padrão é ativado.
If turned on, a CAPTCHA is added to all pages where a user enters their e-mail address:
Registo de uma conta nova.
Recuperação de palavra-passe.
Adição de uma e-mail a uma conta.
Formulário de contacto para utilizadores que não estão autenticados.
A proteção atualmente consiste nas seguintes etapas:
Captcha matemático a ser resolvido pelo utilizador.
Proof of work challenge calculated by the browser. The difficulty can be adjusted using
ALTCHA_COST,ALTCHA_MEMORY_COST, andALTCHA_PARALLELISM.
REGISTRATION_EMAIL_MATCH¶
Permite filtrar quais endereços de e-mail podem ser registados.
A predefinição é .*, que permite que registar qualquer endereço de e-mail.
Pode usá-lo para restringir o registo a um único domínio de e-mail:
REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"
REGISTRATION_ALLOW_DISPOSABLE_EMAILS¶
Added in version 5.16.1.
Allow registration with disposable e-mail domains. When enabled, the
disposable domain blocklist is bypassed. Default is False.
REGISTRATION_OPEN¶
Se o registo de novas contas é permitido atualmente. O padrão é ativado.
Esta configuração afeta a autenticação embutida por endereço de e-mail ou através do Python Social Auth (pode permitir certos back-ends usando REGISTRATION_ALLOW_BACKENDS).
Nota
Se estiver a usar métodos de autenticação de terceiros, como Autenticação por LDAP, ele apenas oculta o formulário de registo, mas novos utilizadores ainda conseguem se autenticar e criar contas.
REGISTRATION_REBIND¶
Added in version 4.16.
Permitir backends de autenticação de religação para utilizadores existentes. Ative isto ao migrar entre provedores de autenticação.
Nota
Desativado por padrão para não permitir a adição de outros backends de autenticação a uma conta existente. A religação pode levar ao comprometimento da conta ao usar mais back-ends de autenticação de terceiros.
REPOSITORY_ALERT_THRESHOLD¶
Added in version 4.0.2.
Limiar para acionar um alerta para repositórios desatualizados ou aqueles que contêm muitas alterações. A predefinçao é 25.
Veja também
REQUIRE_LOGIN¶
Added in version 4.1.
This enables django.contrib.auth.middleware.LoginRequiredMiddleware
and configures REST framework to require authentication for all API endpoints.
Alterado na versão 5.15: Weblate now relies on Django built-in middleware.
Nota
Isto é implementado em Configuração de amostra. Para Docker, utilizar WEBLATE_REQUIRE_LOGIN.
SENTRY_DSN¶
DSN do Sentry para usar para A coletar relatórios de erros e monitoramento do desempenho.
Veja também
SENTRY_ENVIRONMENT¶
Configura o ambiente para o Sentry. O padrão é devel.
SENTRY_MONITOR_BEAT_TASKS¶
Added in version 5.13.
Configure whether to monitor Celery Beat tasks with Sentry. Defaults to True.
SENTRY_PROFILES_SAMPLE_RATE¶
Configure a taxa de amostragem para monitoramento de desempenho. Defina como 1 para rastrear todos os eventos, 0 (o padrão) desativa o rastreamento.
Veja também
SENTRY_SEND_PII¶
Permitir que o Sentry colete determinadas informações de identificação pessoal. Desativado por padrão.
Alterado na versão 5.7: Isto está desativado por padrão agora, costumava estar ativado por padrão.
SENTRY_TRACES_SAMPLE_RATE¶
Configure a taxa de amostragem para monitoramento de perfil. Defina como 1 para rastrear todos os eventos, 0 (o padrão) desativa o rastreamento.
Veja também
SIMPLIFY_LANGUAGES¶
Use códigos de idioma simples para combinações predfinidas de idioma/país. Por exemplo, uma tradução de fr_FR usará o código de idioma fr. Este é geralmente o comportamento desejado, pois simplifica a lista de idiomas para essas combinações predefinidas.
Desative isto se quiser traduções diferentes para cada variante.
SITE_DOMAIN¶
Configura o domínio do site. Necessário para produzir ligações absolutas corretas em muitos escopos (por exemplo, ativação de e-mails, notificações ou feeds RSS).
Se o Weblate é executado numa porta fora do padrão, inclua-a aqui também.
Exemplos::
# Production site with domain name
SITE_DOMAIN = "weblate.example.com"
# Local development with IP address and port
SITE_DOMAIN = "127.0.0.1:8000"
Nota
Esta configuração deve conter apenas o nome de domínio. Para configurar o protocolo (ativar e aplicar HTTPS), use ENABLE_HTTPS e para alterar o URL, use URL_PREFIX.
Dica
Num contentor Docker, o domínio do site é configurado através de WEBLATE_ALLOWED_HOSTS.
SITE_TITLE¶
Título do site a ser usado para o site e e-mails enviados.
SPECIAL_CHARS¶
Caracteres adicionais para incluir no teclado visual, Teclado visual.
O valor predefinido é:
SPECIAL_CHARS = ("\t", "\n", "\u00a0", "…")
SINGLE_PROJECT¶
Redireciona os utilizadores diretamente para um projeto ou componente em vez de mostrar o painel. Pode configurá-lo como True para que funcione apenas se houver um único projeto no Weblate. Alternativamente, defina o projeto, e este redirecionará incondicionalmente para este projeto.
Exemplo:
SINGLE_PROJECT = "test"
SSH_EXTRA_ARGS¶
Added in version 4.9.
Permite adicionar parâmetros personalizados quando o Weblate chama o SSH. Útil ao se conectar a servidores usando criptografia legada ou outros recursos não padrão.
Por exemplo, quando a conexão SSH em Weblate falha com Unable to negotiate with legacyhost: no matching key exchange method found. Their offer: diffie-hellman-group1-sha1, pode ativar isso usando:
SSH_EXTRA_ARGS = "-oKexAlgorithms=+diffie-hellman-group1-sha1"
Dica
A cadeia é avaliada pelo shell, portanto, certifique-se de que todos os espaços em branco e caracteres especiais estejam entre aspas.
Veja também
STATUS_URL¶
A URL onde a sua instância de Weblate relata o estado dela.
SUPPORT_STATUS_CHECK¶
Added in version 5.5.
Desativa a verificação semianual do estado de apoio e redireciona os utilizadores avançados para a página de donativos depois da autenticação no caso de não haver uma subscrição de apoio ativa.
Dica
Melhore a sua experiência com o Weblate comprando uma assinatura de suporte e impulsionando o progresso do Weblate, em vez de desativá-lo.
TRANSLATION_UPLOAD_MAX_SIZE¶
Added in version 5.17.1.
Configures the maximum size, in bytes, for uploaded translation files. Defaults to 50 MB.
In Docker, configure this using the WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE
environment variable.
UNUSED_ALERT_DAYS¶
Added in version 4.17.
Configura quando o alerta de Componente parece não utilizado é acionado.
O padrão é 365 dias, defina como 0 para desativar.
UPDATE_LANGUAGES¶
Added in version 4.3.2.
Controla se a base de dados de idiomas deve ser atualizada ao executar a migração de bases de dados e está ativado por padrão. Esta configuração não tem efeito na invocação de setuplang.
Aviso
A exibição de idiomas pode se tornar inconsistente com isto. As definições de idioma do Weblate se expandem ao longo do tempo e não exibirão o código de idioma para os idiomas definidos.
Veja também
URL_PREFIX¶
Esta configuração permite que execute Weblate em algum caminho (caso contrário, depende de ser executado a partir da raiz do servidor web).
Nota
Para usar esta configuração, também precisa configurar o seu servidor para remover este prefixo. Por exemplo, com o WSGI, isso pode ser alcançado definindo WSGIScriptAlias.
Dica
O prefixo deve iniciar com um /.
Exemplo:
URL_PREFIX = "/translations"
Nota
Esta configuração não funciona com o servidor embutido do Django, teria que ajustar urls.py para conter este prefixo.
VCS_ALLOW_HOSTS¶
Added in version 5.15.
A set of hosts to allow when configuring VCS URL. Defaults to an empty set, which does no filtering at all.
When VCS_RESTRICT_PRIVATE is enabled, matching hosts are also exempt
from the private-target restriction.
VCS_ALLOW_SCHEMES¶
Added in version 5.15.
A set of URL schemes to allow when configuring VCS URL. Only https and
ssh are allowed by default.
VCS_RESTRICT_PRIVATE¶
Added in version 5.17.
Reject VCS repository URLs pointing to internal or non-public addresses unless
the target host is included in VCS_ALLOW_HOSTS. On by default.
When enabled, hostnames that cannot be resolved during validation are rejected
unless they are explicitly included in VCS_ALLOW_HOSTS.
VCS_API_DELAY¶
Added in version 4.15.1.
Configures minimal delay in seconds between third-party API calls in Pull requests do GitHub, Merge requests do GitLab, Pull requests do Gitea, Merge requests do Pagure, and Pull requests do Azure DevOps.
Esta taxa limita as chamadas de API do Weblate a esses serviços para evitar sobrecarregá-los.
Se estiver afetado pelo limitador de taxa secundário no GitHub, aumentar isto pode ajudar.
O valor predefinido é 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 Pull requests do GitHub, Merge requests do GitLab, Pull requests do Gitea, Merge requests do Pagure, and Pull requests do Azure DevOps.
O valor predefinido é 10.
VCS_BACKENDS¶
Configuração de backends VCS disponíveis.
Nota
Weblate tenta usar todos os back-ends suportados para os seus utilizadores.
Dica
Pode limitar escolhas ou adicionar back-ends VCS personalizados a usar isto.
VCS_BACKENDS = ("weblate.vcs.git.GitRepository",)
Veja também
VCS_CLONE_DEPTH¶
Configura a profundidade a clonagem de repositórios Weblate deve ter.
Nota
Atualmente, isto só é suportado em Git. Por predefinição, o Weblate faz clones rasos dos repositórios para tornar a clonagem mais rápida e economizar espaço no disco. Dependendo do seu uso (por exemplo, ao usar o personalizado Extensões), pode aumentar a profundidade ou desligar os clones rasos completamente definindo isso para 0.
Dica
No caso de receber o erro fatal: protocol error: expected old/new/ref, got 'shallow <hash de commit>' ao fazer push do Weblate, desative clones rasos completamente configurando:
VCS_CLONE_DEPTH = 0
WEBLATE_ADDONS¶
Lista de extensões disponíveis para uso. Para usá-las, elas devem ser ativadas para um determinado componente de tradução. Por padrão, isso inclui todas as extensões embutidas, ao estender a lista, provavelmente pdoe manter as existentes ativadas, por exemplo:
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",
)
Nota
A remoção da extensão da lista não a desinstala dos componentes. Weblate vai travar nesse caso. Por favor, desinstale a extensão de todos os componentes antes de removê-la desta lista.
ADDON_ACTIVITY_LOG_EXPIRY¶
Added in version 5.6.
Configura por quanto tempo os logs de atividade dos complementos são mantidos. O padrão é de 180 dias.
WEBLATE_EXPORTERS¶
Added in version 4.2.
Lista dos exportadores disponíveis que oferecem a transferência de traduções ou glossários em vários formatos de ficheiro.
Veja também
WEBLATE_FORMATS¶
Lista de formatos de ficheiro disponíveis para uso.
Nota
A lista predefinida já tem os formatos comuns.
Veja também
WEBLATE_MACHINERY¶
Added in version 4.13.
Lista de serviços de tradução disponíveis para uso.
WEBLATE_GPG_IDENTITY¶
Identidade usada pelo Weblate para assinar os commits Git, por exemplo:
WEBLATE_GPG_IDENTITY = "Weblate <weblate@example.com>"
O chaveiro GPG do Weblate é pesquisado por uma chave correspondente (home/.gnupg em DATA_DIR). Se não for encontrado, uma chave é gerada. Consulte Assinando commits do Git com GnuPG para mais detalhes.
Veja também
WEBSITE_REQUIRED¶
Define se Site da Web do Projeto deve ser especificado ao criar um projeto. Ativado por padrão, pois se adapta às configurações do servidor público.
WEBSITE_ALERTS_ENABLED¶
Added in version 5.17.
Default: True
Defines whether Weblate should check project website availability and show alerts for unreachable project websites.
When set to False, Weblate will skip website availability checks and
will not generate project website alerts. This is useful when:
Your websites are behind firewalls that block Weblate’s requests
You want to avoid 403/503-type errors from bot protection
Project website availability is not a concern for your installation
Veja também
Configurar credenciais para controle de versão¶
Dica
Esta secção descreve as variáveis de credenciais do VCS como GITHUB_CREDENTIALS, GITLAB_CREDENTIALS, GITEA_CREDENTIALS, PAGURE_CREDENTIALS, BITBUCKETSERVER_CREDENTIALS.
O dicionário de configuração consiste em credenciais definidas para cada host de API. O host da API pode ser diferente do que usa no navegador web, por exemplo, a API do GitHub é acedida como api.github.com.
As credenciais também podem ser substituídas em URL de submissão do repositório ou Repositório do código-fonte (se o URL de push não estiver configurado), elas têm precedência sobre as especificadas no ficheiro de configuração.
A seguinte configuração está disponível para cada host:
usernameUtilizador API, necessário.
tokenToken de API para o utilizador da API, obrigatório.
schemeAdded in version 4.18.
Substituição de esquema. O Weblate tenta analisar o esquema a partir do URL do repositório e reverter para
https. Se executar o servidor da API internamente, talvez queira utilizarhttpem vez disso, mas considere a segurança.
Dica
No contentor do Docker, as credenciais podem ser configuradas usando variáveis de ambiente, consulte Credenciais de sites de hospedagem de código.