Volver

gt-sanity@3.1.0

Fernando Aviles avatarFernando Aviles
gt-sanityv3.1.0sanitycmstranslationminor

Overview

El contenido traducido rara vez se mantiene intacto. Los editores corrigen un término, pulen un titular o ajustan el tono para un mercado; hasta ahora, la siguiente ejecución de traducción lo regeneraba todo.

gt-sanity v3.1 incorpora Guardar ediciones locales: las traducciones que ya contiene Sanity se cargan en General Translation antes de una ejecución de traducción, de modo que el contenido cuyo texto de origen no ha cambiado conserva su redacción actual. Está desactivado de forma predeterminada y debe activarse en cada sesión de Studio.

La versión también incorpora una acción de Guardar ediciones locales para cargar traducciones existentes sin iniciar una ejecución y una opción de Retraducir desde cero para regenerarlo todo deliberadamente.

Novedades

Guardar ediciones locales

Activa el interruptor Guardar ediciones locales en la herramienta Translations o en la pestaña de documento General Translation. Al activarlo, cada ejecución de traducción comienza enviando a General Translation las traducciones que se encuentran actualmente en Sanity. Estas pasan a ser la traducción almacenada para la versión de origen, de modo que la siguiente ejecución las reutiliza en lugar de volver a traducir ese contenido.

Se admiten ambas estrategias de localización: las traducciones por documento se leen a través de translation.metadata (se da prioridad a los borradores frente a los documentos publicados, por lo que se tienen en cuenta las ediciones sin publicar), y los valores de configuración regional de las listas internacionalizadas se leen del documento de origen. Las configuraciones regionales sin contenido existente se omiten en lugar de cargarse como traducciones vacías.

Establece el estado inicial del interruptor en la configuración de tu plugin:

import { defineConfig } from 'sanity';
import { gtPlugin } from 'gt-sanity';

export default defineConfig({
  plugins: [
    gtPlugin({
      sourceLocale: 'en',
      locales: ['es', 'fr', 'ja'],
      translateDocuments: [{ type: 'post' }],
      preserveExistingTranslations: true,
    }),
  ],
});

preserveExistingTranslations establece el estado inicial del interruptor al cargar Studio. Los editores pueden cambiarlo para su sesión desde la interfaz de usuario.

Sanity se convierte en la fuente de referencia

Al activar el interruptor, primero se muestra una explicación, porque la contrapartida es real: lo que hay en Sanity reemplaza todo lo que General Translation tiene para esa versión del documento, incluida una traducción finalizada que aún no se ha importado. Importe las traducciones pendientes antes de activarlo.

El paso de captura se ejecuta antes de cargar el contenido fuente y se realiza con el criterio de best effort. Si falla, la ejecución de traducción continúa y Studio advierte que las ediciones podrían sobrescribirse.

Guardar ediciones locales

La acción Guardar ediciones locales carga las traducciones ya presentes en Sanity sin poner una traducción en cola e inicializa los archivos fuente según sea necesario. Úsala al incorporar el plugin a un proyecto traducido en otro lugar, para que General Translation parta del contenido que ya tienes.

Está disponible en la herramienta Translations y en la pestaña del documento.

Retraducir desde cero

Traducir todo ahora incluye una casilla Retraducir desde cero. Al marcarla, se descartan las traducciones existentes y se regeneran, incluidos los cambios realizados en los documentos traducidos en Studio. Déjela sin marcar para reutilizar las traducciones existentes.

Antes, el plugin no permitía forzar una retraducción.

Enlaces