Instalando no RedHat, Fedora e CentOS¶
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 of 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.
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):
dnf install \
libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel \
libyaml-devel libffi-devel cairo-devel cairo-gobject-devel pango-devel \
gobject-introspection-devel libacl-devel python3-pip python3-virtualenv \
libtool-ltdl-devel python3-devel git
Install wanted optional dependencies depending on features you intend to use (see Dependências Python):
dnf install openldap-devel libsasl2-devel
dnf install xmlsec1-devel
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
dnf install nginx uwsgi uwsgi-plugin-python3
# Web server option 2: Apache with ``mod_wsgi``
dnf install apache2 apache2-mod_wsgi
# Caching backend: Redis
dnf install redis
# Database server: PostgreSQL
dnf install postgresql postgresql-contrib
# SMTP server
dnf install postfix
# Gettext for the msgmerge add-on
dnf 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.
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, você precisa reconstruir o pacote em 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 arquivo
~/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 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.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
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
Ver também
Colete os arquivos estáticos para seu servidor web (veja Executando servidor e Servindo arquivos estáticos):
weblate collectstatic
Compacte os arquivos JavaScript e CSS (opcional, veja Comprimindo 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 usando Celery tem mais informações:
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
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, veja Comandos de gerência.
Você 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 você precisa especificar aqui é o nome do projeto e seu site.
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 PO (Portable Object), Recurso de textos de Android, Textos de Apple iOS, Propriedades Java, Formato stringsdict ou Formato Fluent, consulte Formatos de arquivos suportados para mais detalhes.
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.