# General Translation Platform: Configurar las automatizaciones de Locadex
URL: https://generaltranslation.com/es/docs/platform/locadex/guides/configuring-automations.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Cómo configurar las plantillas de automatización de Locadex, los activadores, las ramas, el comportamiento de pull requests y los comandos.

Usa la configuración de las automatizaciones para controlar qué cambia Locadex, cuándo se ejecuta y cómo crea o actualiza pull requests.

Locadex tiene tres plantillas. Cada automatización puede ejecutarse cuando cambia una pull request, cuando se hace push de un commit o manualmente.

## Elige una plantilla [#choose-template]

Abre **Project &gt; Automations**. En **Empieza con una plantilla**, elige:

* **Generar código** para la internacionalización del código.
  * Define cuándo Locadex debe envolver tu código fuente con llamadas a la biblioteca de internacionalización, como `t()` o el componente `T`.
* **Generar traducciones y hacer push** para actualizaciones de contenido.
  * Define cuándo Locadex debe traducir contenido fuente nuevo o actualizado a los idiomas de destino.
* **Mantener los locales sincronizados** para actualizaciones de locales.
  * Define cuándo Locadex debe actualizar archivos en tu proyecto si se agregan o eliminan idiomas. Una ejecución manual te permite elegir los locales de origen y de destino.

Elige una automatización configurada en esta página para editarla. También puedes usar **Organization &gt; Locadex &gt; Automations** para buscar y administrar automatizaciones en todos los proyectos.

### Comprobaciones estáticas durante la generación de código

Una automatización de **Generar código** ejecuta reglas de lint en los archivos que modifica y devuelve los resultados al agente. En los archivos que ya importan General Translation, la regla `user-facing-object` advierte cuando texto escrito directamente en el código llega a la interfaz a través de un objeto o una constante; por ejemplo, `{labels.save}` o un valor desestructurado de un objeto de configuración.

Locadex resuelve la advertencia traduciendo la cadena en el origen: [`<T>`](/docs/react/reference/components/t) para contenido JSX o una API de traducción de cadenas como [`useGT`](/docs/react/reference/hooks/use-gt) o [`msg`](/docs/react/reference/functions/msg) para cadenas almacenadas en props y objetos.

## Configurar una automatización [#configure-automation]

### Editar el activador

Configura **Ejecutar cuando** con uno de estos tres activadores:

* **Cambios en un pull request** se ejecuta cuando se abre, se vuelve a abrir o se marca como listo para revisión un pull request relevante. Los commits nuevos cancelan cualquier ejecución en curso, pero no inician otra; comenta `/locadex` cuando el pull request vuelva a estar listo para procesarse.
* **Se hace push de commits** se ejecuta cuando se hace push de commits a la rama de destino.
* **Iniciado manualmente** se ejecuta solo cuando haces clic en **Ejecutar ahora**.

Las nuevas automatizaciones de **Generar código** y **Generar traducciones y hacer push** usan **Cambios en un pull request** de forma predeterminada. **Mantener los locales sincronizados** usa **Iniciado manualmente** de forma predeterminada.

### Editar la rama de destino y el prefijo

Configura **Rama de destino** con la rama desde la que parte Locadex y sobre la que abre pull requests. Los activadores automáticos supervisan esta rama para detectar cambios. En las ejecuciones manuales, es la rama que Locadex extrae al hacer clic en **Ejecutar ahora**. La mayoría de los proyectos usan `main`.

Configura **Prefijo de las ramas creadas** para las ramas que crea Locadex. El valor predeterminado es:

```txt
locadex/
```

Usa un prefijo estable para que sea fácil encontrar las ramas de Locadex en GitHub.

### Editar la configuración de los PR

Usa los interruptores para controlar cómo Locadex crea y gestiona los pull requests:

* **Auto-merge** fusiona automáticamente los pull requests de Locadex cuando las comprobaciones se completan correctamente. (Consulta [Auto-merging Locadex PRs](/docs/platform/locadex/guides/auto-merging-prs)).
* **Solo archivos modificados** limita la comprobación de relevancia de **Generar código** a las líneas modificadas, en lugar de al contenido completo de los archivos modificados. Las automatizaciones de traducción y sincronización de locales no usan este filtro, y los frameworks de documentación omiten la comprobación de relevancia.
* **Preservar ediciones locales** conserva las ediciones manuales en archivos que Locadex generó anteriormente.

Para los activadores automáticos, Locadex reutiliza el pull request abierto de la misma rama de origen y automatización. Antes de una actualización incremental, marca el PR reutilizable como borrador y publica un comentario de estado por ejecución. Solo devuelve el PR al estado de listo para revisión si ya lo estaba antes de la ejecución; si un usuario lo mantiene como borrador, seguirá siendo borrador. Las ejecuciones manuales desde el panel de control usan pull requests puntuales.

En el caso de una automatización activada por un pull request, cuando Locadex crea un PR independiente, añade un comentario en el PR activador con un enlace a ese PR de Locadex.

Los cuadros de texto al final de la página ofrecen opciones de personalización adicionales:

* **Título del pull request** establece el título que se usa para los pull requests de Locadex.
* **Descripción del pull request** establece el cuerpo del pull request.
* **Mensaje de commit** establece el mensaje que se usa para los commits de Locadex.

### Agregar comandos

Usa comandos para ejecutar pasos como la configuración inicial o la validación en tu proyecto. Usa comandos para instalar dependencias, compilar tu proyecto, ejecutar lint sobre los cambios generados o realizar comprobaciones específicas del proyecto. Los comandos pueden ejecutarse antes o después de que Locadex procese los archivos:

* **Comando de preprocesamiento** se ejecuta antes de que Locadex procese los archivos. Por ejemplo, ejecuta `npm run build`.
* **Comando de posprocesamiento** se ejecuta después de que Locadex procese los archivos. Por ejemplo, ejecuta `npm run typecheck`.

Los comandos se ejecutan desde la raíz del repositorio y dentro de la [imagen de VM de Locadex](/docs/platform/locadex/reference/vm-image). Si una automatización falla porque falta un paquete, script o binario, agrega un comando de preprocesamiento.

Si falla alguna comprobación, [auto-merge](/docs/platform/locadex/guides/auto-merging-prs) no se ejecutará.

## Next steps

- /docs/platform/locadex/guides/auto-merging-prs
- /docs/platform/locadex/guides/managing-languages
- /docs/platform/locadex/guides/viewing-automation-activity
- /docs/platform/locadex/guides/adding-environment-variables

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
