Módulos opcionais do Weblate

Estão disponíveis vários módulos opcionais para você configurar.

Exportador git

Fornece acesso de apenas leitura ao repositório Git subjacente usando HTTP(S).

Instalação

  1. Adicione weblate.gitexport às apps instaladas em settings.py:

    INSTALLED_APPS += ("weblate.gitexport",)

  2. Exporte repositórios existentes migrando a sua base de dados após a instalação:

    weblate migrate

Dica

O exportador Git está ativado na nossa imagem oficial do Docker. Para desativá-lo, use:

WEBLATE_REMOVE_APPS=weblate.gitexport

Uso

O módulo conecta-se automaticamente ao Weblate e define a URL do repositório exportado na Configuração de componente. Os repositórios são acessíveis na parte /git/ da URL do Weblate, por exemplo, https://example.org/git/weblate/main/.

Repositórios para projetos disponíveis publicamente podem ser clonados sem autenticação:

git clone 'https://example.org/git/weblate/main/'

O acesso para explorar os repositórios com acesso restrito (com controlo de acesso Privado ou quando REQUIRE_LOGIN está ativado) requer um código da API que pode ser obtido no seu perfil de utilizador:

git clone 'https://user:KEY@example.org/git/weblate/main/'

Nota

Weblate serves the Git repository itself, but it does not serve Git LFS objects. See Git LFS for supported behavior. Clone repositories using Git LFS from the upstream repository and add Weblate as another remote. If you only need Git-tracked files, you can clone from Weblate with GIT_LFS_SKIP_SMUDGE=1 to skip downloading Git LFS objects.

Dica

Por predefinição, os membros do grupo Utilizadores e utilizador anónimo têm acesso aos repositórios para projetos públicos via Acessar repositório e funções de Utilizador avançado.

Faturação

Isso é usado no Weblate Alojado para definir planos de faturação, rastrear faturas e limites de uso.

Instalação

1. Add weblate.billing to installed apps in settings.py:

INSTALLED_APPS += ("weblate.billing",)

  1. Execute a migração da base de dados para instalar opcionalmente estruturas de bases de dados adicionais para o módulo:

weblate migrate

Criação e atribuição de plano de faturação

Primeiro precisa criar um plano de faturação para ativar a cobrança. Navegue até a secção Administration (representada pelo ícone de chave inglesa) e abra o ecrã Tools. Depois aceda a Django admin interface.

Na interface administrativa do Django, localize a secção COBRANÇA e adicione um plano de cobrança. Por exemplo, pode adicionar um plano Free sem custo.

Se desejar atribuir um plano de faturação a um projeto existente, isto também pode ser feito na Interface administrativa Django usando a opção Faturação de clientes.

Por fim, a Django admin interface fornece uma opção Invoice para registar os pagamentos dos clientes.

Uso

Após a instalação, pode controlar a faturação na interface de administração. Os utilizadores com faturação ativada obterão um novo separador Faturação no seu Perfil do utilizador .

Superusers can view the 20 most recent billing audit entries on the billing detail page. Select View all in the Audit log section to browse older entries using the pagination controls.

O módulo de faturação também permite que os utilizadores criem novos projetos e componentes sem serem superutilizadores (veja Adicionar projetos e componentes de tradução). Isto é possível quando são cumpridas as seguintes condições:

  • A faturação está nos seus limites configurados (qualquer uso excessivo resulta no bloqueio da criação do projeto/componente) e pagos (se o preço for diferente de zero)

  • O utilizador tem a permissão Adicionar projetos ao espaço de trabalho para o espaço de trabalho abrangido pelo plano de faturação.

Ao criar o projeto o utilizador pode escolher que espaço de trabalho deve conter o projeto. Projetos criados em um espaço de trabalho com uma faturação são contabilizados no plano de faturação atribuído a esse espaço de trabalho. Utilizadores com a permissão Editar configurações de espaços de trabalho podem ver e pagar o plano de faturação; e-mails de notificação de faturação são enviados a estes utilizadores. Veja Faturação para detalhes.

Avatares

Os avatares são descarredaos e armazenados em cache no lado do servidor para reduzir o vazamento de informações para os sites que os servem por predefinição. O suporte embutido para buscar avatares de endereços de e-mail configurados para isso pode ser desligado usando ENABLE_AVATARS.

Atualmente, o Weblate oferece suporte a:

Veja também

CDN de localização

Os extras CDN de localização JavaScript e Ficheiros de tradução CDN escrevem ficheiros para LOCALIZE_CDN_PATH; o Weblate não os disponibiliza. Configure o servidor web ou CDN servindo LOCALIZE_CDN_URL como um servidor de ficheiros estáticos, público e apenas de leitura.

Tratar todos os ficheiros CDN publicados como públicos. O UUID específico do extra no URL não é um mecanismo de controlo de acesso. Não ative extras de CDN para componentes que contenham cadeias de carateres privadas, texto de produtos não lançados, dados do cliente, URLs internos, exemplos de API, caminhos de repositório, comentários de tradutor, ou metadados do formato de ficheiro que não devem ser expostos.

O extra Ficheiros de tradução CDN publica ficheiros de tradução brutos em formatos suportados pelo Weblate. Alguns formatos podem ser interpretados por navegadores ou outros clientes como HTML, SVG, XML, JavaScript, YAML, ou configuração específica da aplicação. Servir o CDN a partir de um domínio dedicado, distinto do Weblate e da aplicação a consumir as traduções. Não partilhe cookies de autenticação com o domínio CDN.

A configuração de servidor recomendada:

  • Serve apenas o diretório configurado por LOCALIZE_CDN_PATH; não disponibilize repositórios Weblate, cópias de segurança, média, configuração, ou o diretório de dados inteiro.

  • Desativar listagem de diretório.

  • Deny access to .kotlin-sdk-staging and all its contents. The Kotlin SDK add-on uses this directory for temporary preparation, not publication. Apply this restriction before enabling the add-on, including when a CDN copies files from the origin directory.

  • Utiliza HTTPS e torna o anfitrião CDN apenas para leitura a partir do servidor web.

  • Envia X-Content-Type-Options com nosniff.

  • Configura tipos MIME conservadores. Fornece formatos de tradução desconhecidos na forma de text/plain ou application/octet-stream; apenas disponibiliza weblate.js enquanto JavaScript.

  • Para formatos de tradução em bruto que não se destinam a ser renderizados em um navegador, considere adicionar Content-Disposition com attachment.

  • Configure Access-Control-Allow-Origin apenas para sites que precisam de acesso de navegador aos ficheiros.

  • Define tempo de vida da cache que corresponde às suas expectativas de atualização, e purga caches CDN quando traduções desatualizadas têm que desaparecer rapidamente.

Os seguintes excertos nginx servem apenas para o diretório CDN configurado e aplicam predefinições conservativas para ficheiros de tradução brutos:

weblate/examples/weblate.nginx.cdn.conf
#
# nginx configuration for the Weblate localization CDN
#
# You will want to change:
#
# - server_name to match the host configured in LOCALIZE_CDN_URL
# - root to match LOCALIZE_CDN_PATH
# - Access-Control-Allow-Origin to the sites that need browser access
# - TLS configuration if HTTPS is not terminated before nginx
#
server {
    listen 80;
    server_name cdn.example.com;

    # LOCALIZE_CDN_PATH
    root /home/weblate/data/l10n-cdn;

    autoindex off;
    disable_symlinks on;

    location = / {
        return 404;
    }

    # Kotlin SDK preparation files must never be served.
    location ^~ /.kotlin-sdk-staging {
        return 404;
    }

    # The JavaScript localization add-on publishes this loader.
    location ~ "^/[0-9a-f]{32}/weblate\.js$" {
        try_files $uri =404;

        types {
            application/javascript js;
        }
        default_type application/javascript;

        add_header X-Content-Type-Options nosniff always;
        # add_header Access-Control-Allow-Origin "https://www.example.com" always;

        expires 1h;
    }

    # Content-addressed Android artifacts never change at the same URL.
    location ~ "^/[0-9a-f]{32}/artifacts/[0-9a-f]{64}\\.arsc$" {
        try_files $uri =404;
        types { }
        default_type application/octet-stream;
        add_header X-Content-Type-Options nosniff always;
        add_header Content-Disposition "attachment" always;
        add_header Cache-Control "public, max-age=31536000, immutable";
        # add_header Access-Control-Allow-Origin "https://www.example.com" always;
    }

    # Other CDN files are translation files. Serve them conservatively so raw
    # formats are not interpreted as active browser content.
    # Manifest JSON files also use this one-hour cache policy.
    location / {
        try_files $uri =404;

        types {
        }
        default_type text/plain;

        add_header X-Content-Type-Options nosniff always;
        add_header Content-Disposition "attachment" always;
        # add_header Access-Control-Allow-Origin "https://www.example.com" always;

        expires 1h;
    }
}

Veja também

Assinando commits do Git com GnuPG

Todos os commits podem ser assinados pela chave GnuPG da instância Weblate.

  • Ative WEBLATE_GPG_IDENTITY. (Weblate irá gerar uma chave GnuPG quando necessário e irá usá-la para assinar todos os commits de tradução.)

    Esta funcionalidade precisa do GnuPG 2.1 ou mais recente instalado.

    Pode encontrar a chave em DATA_DIR e a chave pública é mostrada na página «Sobre»:

    ../_images/about-gpg.webp

  • Alternativamente, também pode importar as chaves existentes para o Weblate, apenas defina HOME=$DATA_DIR/home ao invocar gpg.

Dica

O material da chave é armazenado em cache pelo Weblate por um longo período. Caso permita que o Weblate gere uma chave com WEBLATE_GPG_IDENTITY e, em seguida, importe uma chave com a mesma identidade para usar uma chave existente, é recomendável limpar o cache do Redis para ver o efeito dessa alteração.

Nota

Ao partilhar DATA_DIR entre vários hosts, siga as instruções em https://wiki.gnupg.org/NFS para garantir que a assinatura do GnuPG funcione de forma confiável.

Veja também

WEBLATE_GPG_IDENTITY

Limitação de taxa

Alterado na versão 4.6: A limitação de taxa já não se aplica a superutilizadores logados.

Várias operações no Weblate são limitadas por cotas. Limites de cotas são avaliados independentemente para cada âmbito. No máximo RATELIMIT_ATTEMPTS tentativas são permitidas dentro de RATELIMIT_WINDOW segundos em um âmbito. Esse âmbito é então bloqueado durante RATELIMIT_LOCKOUT; o Weblate não torna isto em um ban temporário de IP no site completo. Exceder um âmbito, com o TRANSLATE ou SEARCH não bloqueia só por si mesmo âmbitos não relacionados como LOGIN or SECOND_FACTOR. Também há definições específicas a âmbitos, por exemplo RATELIMIT_CONTACT_ATTEMPTS ou RATELIMIT_TRANSLATE_ATTEMPTS. A tabela abaixo é uma lista completa dos âmbitos disponíveis.

As seguintes operações estão sujeitas a limitação de taxa:

Nome

Âmbito

Tentativas permitidas

Janela de limite de tempo

Período de bloqueio

Registo

REGISTRATION

5

300

600

Enviando mensagem para administradores

MESSAGE

2

300

600

Autenticação de palavra-passe ao entrar

LOGIN

5

300

600

Redefinição da palavra-passe

PASSWORD_RESET

5

300

600

Autenticação de segundo fator

SECOND_FACTOR

5

300

600

Pesquisa em todo o site

SEARCH

6

60

60

Traduzir

TRANSLATE

30

60

600

Adicionando ao glossário

GLOSSARY

30

60

600

A iniciar a tradução num novo idioma

LANGUAGE

2

300

600

Criando um novo projeto

PROJECT

5

600

600

Conectar uma conta GitHub

GITHUB_SETUP

100

3600

600

Loading component branches

COMPONENT_BRANCHES

30

60

60

Rendering a Markdown preview

MARKDOWN_PREVIEW

60

60

60

Dentro de cada âmbito, a limitação de taxa é baseada em sessões quando o utilizador tem a sessão iniciada ou no endereço IP, caso contrário.

Strict enforcement across concurrent workers requires a cache backend with atomic increment and decrement operations. The standard Configurar cache configuration using Valkey or Redis provides these operations.

Para utilizadores com sessão iniciada, o Weblate grava o primeiro pedido rejeitado durante cada bloqueio de âmbito ativo no Activity, incluindo o âmbito e caminho de pedido. Rejeições repetidas durante o mesmo bloqueio não criar entradas de registo de auditoria adicionais.

Se um utilizador falhar a autenticação AUTH_LOCK_ATTEMPTS vezes, a autenticação da palavra-passe será desativada na conta até ter passado pelo processo de redefinição da palavra-passe.

As configurações também podem ser aplicadas no contentor do Docker adicionando o prefixo WEBLATE_ ao nome da configuração, por exemplo RATELIMIT_ATTEMPTS torna-se WEBLATE_RATELIMIT_ATTEMPTS.

A API possui configurações separadas de limitação de taxa, consulte Limitação de taxa da API.

Veja também