Módulos opcionales de Weblate¶

Hay varios módulos opcionales disponibles para que los configure.

Exportador de Git¶

Le proporciona acceso de solo lectura al repositorio Git subyacente mediante HTTP(S).

Instalación¶

Añade weblate.gitexport para instalar aplicaciones en settings.py:
```
INSTALLED_APPS += ("weblate.gitexport",)
```
Exporte los repositorios existentes migrando su base de datos después de la instalación:
```
weblate migrate
```

Consejo

El exportador de Git está activado en nuestra imagen oficial de Docker. Para apagarlo, use:

WEBLATE_REMOVE_APPS=weblate.gitexport

Uso¶

The module automatically hooks into Weblate and sets the exported repository URL in the Configuración de componentes. The repositories are accessible under the /git/ part of the Weblate URL, for example https://example.org/git/weblate/main/.

Repositories for publicly available projects can be cloned without authentication:

git clone 'https://example.org/git/weblate/main/'

Access to browse the repositories with restricted access (with Private access control or when REQUIRE_LOGIN is enabled) requires an API token which can be obtained in your user profile:

git clone 'https://user:KEY@example.org/git/weblate/main/'

Consejo

De forma predeterminada, los miembros o el grupo Usuarios y los usuarios anónimos tienen acceso a los repositorios de proyectos públicos a través de los roles Acceso al repositorio y Usuario avanzado.

Facturación¶

Se utiliza en Hosted Weblate para definir planes de facturación, seguimiento de facturas y límites de uso.

Instalación¶

1. Add weblate.billing to installed apps in settings.py:

INSTALLED_APPS += ("weblate.billing",)

Ejecute la migración de base de datos para instalar opcionalmente estructuras de base de datos adicionales para el módulo:

weblate migrate

Billing plan creation and assignment¶

You first need to create a billing plan to activate billing. Navigate to the Administration section (represented by the wrench icon) and open the Tools screen. From there, proceed to the Django admin interface.

In the Django admin interface, locate the BILLING section and add a billing plan. For instance, you can add a Free plan with no cost.

If you wish to assign a billing plan to an existing project, this can also be done within the Django admin interface using the Customer billings option.

Lastly, the Django admin interface provides an Invoice option for logging your customer payments.

Uso¶

Tras la instalación, puede controlar la facturación en la interfaz de administración. Los usuarios con facturación activada tendrán una nueva pestaña Facturación en su Perfil de usuario.

El módulo de facturación permite además a los administradores de proyectos crear nuevos proyectos y componentes sin ser superusuarios (véase Añadir proyectos y componentes de traducción). Esto es posible cuando se cumplen las siguientes condiciones:

La facturación se encuentra dentro de los límites configurados (cualquier uso excesivo provoca el bloqueo de la creación del proyecto/componente) y pagada (si su precio es distinto de cero)
The user is admin of existing project with billing or user is owner of billing (the latter is necessary when creating new billing for users to be able to import new projects).

Al crear el proyecto, el usuario puede elegir qué facturación se debe cobrar por el proyecto en caso de que tenga acceso a más de ellos.

Módulo legal¶

Esto se usa en Hosted Weblate para proporcionar los documentos legales requeridos. Viene provisto de documentos en blanco, y se espera que complete las siguientes plantillas en los documentos:

legal/documents/tos.html: Documento de términos de servicio
legal/documents/privacy.html: Documento de política de privacidad
legal/documents/summary.html: Breve descripción de los términos de servicio y la política de privacidad

Al cambiar los documentos de los términos de servicio, ajustar LEGAL_TOS_DATE para que los usuarios se vean obligados a aceptar los documentos actualizados.

Nota

Los documentos legales para el servicio alojado de Weblate están disponibles en este repositorio Git <https://github.com/WeblateOrg/wllegal/tree/main/wllegal/templates/legal/documents>.

Lo más probable es que estos no sean utilizables de forma directa, pero podrían ser útiles como punto de partida si se ajustan para satisfacer sus necesidades.

Instalación¶

1. Add weblate.legal to installed apps in settings.py:

INSTALLED_APPS += ("weblate.legal",)

# Optional:

# Social auth pipeline to confirm TOS upon registration/subsequent sign in
SOCIAL_AUTH_PIPELINE += ("weblate.legal.pipeline.tos_confirm",)

# Middleware to enforce TOS confirmation of signed in users
MIDDLEWARE += [
    "weblate.legal.middleware.RequireTOSMiddleware",
]

Ejecute la migración de base de datos para instalar opcionalmente estructuras de base de datos adicionales para el módulo:

weblate migrate

Editar los documentos legales en la carpeta weblate/legal/templates/legal/ para que coincidan con su servicio.

Uso¶

After installation and editing, the legal documents are shown in the Weblate UI.

Avatars¶

Avatars are downloaded and cached server-side to reduce information leaks to the sites serving them by default. The built-in support for fetching avatars from e-mails addresses configured for it can be turned off using ENABLE_AVATARS.

Weblate currently supports:

Ver también

Firmando confirmaciones de Git con GnuPG¶

Todas las confirmaciones pueden firmarse con la clave GnuPG de la instancia de Weblate.

Activar WEBLATE_GPG_IDENTITY. (Weblate generará una clave GnuPG cuando sea necesario y la usará para firmar todas las confirmaciones de traducción.)

Esta característica necesita instalado GnuPG 2.1 o posterior.

Puede encontrar la clave en DATA_DIR y la clave pública se muestra en la página» Acerca de»:
Alternativamente, también puede importar claves existentes en Weblate, simplemente configure HOME=$DATA_DIR/home al invocar gpg.

Consejo

Weblate almacena en caché el material de la clave durante un largo período. En caso de que permita que Weblate genere una clave con WEBLATE_GPG_IDENTITY y luego importe una clave con la misma identidad para usar una clave existente, se recomienda purgar la caché de Redis para ver el efecto de dicho cambio.

Nota

Al compartir DATA_DIR entre varios hosts, siga las instrucciones en https://wiki.gnupg.org/NFS para que la firma de GnuPG funcione de manera confiable.

Ver también

WEBLATE_GPG_IDENTITY

Rate limiting¶

Distinto en la versión 4.6: The rate limiting no longer applies to signed in superusers.

Several operations in Weblate are rate limited. At most RATELIMIT_ATTEMPTS attempts are allowed within RATELIMIT_WINDOW seconds. The user is then blocked for RATELIMIT_LOCKOUT. There are also settings specific to scopes, for example RATELIMIT_CONTACT_ATTEMPTS or RATELIMIT_TRANSLATE_ATTEMPTS. The table below is a full list of available scopes.

The following operations are subject to rate limiting:

Nombre	Alcance	Intentos permitidos	Oportunidad del límite de velocidad	Período de bloqueo
Registro	`REGISTRATION`	5	300	600
Enviar un mensaje a los administradores	`MESSAGE`	2	300	600
Password authentication on sign-in	`LOGIN`	5	300	600
Second-factor authentication	`SECOND_FACTOR`	5	300	600
Búsqueda en todo el sitio	`SEARCH`	6	60	60
Traducción	`TRANSLATE`	30	60	600
Adición al glosario	`GLOSSARY`	30	60	600
Comenzar una traducción en un idioma nuevo	`LANGUAGE`	2	300	600
Crear un nuevo proyecto	`PROJECT`	5	600	600

The rate limiting is based on sessions when user is signed in and on IP address if not.

Si un usuario no consigue iniciar sesión AUTH_LOCK_ATTEMPTS veces, la autenticación de contraseña se desactivará en la cuenta hasta que haya pasado por el proceso de restablecimiento de su contraseña.

La configuración también se puede aplicar en el contenedor Docker agregando el prefijo WEBLATE_ al nombre de la configuración, por ejemplo RATELIMIT_ATTEMPTS se convierte en WEBLATE_RATELIMIT_ATTEMPTS.

La API tiene configuraciones de limitación de velocidad separadas, ver Limitación de la tasa de API.

Ver también

Integración con Fedora Messaging¶

Fedora Messaging es un publicador basado en AMQP para todos los cambios que ocurren en Weblate. Puede integrar servicios adicionales para actuar ante cambios que ocurran en Weblate mediante esta herramienta.

La integración con Fedora Messaging está disponible como un módulo Python separado, weblate-fedora-messaging. Consulte <https://github.com/WeblateOrg/fedora_messaging/> para obtener instrucciones de instalación.

Ver también

Weblate Messaging