Instalando no macOS

Requisitos de hardware

O Weblate deve funcionar em qualquer hardware contemporâneo sem problemas. A seguir está a configuração mínima necessária para executar o Weblate em um único host (Weblate, banco de dados e servidor web):

  • 3 GB de RAM

  • 2 núcleos de CPU

  • 1 GB de espaço de armazenamento

Nota

Os requisitos reais para a sua instalação do Weblate variam fortemente com base no tamanho das traduções gerenciadas nele.

Memória utilizada

Quanto mais memória, melhor - ela é usada para armazenamento em cache em todos os níveis (sistema de arquivos, banco de dados e Weblate). Para centenas de componentes de tradução, recomenda-se pelo menos 4 GB de RAM.

Dica

Para sistemas com menos memória do que o recomendado, Configuração do Celery de processo único é recomendado.

Uso da CPU

Muitos usuários simultâneos aumentam a quantidade de núcleos de CPU necessários.

Uso de armazenamento

O uso típico de armazenamento de banco de dados é de cerca de 300 MB por 1 milhão de palavras hospedadas.

O espaço de armazenamento necessário para repositórios clonados varia, mas o Weblate tenta manter seu tamanho mínimo fazendo clones rasos.

Nodes

Para sites de pequeno e médio porte (milhões de palavras hospedadas), todos os componentes do Weblate (consulte Visão geral da arquitetura) podem ser executados em um único nó.

Quando você atingir centenas de milhões de palavras hospedadas, é recomendável ter um nó dedicado para o banco de dados (consulte Configuração de banco de dados para o Weblate).

Instalação

Requisitos do sistema

Instale as dependências necessárias para construir os módulos Python (consulte Requisitos de software):

brew install python pango cairo gobject-introspection glib libyaml pkgconf zstd lz4 xxhash libxmlsec1 librsvg uv

Opcionalmente, instale o software para executar o servidor de produção, consulte Executando servidor, Configuração de banco de dados para o Weblate, Tarefas de fundo usando Celery. Dependendo do tamanho da sua instalação, você pode querer executar esses componentes em servidores dedicados.

As instruções de instalação local:

# Web server option 1: NGINX and uWSGI
brew install nginx uwsgi

# Web server option 2: Apache with ``mod_wsgi``
brew install httpd

# Caching backend: Redis
brew install redis

# Database server: PostgreSQL
brew install postgresql

# Gettext for the msgmerge add-on
brew install gettext

Módulos do Python

Dica

Estamos usando o virtualenv para instalar o Weblate em um ambiente separado do seu sistema. Se você não estiver familiarizado com ele, consulte User Guide do virtualvenv.

  1. Crie o virtualenv para Weblate:

    uv venv ~/weblate-env

  2. Ative o virtualenv para Weblate:

    . ~/weblate-env/bin/activate

  3. Instale o Weblate incluindo todas as dependências opcionais:

    # Install Weblate with all optional dependencies
uv pip install "weblate[all]"

    Confira Dependências Python para o ajuste fino das dependências opcionais.

    Ver também

    Solução de problemas via instalação pip descreve os problemas frequentes durante a instalação das dependências do Python.

Configurando o Weblate

Nota

O seguinte assume que o virtualenv utilizado pela Weblate é ativado (executando . ~/weblate-env/bin/bin/activate). Caso contrário, especificar o caminho completo para o comando weblate como ~/weblate-env/bin/weblate.

  1. Copie o arquivo ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py para ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.

  2. Ajuste os valores no novo arquivo settings.py de acordo com sua preferência. Você vai precisar fornecer pelo menos as credenciais de banco de dados e a chave secreta Django, mas você vai querer mais mudanças para configuração de produção, consulte Ajustando a configuração.

  3. Crie o banco de dados e sua estrutura para Weblate (as configurações de exemplo usam PostgreSQL, confira Configuração de banco de dados para o Weblate para uma configuração pronta para produção):

    weblate migrate

    Ver também

    migrate

  4. Crie uma conta de usuário administrador admin, gere sua senha e copie-a para a área de transferência; lembre-se de salvá-la para uso posterior:

    weblate createadmin

    Dica

    Se você perdeu ou esqueceu a senha de administrador anteriormente, você pode gerar uma nova com o seguinte comando:

    weblate createadmin --update

    Ver também

    createadmin

  5. Colete os arquivos estáticos para seu servidor web (consulte Executando servidor e Servindo arquivos estáticos):

    weblate collectstatic

  6. Compacte os arquivos JavaScript e CSS (opcional, consulte Comprimindo os ativos do cliente):

    weblate compress

  7. Inicie os workers do Celery. Isso não é necessário para fins de desenvolvimento, mas é altamente recomendado caso contrário. Tarefas de fundo usando Celery tem mais informações:

    ~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start

  8. Inicie o servidor de desenvolvimento (Executando servidor detalha uma configuração de produção):

    weblate runserver

Após a instalação

Parabéns, seu servidor Weblate agora está funcionando e você pode começar a usá-lo.

  • Agora você pode acessar o Weblate em http://localhost:8000/.

  • Faça o login com as credenciais de administrador obtidas durante a instalação ou registre-se com novos usuários.

  • Agora você pode executar comandos Weblate usando o comando weblate quando virtualenv do Weblate está ativo, consulte Comandos de gerência.

  • Você pode parar o servidor de teste com Ctrl+C.

  • Revise os possíveis problemas com sua instalação na URL /manage/performance/ (consulte Relatório de desempenho) ou usando weblate check --deploy, consulte Configuração de produção.

Adicionando tradução

  1. Abra a interface de administração (http://localhost:8000/create/project/) e crie o projeto que deseja traduzir. Consulte Configuração de projeto para mais detalhes.

    Tudo que você precisa especificar aqui é o nome do projeto e seu site.

  2. Crie um componente que é o objeto real para tradução – ele aponta para o repositório VCS e seleciona quais arquivos traduzir. Consulte Configuração de componente para mais detalhes.

    Os campos importantes aqui são: Nome do componente, Repositório do código-fonte e Máscara do arquivo para localizar arquivos traduzíveis. Weblate tem suporte a uma ampla gama de formatos, incluindo GNU gettext PO (Objeto Portátil), Recurso de textos do Android, Textos de Apple iOS, Propriedades Java, Formato stringsdict ou Formato Fluent, consulte Formatos de arquivo de localização para mais detalhes.

  3. Depois que o acima for concluído (pode ser um processo demorado dependendo do tamanho do seu repositório VCS e do número de mensagens a serem traduzidas), você pode começar a traduzir.