---
title: "Revisar en Studio"
description: "Arranca Verbatra Studio, trabaja la cola de revisión, corrige entradas en el sitio y retraduce las claves marcadas desde el panel local."
type: "how-to"
---
# Revisar en Studio

Arranca Verbatra Studio, trabaja la cola de revisión, corrige entradas en el sitio y retraduce las claves marcadas desde el panel local.

Usa esto para revisar traducciones automáticas antes de publicarlas: encuentra lo pendiente, corrige valores a mano y aprueba o rechaza lo que escribió un proveedor, en Verbatra Studio, un panel local sobre tu proyecto.

Dos reglas valen en todo momento. **La edición local está siempre activa**. **El gasto con el proveedor está siempre desactivado** salvo que arranques Studio con `--allow-spend`.

## Arranca Studio [#arranca-studio]

```bash
npm install --save-dev @verbatra/studio
verbatra studio
```

Abre la URL que imprime, token incluido. [`verbatra studio`](https://verbatra.kreitz-webdev.de/es/docs/cli/studio.md) cubre el puerto, el token, cada opción y la actualización en vivo.

## Lee la página Translations [#lee-la-página-translations]

### Una tabla de claves [#una-tabla-de-claves]

<AvailableFrom version="0.7.0" pkg="@verbatra/studio" />

Translations es una tabla de todas las claves que necesitan atención: faltantes, modificadas, huérfanas, protegidas, en la cola de revisión o con una comprobación de integridad fallida. Cada fila muestra la clave, el texto de origen y un estado por locale; elige una locale para ver traducción, estado y origen. La búsqueda también encuentra claves sincronizadas.

### Detalles de la clave [#detalles-de-la-clave]

Haz clic en una clave para abrir su editor. Lista el valor de cada locale con un indicador de integridad: los placeholders coinciden, un desajuste de placeholders con los tokens nombrados, o una sintaxis de mensaje no válida. También se muestra:

| Detalle | Muestra |
| --- | --- |
| **Inline markup mismatch** | cada etiqueta que la traducción quitó (`-`) o añadió (`+`) <AvailableFrom version="0.5.1" pkg="@verbatra/studio" /> |
| **ICU arms mismatch** | ramas plural o select que no encajan con el idioma de destino; los valores de derecha a izquierda se muestran de derecha a izquierda ([Idiomas y locales](https://verbatra.kreitz-webdev.de/es/docs/language-support.md#idiomas-de-derecha-a-izquierda)) <AvailableFrom version="0.6.0" pkg="@verbatra/studio" /> |
| Insignia de origen | quién escribió cada valor, leída de [`verbatra.provenance.json`](https://verbatra.kreitz-webdev.de/es/docs/the-lock-file.md#procedencia-quién-escribió-cada-valor), por ejemplo **Machine**, **Human** o **Edited outside verbatra** <AvailableFrom version="0.6.0" pkg="@verbatra/studio" /> |

### Filtrar por estado [#filtrar-por-estado]

<AvailableFrom version="0.6.0" pkg="@verbatra/studio" />

Los chips junto a la búsqueda acotan la tabla por estado, incluidos **Review queue** e **Integrity problems**. **Copy as review report** copia las claves pendientes como Markdown para un pull request.

### Edita con la puerta de integridad [#edita-con-la-puerta-de-integridad]

**Edit** abre el borrador de ese locale. Guardar pasa el valor por la [puerta de integridad](https://verbatra.kreitz-webdev.de/es/docs/translation-safety.md#la-puerta-de-integridad); un valor rechazado no se escribe, y se muestra el motivo. Una edición aceptada escribe el archivo de locale y actualiza el archivo de bloqueo.

#### Comprobaciones del borrador [#comprobaciones-del-borrador]

<AvailableFrom version="0.6.0" pkg="@verbatra/studio" />

El editor muestra la descripción de la clave, los términos del glosario que tu borrador usa u omite, y su longitud frente al origen y a `maxLength`. Ctrl o Cmd con Enter guarda.
#### Fijar un límite de longitud [#fijar-un-límite-de-longitud]

<AvailableFrom version="0.7.0" pkg="@verbatra/studio" />

Bajo la línea de longitud, **Set limit**, **Change limit** y **Remove limit** editan la entrada de la clave en [`verbatra.limits.json`](https://verbatra.kreitz-webdev.de/es/docs/config-file.md#maxlength), para todos los locales. El `maxLength` de la configuración gana y es de solo lectura. Un archivo inutilizable muestra el motivo y bloquea el control. Un límite es solo un aviso: las ejecuciones de translate marcan un valor más largo para revisión y nada se bloquea. Studio fija límites solo para claves del origen; un límite escrito para la propia clave de una forma generada sigue aplicándose.

#### Revisar mensajes con la ICU preview [#revisar-mensajes-con-la-icu-preview]

<AvailableFrom version="0.7.0" pkg="@verbatra/studio" />

Con `next-intl-json` o `arb`, una **ICU preview** plegada bajo el borrador lo renderiza una vez por rama en el idioma y la dirección de la configuración regional. Un valor de ejemplo que escribes añade una fila cuando alcanza una rama, o una nota si no se usa. Los números y las fechas usan los datos de idioma de este equipo, así que tu app puede diferir.

#### Junto a la tabla [#junto-a-la-tabla]

<AvailableFrom version="0.7.0" pkg="@verbatra/studio" />

Desde 1280px de ancho el editor se coloca junto a la tabla; por debajo se abre como cajón. Si sales de la clave con cambios sin guardar, Studio pregunta si guardar, descartar o seguir editando; al salir de Studio en sí, confirma el navegador.

### Buscar y reemplazar [#buscar-y-reemplazar]

<AvailableFrom version="0.7.0" pkg="@verbatra/studio" />

**Search and replace** reemplaza texto literal en los valores traducidos: elige el texto, el reemplazo, si distingue mayúsculas y los locales, revisa cada coincidencia (hasta 1000) y aplica. Las claves ancladas y los valores protegidos quedan fuera salvo que marques su casilla. Protegido significa que una persona lo escribió, lo importó o lo cambió fuera de verbatra, o cualquier valor cuando `verbatra.provenance.json` no se puede leer.

## Trabaja la cola de Review [#trabaja-la-cola-de-review]

La página Review lista cada valor que escribió una máquina y que nadie ha aprobado: una fila por locale y clave, con el texto de origen completo sobre la traducción, su origen y cualquier [señal de revisión](https://verbatra.kreitz-webdev.de/es/docs/translation-safety.md#señales-de-revisión) de la última ejecución en esta máquina.

<StudioScreenshot
  shot="review"
  alt="La página Review de Verbatra Studio con el chip Needs review activado y entradas en alemán; dos filas llevan motivos de revisión, Matches source text y Unusual length, junto al origen Machine, y cada fila tiene las acciones Edit, Approve y Reject."
  caption="La cola de Review tras una ejecución, con las filas marcadas y sus motivos. Studio viene en claro y oscuro; cambia la captura para compararlos."
/>

### Nombres de las señales [#nombres-de-las-señales]

<AvailableFrom version="0.5.1" pkg="@verbatra/studio" />

Dos señales de revisión se leen **Over length budget** y **Reused after source edit**.

### Acciones por fila [#acciones-por-fila]

<AvailableFrom version="0.5.0" pkg="@verbatra/studio" />

Filtra por locale o texto y luego trabaja cada fila:

- **Edit** abre el editor con la puerta de integridad. Una edición aceptada saca la fila de la cola.
- **Approve** acepta el valor tal como está.
- **Reject** elimina el valor para que se sustituya, tras una confirmación.

### Decisiones guardadas [#decisiones-guardadas]

<AvailableFrom version="0.6.0" pkg="@verbatra/studio" />

Ambas decisiones se guardan en `verbatra.provenance.json` según las reglas de [Decisiones de revisión](https://verbatra.kreitz-webdev.de/es/docs/the-lock-file.md#decisiones-de-revisión). Una aprobación además necesita que el valor esté al día con su origen. Confirma juntos el archivo de locale, el archivo de bloqueo y el archivo de procedencia; en un proyecto XLIFF, edita en lugar de rechazar.

### Una cola para todo el equipo [#una-cola-para-todo-el-equipo]

<AvailableFrom version="0.6.0" pkg="@verbatra/studio" />

La cola se lee de los archivos confirmados, así que un compañero que los descarga ve la misma cola. Un valor sale de ella en cuanto una persona lo aprueba, lo rechaza, lo escribe o lo importa; un valor aprobado que una máquina reescribe vuelve a entrar.

Los chips **Needs review** y **Approved** cambian la lista y muestran contadores; la barra acota por origen; con un locale elegido, **Approve all in** lo aprueba entero tras una confirmación. Para que un pull request falle mientras haya traducciones automáticas esperando, ejecuta [`verbatra check --require-reviewed`](https://verbatra.kreitz-webdev.de/es/docs/cli/check.md#exigir-traducciones-revisadas) en la CI.

### Trabaja la cola con el teclado [#trabaja-la-cola-con-el-teclado]

<AvailableFrom version="0.6.0" pkg="@verbatra/studio" />

Pulsa `j` o la flecha abajo para empezar, y luego:

| Tecla | Acción |
| --- | --- |
| `j` o flecha abajo | entrada siguiente |
| `k` o flecha arriba | entrada anterior |
| `a` | aprobar la entrada resaltada |
| `r` | rechazarla (la confirmación se sigue abriendo) |
| `e` o Enter | abrirla en el editor |
| `t` | retraducirla (solo con `--allow-spend`; llama a tu proveedor) |
| `x` | seleccionarla o quitarla de la selección para una acción en bloque |
| `?` | mostrar u ocultar la lista de atajos |

Los atajos se pausan mientras escribes, el foco está en la barra de filtros o hay un diálogo abierto.

### Actúa sobre varias entradas a la vez [#actúa-sobre-varias-entradas-a-la-vez]

<AvailableFrom version="0.6.0" pkg="@verbatra/studio" />

Marca filas (o la casilla de la cabecera para todo lo que muestra el filtro) y elige **Approve selected**, **Reject selected** o, con `--allow-spend`, **Retranslate selected**. Los fallos se listan por causa y siguen seleccionados. Un lote admite como máximo 100 entradas para aprobar o rechazar, o 20 para retraducir.

## Retraduce una clave marcada [#retraduce-una-clave-marcada]

Arranca Studio con el gasto permitido ([cómo se concede el gasto](https://verbatra.kreitz-webdev.de/es/docs/cli/studio.md#gasto-y-herramientas-de-agente)):

```bash
verbatra studio --allow-spend
```

Aparece entonces un botón **Retranslate** en cada fila de Review, y en el editor de una clave para un valor con un defecto de integridad. Hace una sola llamada al proveedor, pasa el resultado por la puerta de integridad y deja el nuevo valor en la cola para que lo apruebes. Desde una fila de Review, un valor que escribió una persona nunca se sustituye; en su editor en Translations, elige **Replace anyway**.

## Traduce los cambios pendientes [#traduce-los-cambios-pendientes]

Cuando el archivo de origen o un archivo de locale de destino cambia mientras Studio está en marcha, un aviso dice `Source changed` o `Target changed: de` con el recuento de claves. Con `--allow-spend`, el aviso de origen ofrece además **Translate pending changes across all locales**: la misma ejecución que haría `verbatra translate`.

## Revisa la cobertura y la última ejecución en Overview [#revisa-la-cobertura-y-la-última-ejecución-en-overview]

<AvailableFrom version="0.7.0" pkg="@verbatra/studio" />

Overview es la página con la que arranca Studio. Muestra la cobertura de cada locale con su estado en el [archivo de bloqueo](https://verbatra.kreitz-webdev.de/es/docs/the-lock-file.md), el historial de git de tus archivos de locale y el uso de tokens de la última ejecución registrada, con el medidor de presupuesto cuando hay un presupuesto de tokens configurado.

**Run history and cost**, debajo, muestra el coste y los tokens de las ejecuciones más recientes sobre una tabla, con la última cobertura conocida de cada locale.

<StudioScreenshot
  shot="overview"
  alt="La página Overview de Verbatra Studio con cuatro cifras, Needs attention, Waiting for review, Avg coverage y Locales in sync, sobre una tabla con la cobertura de los locales de, es y fr y enlaces a las traducciones y a la revisión de cada locale."
  caption="La página Overview es con la que arranca Studio. Cambia la captura para comparar claro y oscuro."
/>

## Mantén el glosario al día en la página Glossary [#mantén-el-glosario-al-día-en-la-página-glossary]

<AvailableFrom version="0.4.0" pkg="@verbatra/studio" />

Glossary tiene su propia página. Con un glosario JSON puedes buscar, añadir, editar y eliminar términos. Eliminar pregunta primero; los cambios sin guardar preguntan al salir. Un glosario inline sigue siendo de solo lectura.

Una edición del glosario cambia lo que se le indica a la siguiente ejecución, nunca el texto ya escrito; reinicia Studio para que sus propias retraducciones la usen.

### Vista por locale [#vista-por-locale]

<AvailableFrom version="0.6.0" pkg="@verbatra/studio" />

**Show translations for** cambia a la vista del [glosario](https://verbatra.kreitz-webdev.de/es/docs/config-file.md#glossary) de un locale, con su traducción, las variantes prohibidas y la nota.

## Relacionado [#relacionado]

- [Maneja Studio con un agente del navegador](https://verbatra.kreitz-webdev.de/es/docs/agent-tools-in-studio.md): el mismo flujo desde un agente de IA en el navegador.
- [Registrar evidencia de traducción automática](https://verbatra.kreitz-webdev.de/es/docs/provenance-evidence.md)
- [Revisar y retraducir desde el SDK](https://verbatra.kreitz-webdev.de/es/docs/sdk/review.md)