Instalar en Debian y Ubuntu¶

Requisitos de hardware¶

Weblate debería funcionar en cualquier hardware contemporáneo sin problemas, la siguiente es la configuración mínima necesaria para ejecutar Weblate en un único host (Weblate, base de datos y servidor web):

3 GB de RAM
2 núcleos de CPU
1 GB de espacio de almacenamiento

Nota

Requisitos actuales para su instalación de Weblate varían pesadamente basado en el tamaño de las traducciones gestionadas dentro de esto.

Consumo de memoria¶

Cuanta más memoria tenga, mejor; ya que se utiliza para el pre-almacenaje en todos los niveles (sistema de archivos, base de datos y Weblate). Para cientos de componentes de traducción, al menos se recomiendan 4 GB de RAM.

Consejo

Para sistemas con menos memoria que la recomendada, Configuración de Celery de un solo proceso es recomendada.

Empleo de CPU¶

Muchos usuarios concurrentes incremente la cantidad de núcleos de CPU necesarios.

Uso de almacenaje¶

El almacenaje de base de datos típica es de alrededor de 300 MB por 1 millón de palabras hospedadas.

El espacio de almacén necesario para repositorios clonados varía, pero Weblate intenta mantener su tamaño mínimo haciendo clones llanos.

Nodos¶

Para sitios de tamaño medio y mínimo (millones de palabras almacenadas), todos los componentes Weblate (consulte Descripción general de la arquitectura) puede ser ejecutado en un único nodo.

Cuando crezca a cientos de millones de palabras hospedadas, es recomendado tener un nodo dedicado para base de datos (consulte Configuración de base de datos para Weblate).

Instalación¶

Requisitos del sistema¶

Instalar las dependencias necesarias para compilar los módulos de Python (ver 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

Consejo

Las distribuciones más antiguas no tienen libgirepository-2.0-dev, usar en su lugar libgirepository1.0-dev. Ver Solución de problemas al instalar pip.

Instalar las dependencias opcionales que se desee en función de las funcionalidades que se utilicen (ver Dependencias de Python):

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

Opcionalmente, instale software para ejecutar el servidor de producción, ver Ejecutar servidor, Configuración de base de datos para Weblate, Tareas en segundo plano con Celery. Dependiendo del tamaño de la instalación, es posible que desees ejecutar estos componentes en servidores dedicados.

Las instrucciones de instalación 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 paquetes uv¶

Consejo

Estamos usando el gestor de paquetes uv para instalar Weblate.

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

Ver también

Instalar uv

Módulos de Python¶

Consejo

Estamos instalando Weblate en un entorno de Python separado.

Cree el entorno de Python para Weblate:
```
uv venv ~/weblate-env
```
Active el entorno de Python para Weblate:
```
. ~/weblate-env/bin/activate
```
Instale Weblate incluyendo todas las dependencias opcionales:
```
# Install Weblate with all optional dependencies
uv pip install "weblate[all]"
```
Consultar Dependencias de Python para ajustar las dependencias opcionales.

Ver también

Configurar Weblate¶

Nota

Lo siguiente se asume que el entorno de Python utilizado por Weblate está activado (ejecutando . ~/weblate-env/bin/activate). De no ser así, especifique la ruta completa al comando weblate como ~/weblate-env/bin/weblate.

Copie el archivo ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py a ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.
Ajuste los valores en el nuevo archivo settings.py a su gusto. Deberá proporcionar al menos las credenciales de la base de datos y la clave secreta de Django, pero querrá más cambios para la configuración de producción, consulte Ajustar configuración.
Cree la base de datos y su estructura para Weblate (los ajustes del ejemplo utiliza PostgreSQL, compruebe Configuración de base de datos para Weblate para una configuración preparada para producción):
```
weblate migrate
```
Ver también

migrate
Cree una cuenta de usuario del administrador admin, genere su contraseña, y cópiela al portapapeles; recuerde guardarla para uso posterior:
```
weblate createadmin
```
Consejo

Si previamente olvida/pierde la contraseña de admin, puede generar uno nuevo con el comando siguiente:
```
weblate createadmin --update
```
Ver también

createadmin
Recopile los archivos estáticos para su servidor web (ver Ejecutar servidor y Sirviendo archivos estáticos):
```
weblate collectstatic
```
Comprime los archivos JavaScript y CSS (opcional, ver Comprimir bienes cliente):
```
weblate compress
```
Comience los trabajados de Celery. Esto no es necesario para fines de desarrollo, pero se recomienda encarecidamente en caso contrario. Más información Tareas en segundo plano con Celery:
```
celery --app=weblate.utils worker --beat --queues=celery,notify,memory,translate,backup
```
Inicie el servidor de desarrollo (Ejecutar servidor detalla una configuración de producción):
```
weblate runserver
```

Después de la instalación¶

Felicitaciones, su servidor Weblate ya está funcionando y puede comenzar a usarlo.

Ahora puedes acceder a Weblate en http://localhost:8000/.
Inicie sesión con las credenciales de administrador obtenidas durante la instalación o regístrese con nuevos usuarios.
Ahora puede ejecutar comandos de Weblate usando weblate cuando el entorno de Python en Weblate está activo, consulte Órdenes de gestión.
Puede detener el servidor de prueba con Ctrl+C.
Revisar los posibles incidencias con la instalación ya sea en la URL /manage/performance/ (ver Reporte de rendimiento) o usar weblate check --deploy, consulte Puesta en marcha de entorno de producción.

Añadir traducción¶

Abrir la interfaz administrativa (http://localhost:8000/create/project/) y crea el proyecto que deseas traducir. Consulte Configuración de proyecto para más detalles.

Todo lo que necesita para especificar aquí es el nombre del proyecto y su sitio web.
Crea un componente que es el objeto real para la traducción - apunta al repositorio VCS, y selecciona qué archivos traducir. Consulte Configuración de componentes para más detalles.

Los campos importantes aquí son: Nombre de componente, Repositorio de código fuente y Máscara de archivos para encontrar archivos traducibles. Weblate admite una amplia gama de formatos, incluidos GNU gettext PO (Portable Object), Recursos de cadenas Android, Cadenas de iOS de Apple, Propiedades de Java, Formato Stringsdict o Formato fluido. Consulte Formatos de archivos de localizaciónn para obtener más detalles.
Una vez completado lo anterior (puede ser un proceso largo dependiendo del tamaño de tu repositorio VCS, y del número de mensajes a traducir), puedes empezar a traducir.