Instalar en SUSE y openSUSE¶

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, Single-process Celery setup 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¶

Install the dependencies needed to build the Python modules (see Requisitos de software):

zypper install \
   libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel \
   libyaml-devel libffi-devel cairo-devel pango-devel \
   gobject-introspection-devel libacl-devel liblz4-devel libzstd-devel libxxhash-devel \
   python3-devel git

Install wanted optional dependencies depending on features you intend to use (see Dependencias de Python):

zypper install libldap2-devel libsasl2-devel
zypper install libxmlsec1-devel

Optionally install software for running production server, see Ejecutar servidor, Configuración de base de datos para Weblate, Tareas en segundo plano con Celery. Depending on size of your installation you might want to run these components on dedicated servers.

Las instrucciones de instalación local:

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

# Web server option 2: Apache with ``mod_wsgi``
zypper install apache2 apache2-mod_wsgi

# Caching backend: Redis
zypper install redis-server

# Database server: PostgreSQL
zypper install postgresql postgresql-contrib

# SMTP server
zypper install postfix

# Gettext for the msgmerge add-on
zypper install gettext

uv package manager¶

Consejo

We’re using uv package manager to install Weblate.

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

Ver también

Installing uv

Módulos de Python¶

Consejo

We’re using virtualenv to install Weblate in a separate environment from your system. If you are not familiar with it, check virtualenv User Guide.

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

Ver también

Solución de problemas al instalar pip describes frequent issues while installing Python dependencies.

Configurar Weblate¶

Nota

The following assumes the virtualenv 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.

Copy the file ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py to ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.
Adjust the values in the new settings.py file to your liking. You will need to provide at least the database credentials and Django secret key, but you will want more changes for production setup, see Ajustar configuración.
Create the database and its structure for Weblate (the example settings use PostgreSQL, check Configuración de base de datos para Weblate for a production-ready setup):
```
weblate migrate
```
Ver también

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
```
Consejo

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

createadmin
Collect the static files for your web server (see Ejecutar servidor and Sirviendo archivos estáticos):
```
weblate collectstatic
```
Compress the JavaScript and CSS files (optional, see Comprimir bienes cliente):
```
weblate compress
```
Start the Celery workers. This is not necessary for development purposes, but strongly recommended otherwise. Tareas en segundo plano con Celery has more info:
```
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
```
Start the development server (Ejecutar servidor details a production setup):
```
weblate runserver
```

After installation¶

Congratulations, your Weblate server is now running and you can start using it.

You can now access Weblate on http://localhost:8000/.
Sign in with admin credentials obtained during installation or register with new users.
You can now run Weblate commands using weblate command when Weblate virtualenv is active, see Órdenes de gestión.
You can stop the test server with Ctrl+C.
Review potential issues with your installation either on /manage/performance/ URL (see Reporte de rendimiento) or using weblate check --deploy, see Puesta en marcha de entorno de producción.

Adding translation¶

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

All you need to specify here is the project name and its website.
Crea un componente que es el objeto real para la traducción - apunta al repositorio VCS, y selecciona qué ficheros traducir. Véase 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 de Android, Cadenas de iOS de Apple, Propiedades de Java, Formato Stringsdict o Formato fluido. Consulte Localization file formats 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.