Instalando no Debian e Ubuntu¶

Requisitos de hardware¶

Weblate should run on any contemporary hardware without problems, the following is the minimal configuration required to run Weblate on a single host (Weblate, database and web server):

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 geridas nele.

Memory usage¶

The more memory the better - it is used for caching on all levels (file system, database and Weblate). For hundreds of translation components, at least 4 GB of RAM is recommended.

Dica

For systems with less memory than recommended, Single-process Celery setup is recommended.

CPU usage¶

Many concurrent users increase the amount of needed CPU cores.

Storage usage¶

The typical database storage usage is around 300 MB per 1 million hosted words.

Storage space needed for cloned repositories varies, but Weblate tries to keep their size minimal by doing shallow clones.

Nodes¶

For small and medium-sized sites (millions of hosted words), all Weblate components (see Architecture overview) can be run on a single node.

When you grow to hundreds of millions of hosted words, it is recommended to have a dedicated node for database (see 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 (veja Requisitos de software):

apt install -y \
   libxml2-dev libxslt-dev libfreetype6-dev libjpeg-dev libz-dev libyaml-dev \
   libffi-dev libcairo-dev gir1.2-pango-1.0 gir1.2-rsvg-2.0 libgirepository1.0-dev \
   libacl1-dev libssl-dev libpq-dev libjpeg-dev build-essential \
   python3-gdbm python3-dev python3-pip python3-virtualenv virtualenv git

Install wanted optional dependencies depending on features you intend to use (see Dependências Python):

apt install -y \
   libldap2-dev libldap-common libsasl2-dev \
   libxmlsec1-dev

Opcionalmente, instale o software para executar o servidor de produção, veja Executar o servidor, Configuração de banco de dados para o Weblate, Tarefas de fundo a usar o Celery. Dependendo do tamanho da sua instalação, poderá executar esses componentes em servidores dedicados.

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

# Web server option 1: NGINX and uWSGI
apt install -y nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
apt install -y apache2 libapache2-mod-wsgi-py3

# Caching backend: Redis
apt install -y redis-server

# Database server: PostgreSQL
apt install -y postgresql postgresql-contrib

# SMTP server
apt install -y exim4

# Gettext for the msgmerge add-on
apt install -y gettext

Módulos do Python¶

Dica

Estamos a usar o virtualenv para instalar o Weblate num ambiente separado do seu sistema. Se não estiver familiarizado com ele, verifique virtualenv venv: user_guide.

Crie o virtualenv para Weblate:
```
virtualenv ~/weblate-env
```
Ative o virtualenv para Weblate:
```
. ~/weblate-env/bin/activate
```
Instale o Weblate incluindo todas as dependências opcionais:
```
# Install Weblate with all optional dependencies
pip install "Weblate[all]"
```
Please check Dependências Python for fine-tuning of optional dependencies.
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, precisa reconstruir o pacote no seu sistema:
```
pip install --force-reinstall --no-binary :all: cffi
```

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.

Copie o ficheiro ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py para ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.
Ajuste os valores no novo ficheiro settings.py de acordo com a sua preferência. Vai precisar fornecer pelo menos as credenciais de banco de dados e a chave secreta Django, mas vai querer fazer mais mudanças para configuração de produção, veja Ajustar a configuração.
Crie o banco de dados e a estrutura dele 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
```
Veja também

migrate
Create an administrator user account admin, generate its password, and copy it to the clipboard; remember to save it for later use:
```
weblate createadmin
```
Dica

If you previously missed/lost the admin password, you can generate a new one with the following command:
```
weblate createadmin --update
```
Veja também

createadmin
Colete os ficheiros estáticos para o seu servidor web (veja Executar o servidor e Servir ficheiros estáticos):
```
weblate collectstatic
```
Compacte os ficheiros JavaScript e CSS (opcional, veja Comprimir os ativos do cliente):
```
weblate compress
```
Inicie os workers do Celery. Isso não é necessário para fins de desenvolvimento, mas é altamente recomendado caso contrário. Tarefas de fundo a usar o Celery tem mais informações:
```
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
```
Inicie o servidor de desenvolvimento (Executar o servidor detalha uma configuração de produção):
```
weblate runserver
```

Após a instalação¶

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

Agora pode acessar o Weblate em http://localhost:8000/.
Faça o login com as credenciais de administrador obtidas durante a instalação ou registe-se com novos utilizadores.
Agora pode executar comandos Weblate a usar o comando weblate quando virtualenv do Weblate está ativo, veja Comandos de gerência.
Pode parar o servidor de teste com Ctrl+C.
Review potential issues with your installation either on /manage/performance/ URL (see Relatório de desempenho) or using weblate check --deploy, see Configuração de produção.

Adicionando tradução¶

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 precisa especificar aqui é o nome do projeto e seu site.
Crie um componente que é o objeto real para tradução – ele aponta ao repositório VCS e seleciona quais ficheiros 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 ficheiros para localizar ficheiros traduzíveis. Weblate tem suporte a uma ampla gama de formatos, incluindo GNU gettext PO (Portable Object), Recurso de cadeias de Android, Cadeias de Apple iOS, Propriedades Java, Formato stringsdict ou Formato Fluent, consulte Formatos de ficheiros suportados para mais detalhes.
Depois que o acima for concluído (pode ser um processo demorado a depender do tamanho do seu repositório VCS e da quantidade de mensagens a serem traduzidas), pode começar a traduzir.