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

  • 2 GB de RAM

  • 2 núcleos de CPU

  • 1 GB de espaço de armazenamento

Quanto mais memória melhor – ele é usada para cache em todos os níveis (sistema de arquivos, banco de dados e Weblate).

Muitos usuários simultâneos aumentam a quantidade de núcleos de CPU necessários. Para centenas de componentes de tradução é recomendado pelo menos 4 GB de RAM.

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.

Nota

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

Instalação

Requisitos do sistema

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

brew install python pango cairo gobject-introspection libffi glib libyaml
pip3 install virtualenv

Certifique-se de que o pip será capaz de encontrar a versão do libffi fornecida pelo homebrew – isso será necessário durante a etapa de compilação da instalação.

export PKG_CONFIG_PATH="/usr/local/opt/libffi/lib/pkgconfig"

Instale as dependências opcionais desejadas, dependendo dos recursos que você pretende usar (veja Dependências opcionais):

brew install tesseract

Opcionalmente, instale o software para executar o servidor de produção, veja 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

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, verifique virtualenv venv: user_guide.

  1. Crie o virtualenv para Weblate:

    virtualenv --python=python3 ~/weblate-env
    
  2. Ative o virtualenv para Weblate:

    . ~/weblate-env/bin/activate
    
  3. Instale o Weblate incluindo todas as dependências opcionais:

    # pkgconfig is needed to install borgbackup 1.2
    pip install pkgconfig
    # Install Weblate with all optional dependencies
    pip install "Weblate[all]"
    

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

    Nota

    Em algumas distribuições Linux, a execução do Weblate falha com erro de libffi:

    ffi_prep_closure(): bad user_data (it seems that the version of the libffi library seen at runtime is different from the 'ffi.h' file seen at compile-time)
    

    Isso é causado pela incompatibilidade de pacotes binários distribuídos via PyPI com a distribuição. Para resolver isso, você precisa reconstruir o pacote em seu sistema:

    pip install --force-reinstall --no-binary :all: cffi
    

Configurando o Weblate

Nota

Os passos seguintes assumem que o virtualenv usado pelo Weblate está ativo (o que pode ser feito por . ~/weblate-env/bin/activate). Caso isso não seja verdade, você terá que especificar o caminho completo para o comando weblate como ~/weblate-env/bin/weblate.

  1. Copie o arquivo ~/weblate-env/lib/python3.7/site-packages/weblate/settings_example.py para ~/weblate-env/lib/python3.7/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, veja 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 configuração pronta para produção):

    weblate migrate
    
  4. Crie a conta de usuário do administrador e copie a senha de saída para a área de transferência e salve-a para uso posterior:

    weblate createadmin
    
  5. Colete arquivos estáticos para o servidor web (veja Executando servidor e Servindo arquivos estáticos):

    weblate collectstatic
    
  6. Compactar arquivos JavaScript e CSS (opcional, veja Comprimindo os ativos do cliente):

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

    ~/weblate-env/lib/python3.7/site-packages/weblate/examples/celery start
    
  8. Inicie o servidor de desenvolvimento (veja Executando servidor para 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, veja 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/ (veja Interface de gerenciamento) ou usando weblate check --deploy, veja 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. Veja 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. Veja 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 de arquivo para localizar arquivos traduzíveis. Weblate tem suporte a uma ampla gama de formatos, incluindo GNU gettext, Recurso de textos de Android, Textos de Apple iOS, Propriedades Java, Formato stringsdict ou Formato Fluent, consulte Formatos de arquivos suportados 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.