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.

Configura quais domínios são permitidos para obter recursos no Weblate.

Isto melhora a segurança ao prevenir carregar recursos de fontes não confiadas. Recursos são descarregados uma vez pelo servidor Weblate e armazenados localmente, em vez de serem servidos diretamente de domínios externos para utilizadores.

A lista de permissões é aplicada ao URL inicial e a cada alvo de redirecionamento HTTP antes que o Weblate o siga. Redirecionamentos para anfitriões fora desta lista de permissões são rejeitados.

Espera uma lista de anfitriões/nomes de domínio. Pode usar nomes qualificados completos (p.ex. www.example.com) ou antecedido com um ponto enquanto caratere curinga para corresponder todos os subdomínios (p.ex .example.com irá corresponder cdn.example.com ou static.example.com).

O padrão é ["*"] que permite todos os domínios.

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:

Veja também

ALLOWED_MACHINERY_DOMAINS

Configura quais domínios de maquinaria personalizados são explicitamente permitidos na configuração de tradução máquina ao nível do projeto.

Esta configuração aplica-se apenas a serviços de maquinaria e não afeta ALLOWED_ASSET_DOMAINS.

Espera uma lista de anfitriões/nomes de domínio. Pode usar nomes qualificados completos ou anteceder com um ponto enquanto caratere curinga para corresponder todos os subdomínios.

A predefinição é [].

A lista de permissão afeta maquinaria de gestão de projetos de duas maneiras: permite o ponto final configurado durante a validação de saída, e marca anfitriões correspondentes como confiáveis ao decidir se os detalhes de erros ou corpos da resposta do fornecedor remoto podem ser mostrados ao utilizador. Para conexões diretas, verificações em tempo de execução ainda rejeitam destinos que remetem para endereços privados ou que, de alguma forma, não sejam públicos. Quando um proxy HTTP(S) é usado, validação em tempo de execução recorre à validação do nome de anfitrião e não realiza as mesmas verificações de DNS local nem de IP de pares.

ALLOWED_ASSET_SIZE

Added in version 5.14.

Configura o limite de tamanho em bytes para buscar ou carregar recursos para o Weblate. A predefinição é 10MB.

Veja também

ASSET_PRIVATE_ALLOWLIST

Added in version 2025.5.

Define os nomes de anfitriões ou domínios isentos de ASSET_RESTRICT_PRIVATE para o descarregar de recursos remotos que aplicam verificações de alvo privado. Entradas seguem semânticas de correspondência de anfitriões Django, e por isso valores com o assets.internal.example ou .internal.example podem ser usados.

Isto não substitui ALLOWED_ASSET_DOMAINS; recursos remotos ainda têm que corresponder a lista de permissões de domínios de recursos.

Configuração padrão:

ASSET_PRIVATE_ALLOWLIST = []

Veja também

ASSET_RESTRICT_PRIVATE

Added in version 2025.5.

Rejeita URLs de recursos remotos que apontam para endereços internos ou não públicos a não ser que o anfitrião alvo está incluído na ASSET_PRIVATE_ALLOWLIST. Ativo por predefinição.

Quando ativo, nomes de anfitrião que não podem ser resolvidos durante a validação são rejeitados, a não ser que sejam explicitamente incluídos em ASSET_PRIVATE_ALLOWLIST. Isto atualmente aplica-se a URL de envios de capturas de ecrã e descarregamentos HTML remotos para o extra CDN de localização JavaScript.

Veja também

ALTCHA_COST

Added in version 2025.5.

Custo de tempo do Argon2id para o desafio de prova de trabalho ALTCHA. A predefinição é 3.

Susbtitui ALTCHA_MAX_NUMBER, que é aplicado ao widget removido ALTCHA v2.

ALTCHA_MEMORY_COST

Added in version 2025.5.

Custo de memória do Argon2id em KiB. A predefinição é 65536.

ALTCHA_PARALLELISM

Added in version 2025.5.

O fator de paralelismo do Argon2id. A predefinição é 1.

Veja também

Mecanismo de prova de trabalho ALTCHA

ANONYMOUS_USER_NAME

O nome de utilizadores não autenticados.

Veja também

Controlo de acesso

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

Limitação de taxa

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ém False

Atualizar apenas os repositórios remotos.

"full" e também True

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

Veja também

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:

Escolhas possíveis:

  • monthly (este é o padrão)

  • weekly

  • daily

  • never

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

Definições de idioma

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/"]

Veja também

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.

O Weblate armazena ficheiros auxiliares gerados aqui e executa alguns deles, por isso tem que ser possível escrever em CACHE_DIR e montado em um sistema de ficheiros que permite execução. Evite usar as opções de montagem noexec para este diretório.

O contentor de Docker utiliza um volume separado para isto, consulte Volumes de contentor Docker.

Os subdiretórios seguintes geralmente existem:

ssh

Ficheiros auxiliares gerados usado para acesso VCS.

fonts

font-config cache para Gerir letras.

avatar

Avatares de utilizador em cache, consulte Avatares.

static

Localização padrão para ficheiros de Django estáticos, especificados por STATIC_ROOT. Veja Servir ficheiros estáticos.

tesseract

Dados 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

Personalize o Content-Security-Policy cabeçalho para o Weblate. O cabeçalho é gerado automaticamente com base nas integrações ativadas com serviços de terceiros (Matomo, Google Analytics, Sentry, …).

Todos esses tem uma lista vazia como predefinição.

Exemplo:

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

Veja também

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.

Veja também

COMMIT_PENDING_HOURS

Quantidade de horas entre fazer o commit de alterações pendentes por meio da tarefa de segundo plano.

Veja também

COMPONENT_ZIP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Configura o tamanho máximo, em bytes, para ficheiros ZIP de componentes enviados. A predefinição é 50MB.

No Docker, configure isto usando a variável de ambiente WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE.

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"

O remetente é usado como Reply-To, este é o comportamento padrão.

"from"

O remetente é utilizado como From. O seu servidor de correio eletrónico precisa de permitir o envio de tais mensagens.

"disabled"

Desativa o formulário de contacto na íntegra.

Added in version 5.15.

Veja também

ADMINS_CONTACT

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:

home

O diretório pessoal usado para invocar scripts.

ssh

Chaves e configuração de SSH.

media

Localização padrão para ficheiros de mídia Django, especificado por MEDIA_ROOT. Contém capturas de ecrã enviadas, veja Screenshots and visual context.

vcs

Repositórios de controle de versão para traduções.

backups

Backup diário de dados. Por favor, verifique Dados despejados para backups para pormenores.

fonts:

Fontes enviadas pelo utilizador, veja Gerir letras.

cache

Vá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.

Veja também

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

Efetuar cópias de segurança e mover o Weblate

DEFAULT_ACCESS_CONTROL

A configuração padrão de controle de acesso para novos projetos:

0

Público

1

Protegido

100

Privado

200

Personalizado

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

Notificações

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.

As predefinições embutidas seguem o Conventional Commits e incluem links do Weblate sempre que disponível. Mudas estas definições afeta predefinições recentemente criadas; modelos de mensagem existentes podem ser reiniciadas nos formulários de definições com Restaurar predefinições do site. Para valores herdados, restaurar as predefinições do site também desativa a herança para tal mensagem.

Veja também

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

DEFAULT_COMMITER_NAME

Nome do committer, padrão para Weblate.

Veja também

DEFAULT_COMMITER_EMAIL

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_SHARED_TM

Configura o valor padrão de Utilizar memória de tradução partilhada e Contribuir para a memória de tradução partilhada.

DEFAULT_TRANSLATION_REVIEW

Added in version 5.16.

Configura o valor predefinido para Activar revisões, desativado por predefinição.

DEFAULT_SOURCE_REVIEW

Added in version 5.16.

Configura o valor predefinido para Ativar revisões de fontes, desativado por predefinição.

DEFAULT_AUTOCLEAN_TM

Added in version 5.13.

Configura o valor predefinido para Limpar memória de tradução automaticamente.

DEFAULT_TRANSLATION_PROPAGATION

Configuração predefinida para propagação de tradução, a predefinição é True.

Veja também

DEFAULT_PULL_MESSAGE

Configura o título e a mensagem padrão para pull requests.

A predefinição embutida segue Conventional Commits e inclui links do Weblate e estado de tradução.

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

Hooks de notificação

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.

Veja também

ENABLE_SHARING

Ativa/desativa o menu Comunidade para que os utilizadores possam compartilhar o progresso da tradução nas redes sociais.

Veja também

Building the translation community

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.

Veja também

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

O token de acesso pessoal precisa do escopo api para conseguir utilizar a 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.

Veja também

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

Para clonar, fazer push ou criar pull requests, é necessário ter o acesso de leitura e escrita para Contents e Pull requests.

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 como um host da API para 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.

Veja também

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.

Veja também

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:

username

API do utilizador.

workspace

O slug do espaço de trabalho do utilizador.

token

O token API com permissão pullrequest:write.

Configurações adicionais não descritas aqui encontram-se em Configurar credenciais para controle de versão.

Veja também

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:

username

O nome do projeto Azure DevOps. Este não é o nome do repositório.

organization

O nome da organização do projeto.

workItemIds

Uma lista opcional de IDs de elementos de trabalho da sua organização. Quando fornecida, novos pull requests terão estes elementos anexados.

token

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

Veja também

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.

Por exemplo, em vez de https://utilizador:palavra-passe@git.example.com/repo.git, vai mostrar apenas https://git.example.com/repo.git. Tenta limpar mensagens de erro VCS também de forma semelhante.

Nota

Ativado por padrão.

VERSION_DISPLAY

Added in version 5.17.

Controla o quão proeminente o Weblate expõe a sua própria versão.

Os valores suportados são:

show

Mostra a versão no UI partilhado como um rodapé e expõe-o em GET /api/metrics/.

soft

Esconde a versão do UI proeminente partilhado, enquanto que mantém-o descobrível na página Sobre e em GET /api/metrics/.

hide

Oculta a versão do UI partilhado e GET /api/metrics/. Isto também faz com que links de documentação anónimos apontem para a documentação mais recente em vez da versão que corresponde à versão de instalação.

Ocultar a versão é uma prática de segurança recomendada em algumas empresas, mas isso não impede um atacante de inferir a versão por meio de sondagem de comportamentos.

Nota

O valor predefinido é show.

HIDE_VERSION

Added in version 4.3.1.

Obsoleto desde a versão 5.17.

Atalho de compatibilidade para VERSION_DISPLAY. Defina isto para True para obter o mesmo comportamento que 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.

Veja também

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.

Veja também

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.

Veja também

LICENSE_EXTRA

Licenças adicionais para incluir nas opções de licença.

Nota

Cada definição de licença deve ser uma tupla do seu nome curto, um nome longo, um URL e um boolean, indicando se é uma licença livre.

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

Translation component diagnostics

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

O padrão é True.

LOCALIZE_CDN_URL e LOCALIZE_CDN_PATH

Essas configurações configuram os extras CDN, incluindo CDN de localização JavaScript e Ficheiros de tradução CDN. LOCALIZE_CDN_URL definem URL raiz onde a localização do CDN está disponível e LOCALIZE_CDN_PATH define o caminho onde o Weblate deve armazenar ficheiros gerados que serão servidos no LOCALIZE_CDN_URL. Os ficheiros são servidos pelo seu servidor web ou CDN, e não pelo Weblate; veja CDN de localização para orientação de serviço seguro.

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

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

MATOMO_SITE_ID

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.

Veja também

PASSWORD_RESET_URL

Added in version 5.17.

O URL para reiniciar a palavra-passe quando a autenticação é tratada por um fornecedor de identidade externo, tal como LDAP, SAML, ou OAuth.

Quando definido, Esqueceu-se da sua palavra-passe na página de início de sessão dá link para este URL em vez da página de reinicio de palavra-passe embutida do Weblate.

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 quer hospedar a sua política de privacidade fora do Weblate em vez de usar o módulo Módulo legal. Quando o módulo legal está ativo, o Weblate dá link para as páginas legais internas por predefinição.

Exemplo:

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

Veja também

LEGAL_URL

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.

Modelo para gerar um e-mail de commit privado para um utilizador. O padrão é "{username}@users.noreply.{site_domain}".

Pode conter {user_id}, {username}, {site_title}, e {site_domain}.

Defina para cadeia vazia para desativar.

Nota

O uso de um e-mail de commit diferente é opcional para os utilizadores, a menos que configurado por PRIVATE_COMMIT_EMAIL_OPT_IN. Os utilizadores podem configurar o seu e-mail de commit no Perfil.

PRIVATE_COMMIT_NAME_OPT_IN

Added in version 5.16.

Configura se o nome 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 nome de commit.

Veja também

PRIVATE_COMMIT_NAME_TEMPLATE

Added in version 5.16.

Modelo para gerar um nome de commit privado para um utilizador. O padrão é "{site_title} user {user_id}"..

Pode conter {user_id}, {username}, {site_title}, e {site_domain}.

Defina para cadeia vazia para desativar.

Nota

O uso de um nome de commit diferente é opcional para os utilizadores, a menos que configurado por PRIVATE_COMMIT_NAME_OPT_IN. Os utilizadores podem configurar o seu nome de commit no 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

Cópias de segurança de nível de projeto

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

Cópias de segurança de nível de projeto

PROJECT_BACKUP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Configura o tamanho máximo, em bytes, para enviar os ficheiros de cópia de segurança do projeto. A predefinição é 536870912 bytes (512 MiB).

No Docker, configure isto usando a variável de ambiente WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE. As configurações de Docker também podem ser limitadas por CLIENT_MAX_BODY_SIZE; outras implementações podem ser limitadas pelo limite do tamanho do corpo do pedido do proxy reverso.

Veja também

Cópias de segurança de nível de projeto

PROJECT_BACKUP_IMPORT_MAX_MEMBERS

Added in version 5.17.

Define o número máximo de entradas ZIP permitidas ao importar uma cópia de segurança do projeto.

Isto é uma salvaguarda contra arquivos mal formados ou intencionalmente fragmentados. A predefinição é de 100000 entradas.

No Docker, configure isto usando a variável de ambiente WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS.

Veja também

Cópias de segurança de nível de projeto

PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE

Added in version 5.17.1.

Defines o tamanho máximo total não compresso, em bytes, para entradas ZIP em uma cópia de segurança de projeto importada. A predefinição é 536870912 bytes (512 MiB).

Isto limita arquivos que são pequenos quando enviados mas expandem para muitos mais dados durante a validação ou restauro.

No Docker, configure isto usando a variável de ambiente WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE.

Veja também

Cópias de segurança de nível de projeto

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE

Added in version 5.17.

Define o tamanho não comprimido máximo, em bytes, para uma única entrada ZIP altamente compressa em uma cópia de segurança de projeto importada.

Este limite aplica-se apenas a entradas que são grandes o suficiente e comprimidas o suficiente para parecerem suspeitas. Ficheiros grandes de baixa compressão são intencionalmente permitidos aqui e espera-se que sejam limitados pelo limite de envio HTTP. A predefinição é 262144000 bytes (250 MiB).

No Docker, configure isto usando a variável de ambiente WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE.

Veja também

Cópias de segurança de nível de projeto

PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE

Added in version 5.17.

Define o tamanho não compresso mínimo, em bytes, ao qual o Weblate começa a considerar o rácio de compressão ZIP durante o importe da cópia de segurança de projeto.

Ficheiros mais pequenos são ignorados para a validação baseada em rácio de compressão para evitar rejeitar ficheiros de tamanho razoável que comprimem bem. A predefinição é 1048576 bytes (1 MiB).

No Docker, configure isto usando a variável de ambiente WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE.

Veja também

Cópias de segurança de nível de projeto

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO

Added in version 5.17.

Define o rácio máximo permitido entre o tamanho compresso e não compresso para uma entrada ZIP grande durante a importação da cópia de segurança do projeto.

Isto é usado em conjunto com PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE e PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE para detetar entradas comprimidas suspeitas enquanto ainda permite ficheiros de pacote de repositório grande e outro conteúdo de baixa compressão. A predefinição é 250.

No Docker, configure isto usando a variável de ambiente WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO.

Veja também

Cópias de segurança de nível de projeto

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

Nome do projeto

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

Veja também

PROJECT_WEB_RESTRICT_ALLOWLIST

Added in version 5.17.

Define um conjunto de abreviações isentas de PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_PRIVATE e PROJECT_WEB_RESTRICT_RE ao validar o website do projeto. Abreviações do projeto correspondidas sem distinção entre maiúsculas e minúsculas.

Cuidado

Esta isenção enfraquece proteções de saída URL para projetos correspondentes, incluindo a restrição de alvo privado aplicado pela PROJECT_WEB_RESTRICT_PRIVATE. Use-a apenas para projetos confiados, geridos por administrador onde saltar estas verificações é intencional.

Configuração padrão:

PROJECT_WEB_RESTRICT_ALLOWLIST = set()

Veja também

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.

Veja também

PROJECT_WEB_RESTRICT_PRIVATE

Added in version 5.17.

Rejeita usar o website do projeto e os URLs do navegador do repositório que apontam para endereços internos ou não públicos. Ativo por predefinição.

Veja também

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.

Veja também

WEBHOOK_PRIVATE_ALLOWLIST

Added in version 5.17.

Define nomes de anfitriões ou domínios isentes de WEBHOOK_RESTRICT_PRIVATE para entrega de webhooks de saída. Entradas seguem semânticas de correspondência de anfitrião Django, e por isso valores como hooks.internal.example ou .internal.example podem ser usados.

Configuração padrão:

WEBHOOK_PRIVATE_ALLOWLIST = []

Veja também

WEBHOOK_RESTRICT_PRIVATE

Added in version 5.17.

Rejeita URLs de webooks que apontam para endereços internos ou não públicos a não ser que o anfitrião alvo esteja incluído em WEBHOOK_PRIVATE_ALLOWLIST. Ativo por predefinição.

Quando ativo, nomes de anfitrião que não podem ser resolvidos durante a validação são rejeitados a não ser que sejam explicitamente incluídos em WEBHOOK_PRIVATE_ALLOWLIST.

Veja também

PUBLIC_ENGAGE

Added in version 5.16.2.

Permite uma página de participação do público mesmo com REQUIRE_LOGIN.

Veja também

RATELIMIT_NOTIFICATION_LIMITS

Added in version 5.14.

Limita quantas notificações para um único utilizador serão enviadas.

A configuração padrão é:

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

Se for ativado, um CAPTCHA é adicionado a todas as páginas onde um utilizador digita o endereço de e-mail dele:

  • 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:

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.

Permitir registo com domínios de e-mail descartáveis. Quando ativo, a lista de bloqueios de domínios descartável é ignorada. A predefinição é False.

Veja também

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.

Veja também

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

Translation component diagnostics

REQUIRE_LOGIN

Added in version 4.1.

Isto ativa django.contrib.auth.middleware.LoginRequiredMiddleware e configura o framework REST para exigir autenticação para todos os pontos finais da API.

Alterado na versão 5.15: Weblate agora recorre ao middleware integrado do Django.

Nota

Isto é implementado em Configuração de amostra. Para Docker, utilizar WEBLATE_REQUIRE_LOGIN.

GOOGLE_CLOUD_ERROR_REPORTING

Configuração para A coletar relatórios de erros e monitoramento do desempenho usando Google Cloud Error Reporting. Defina para None para desativar a integração, ou defina um dicionário de argumentos de palavra chave para o cliente Google Cloud Error Reporting.

O Weblate fornece serviço na forma de weblate e versão enquanto a versão atual do Weblate ou revisão Git. Valores explícitos no dicionário sobrescrevem estes valores.

OPENTELEMETRY_ENABLED

Added in version 2026.6.

Ativa o rastreio de backend usando OpenTelemetry. Desativado por predefinição.

Rastreios são exportados apenas quando isto é ativo e OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT está configurado.

OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT

Rastreios de endpoint OTLP HTTP para OpenTelemetry, por exemplo https://collector.example.com/v1/traces.

OPENTELEMETRY_EXPORTER_OTLP_HEADERS

Cabeçalhos HTTP adicionais para o exportador OTLP OpenTelemetry. A predefinição é um dicionário vazio.

OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES

Atributos de recurso OpenTelemetry adicionais. A predefinição é um dicionário vazio.

OPENTELEMETRY_SERVICE_NAME

Nome de serviço OpenTelemetry. A predefinição é weblate.

OPENTELEMETRY_TRACES_SAMPLE_RATE

Configure a taxa de amostragem para rastreios do OpenTelemetry. Defina como 1 para rastrear todos os eventos, 0 (o padrão) desativa o rastreamento.

SENTRY_DSN

DSN do Sentry para usar para A coletar relatórios de erros e monitoramento do desempenho.

Veja também

Integração Django para o Sentry

SENTRY_ENVIRONMENT

Configura o ambiente para o Sentry. O padrão é devel.

SENTRY_MONITOR_BEAT_TASKS

Added in version 5.13.

Configura se se monitoriza ou não tarefas Celery Beat com Sentry. A predefinição é True.

SENTRY_PROFILES_SAMPLE_RATE

Configure a taxa de amostragem para monitorizar de desempenho. Defina como 1 analizar todos os eventos rastreados (o padrão), 0 desativa o rastreamento.

Veja também

Monitoramento de Desempenho do Sentry

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

Perfil do Sentry

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.

HIDE_SHARED_GLOSSARY_COMPONENTS

Added in version 5.16.

Componentes de glossário são tipicamente partilhados em outros projetos para fazê-los disponíveis para trabalho da tradução. Quando estes são visíveis na lista de componentes dos projetos que os estão a usar, pode causar confusão ou distrair tradutores dos componentes reais que se destinam a ser traduzidos.

Isto está desativado por padrão, que torna componentes de glossário partilhados visíveis.

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.

Veja também

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

Opções legadas do OpenSSH

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.

Configura o tamanho máximo, em bytes, para os ficheiros de tradução enviados. A predefinição é 50 MB.

No Docker, configure isto usando a variável de ambiente WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE.

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

Definições integradas de idioma

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.

Um conjunto de anfitriões a permitir durante a configuração do URL VCS. A predefinição é um conjunto vazio, que não faz qualquer filtragem.

Quando VCS_RESTRICT_PRIVATE está ativo, os anfitriões correspondentes também estão isentos de qualquer restrição de alvo privado.

VCS_ALLOW_SCHEMES

Added in version 5.15.

Um conjunto de esquemas URL a permitir ao configurar o URL VCS. Apenas https e ssh são permitidos por predefinição.

VCS_RESTRICT_PRIVATE

Added in version 5.17.

Rejeita URLs de repositório VCS que apontam para endereços interno ou não públicos a não ser que o anfitrião alvo esteja incluído em VCS_ALLOW_HOSTS. Ativo por predefinição.

Quando ativo, nomes de anfitrião que não podem ser resolvidos durante a validação são rejeitados a não ser que sejam explicitamente incluídos em VCS_ALLOW_HOSTS.

VCS_API_DELAY

Added in version 4.15.1.

Configura o atraso mínimo em segundos, entre chamadas de API de terceiros em Pull requests do GitHub, Merge requests do GitLab, Pull requests do Gitea, Merge requests do Pagure, e 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.

Configura o tempo limite em segundos para chamadas API de terceiros como bifurcar ou criar merge requests em Pull requests do GitHub, Merge requests do GitLab, Pull requests do Gitea, Merge requests do Pagure, e 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

Integração de controlo de versões

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.

Veja também

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.

List of available exporters offering translation downloads or glossaries in various file formats.

Veja também

Formatos de ficheiro de localização

WEBLATE_FORMATS

Lista de formatos de ficheiro disponíveis para uso.

Nota

A lista predefinida já tem os formatos comuns.

Veja também

Formatos de ficheiro de localização

WEBLATE_MACHINERY

Added in version 4.13.

Lista de serviços de tradução disponíveis para uso.

Veja também

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

Assinando commits do Git com GnuPG

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.

Predefinição: True

Define se o Weblate deve verificar a disponibilidade de projeto do website e mostrar alertas para websites de projetos inalcançáveis.

Quando definido para False, o Weblate ignorará verificações de disponibilidade do website e não gerará alertas do website do projeto. Isto é útil quando:

  • Os seus websites estão atrás de firewalls que bloqueiam os pedidos do Weblate

  • Quer evitar erros do tipo 403/503 de proteção de robôs

  • A disponibilidade do website do projeto não é uma preocupação para a sua instalação

Veja também

WEBSITE_REQUIRED

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:

username

Utilizador API, necessário.

token

Token de API para o utilizador da API, obrigatório.

scheme

Added 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 utilizar http em 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.