Instalar no Debian e Ubuntu¶

Requisitos de hardware¶

O Weblate deveria funcionar em qualquer “”hardware”” contemporâneo sem problemas. O seguinte é a configuração mínima necessária para executar o Weblate num único hospedeiro (Weblate, base de dados e servidor da 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 geridas nele.

Memória utilizada¶

Quanto mais memória, melhor - é usada para armazenamento em cache em todos os níveis (sistema de ficheiros, base 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 utilizadores simultâneos aumentam a quantidade de núcleos de CPU necessários.

Uso de armazenamento¶

O uso típico de armazenamento da base de dados é de cerca de 300 MB por 1 milhão de palavras alojadas.

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

Nós¶

Para sítios de pequeno e médio porte (milhões de palavras alojadas), todos os componentes do Weblate (consulte Visão geral da arquitetura) podem ser executados num único nó.

Quando atingir centenas de milhões de palavras alojadas, é recomendável ter um nó dedicado para a base de dados (consulte Configuração da base de dados para o Weblate).

Instalação¶

Requisitos do sistema¶

Instale as dependências necessárias para criar módulos Python (consulte 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 libgirepository-2.0-dev \
   libacl1-dev liblz4-dev libzstd-dev libxxhash-dev libssl-dev libpq-dev libjpeg-dev build-essential \
   python3-gdbm python3-dev git

Dica

As distribuições mais antigas não têm libgirepository-2.0-dev; em vez disso, use libgirepository1.0-dev. Consulte também Solução de problemas via instalação pip.

Instale as dependências opcionais desejadas, dependendo dos recursos que pretende usar (veja 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 da base 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: Valkey
apt install -y valkey-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

Gestor de pacotes uv¶

Dica

Estamos usando o gestor de pacotes uv para instalar o Weblate.

curl -LsSf https://astral.sh/uv/install.sh | sh

Veja também

Instalar uv

Módulos do Python¶

Dica

We’re installing Weblate in a separate Python environment.

Create the Python environment for Weblate:
```
uv venv ~/weblate-env
```
Activate the Python environment for Weblate:
```
. ~/weblate-env/bin/activate
```
Instale o Weblate incluindo todas as dependências opcionais:
```
# Install Weblate with all optional dependencies
uv pip install "weblate[all]"
```
Por favor, consulte Dependências Python para a otimização simples das dependências opcionais.

Veja também

Configurando o Weblate¶

Nota

The following assumes the Python environment used by Weblate is activated (by executing . ~/weblate-env/bin/activate). If not, specify the full path to the weblate command as ~/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. Terá de fornecer pelo menos as credenciais da base de dados e o código secreto do Django, mas irá querer efetuar mais alterações para a configuração de produção, consulte Ajustar a configuração.
Crie a base de dados e a sua estrutura para o Weblate (as definições de exemplo utilizam PostgreSQL, consulte Configuração da base de dados para o Weblate para uma configuração pronta para produção):
```
weblate migrate
```
Veja também

migrate
Crie uma conta de utilizador administrador admin, gere a sua palavra-passe e copie-a para a área de transferência; lembre-se de gravá-la para uso posterior:
```
weblate createadmin
```
Dica

Se perdeu ou se esqueceu da sua palavra-passe de administrador anteriormente, pode gerar uma nova com o seguinte comando:
```
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:
```
celery --app=weblate.utils worker --beat --queues=celery,notify,memory,translate,backup
```
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 utilizá-lo.

Agora pode aceder ao 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.
You can now run Weblate commands using weblate command when Weblate Python environment is active, see Comandos de gestão.
Pode parar o servidor de testes com Ctrl+C.
Reveja os possíveis problemas com a sua instalação na URL /manage/performance/ (ver Relatório de desempenho) ou usando weblate check --deploy, ver 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 (Objeto Portátil), Recursos de cadeias de carateres para Android, Cadeias de carateres para Apple iOS, Propriedades Java, Formato stringsdict ou Formato Fluent, consulte Formatos de ficheiro de localização 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.