Las claves se utilizan para identificar cadenas de texto traducibles dentro del código de software. Esto permite que el uso de una clave (como nombre en código para una cadena traducible) sea referenciada solo una vez por Phrase en lugar de para cada traducción requerida de la cadena.
Una clave puede tener varias traducciones asociadas, cada una correspondiente a una configuración regional de idioma diferente del proyecto. La función es similar a la de la clave principal en las bases de datos relacionales, siendo las traducciones un atributo de la clave. Las claves se almacenan en archivos de recursos y se utilizan para identificar los idiomas de origen y destino.
El uso de claves permite a las plataformas de gestión de localización presentar texto traducible a los traductores sin tener que presentar código.
Normalmente no es necesario añadir claves a un proyecto, ya que lo ideal es crearlas cuando se carga un archivo de recursos a través de la pestaña de la página de un proyecto.
Para evitar que se carguen o creen claves, utilice la funcionalidad de bloqueo de claves. Si una clave bloqueada ya existe, no se puede traducir en el editor.
Para excluir claves de la exportación, utilice la funcionalidad de exclusión de claves. Las claves excluidas tampoco se pueden traducir en el editor.
Las claves de un proyecto se pueden duplicar seleccionando Más/Duplicar clave en la sección de la página de un proyecto o en la parte superior del panel del editor de cadenas.
Se pueden vincular diferentes claves de traducción con los mismos valores en uno o varios proyectos para automatizar las actualizaciones de contenido. Las claves vinculadas se utilizan para garantizar la coherencia entre proyectos y eliminar el trabajo repetitivo en contenido idéntico.
Los cambios en las claves se pueden revertir desde la ventana de actividad de la barra lateral en el editor de cadenas.
Nota
Al trabajar con repositorios (GitHub, GitLab, etc.) y eliminar claves, estas deben borrarse tanto de Phrase como del repositorio para que se eliminen de forma permanente. Esto es para evitar la eliminación accidental de claves debido a errores o accidentes en Phrase o en el repositorio.
En Cadenas, las claves pueden ser de diferentes tipos según el formato del archivo cargado:
-
Cadena (predeterminada)
Nota
Los traductores solo pueden editar claves de cadena a menos que la opción esté habilitada en la configuración avanzada de proyecto.
-
Formación
-
Booleano
-
Markdown
-
Número
El tipo de clave se muestra en la sección de la barra lateral del editor.
Los nombres de las claves deben ser únicos dentro de un proyecto.
Existen múltiples estrategias para nombrar claves:
-
Descriptivo
El texto original se identifica por su función. Esto puede dificultar la identificación del texto al leer el código, pero seguirá siendo una constante.
Ejemplo:
-
Cadenas de origen (no recomendado)
El texto original se utiliza como clave, lo que facilita la identificación del uso del texto. Esto es problemático, ya que si el texto original cambia, se rompe la relación con las traducciones.
Ejemplo:
Si las claves no se cargan, se pueden crear manualmente.
Para crear una clave, sigue estos pasos:
-
Desde la pestaña , haz clic en Añadir clave.
Se abre la ventana Añadir clave.
-
Desde la pestaña , proporciona un , , cualquier disponible y una .
-
Si es necesario, habilita formas plurales desde la pestaña y elige el tipo de forma plural.
-
Selecciona los idiomas excluidos desde la pestaña si es necesario.
-
Proporciona detalles técnicos en la pestaña si es necesario.
Por ejemplo, es posible establecer un límite de caracteres para las traducciones en el campo . Si se establece, el límite de caracteres se muestra mediante un indicador en el Editor de cadenas al editar las traducciones de la clave correspondiente.
-
Haz clic en Guardar.
La clave se añade al proyecto y se puede ver en la pestaña .
Eliminar una clave del editor o de la pestaña borrará todas las traducciones asociadas de esa clave y no se puede deshacer.
En proyectos con más de 10,000 claves, las claves no mencionadas no se calcularán en futuras cargas. Las claves no mencionadas son claves que no están incluidas en la carga actual pero que aún existen en el proyecto.
El bloqueo impide que se añadan claves completas a un proyecto; si el nombre de una clave bloqueada aparece en un archivo cargado, esa clave se omite y no se añade al proyecto.
El bloqueo se utiliza para omitir claves de un proyecto de modo que no se gestionen en absoluto.
Claves bloqueadas habitualmente:
-
Cadenas de formato de fecha y hora.
-
Claves que incluyen configuraciones.
-
Claves que causan problemas cuando se gestionan con la gema Phrase.
Las claves bloqueadas deben gestionarse en un archivo de idioma independiente que no se procese ni se mantenga.
Estas claves pueden causar problemas y, si se utilizan, deben bloquearse al crear un proyecto.
-
activemodel.errors* -
number.format* -
number.currency* -
number.percentage* -
datetime.prompts*
Para bloquear una clave, sigue estos pasos:
-
Desde la página de un proyecto, selecciona la pestaña .
-
Haz clic en Añadir clave a la lista de claves bloqueadas.
Se abre la ventana .
-
Proporciona un nombre para la clave o una expresión regular (regex) y haz clic en Guardar.
La clave se añade a la lista.
Consejo
Los chatbots de IA pueden ser muy eficaces para generar y verificar expresiones regulares.
Usa herramientas como Regex101 para probar expresiones regulares con diferentes entradas.
Las claves se pueden modificar más tarde haciendo clic en o eliminarlas haciendo clic en
.
Es posible que algunas claves deban excluirse de ciertos idiomas y pueden marcarse como excluidas. Estas claves se cargan y existen dentro de un proyecto, pero se ignoran.
Las traducciones excluidas son:
-
Excluido de la exportación del idioma relacionado.
-
Excluido de los informes del idioma relacionado.
Si el contenido está vacío, no se cuenta como no traducido.
-
Visible pero no editable en el editor de traducción.
Las traducciones excluidas se omiten de los recuentos de traducido/no traducido y de los informes de idioma. Como resultado, un proyecto o configuración regional puede mostrar 0 cadenas no traducidas incluso cuando a las traducciones excluidas todavía les falta una traducción real. Esto incluye contenido en blanco o una copia no traducida del texto fuente. Para confirmar que un proyecto está realmente completo, consulta la pestaña o consulta las traducciones con excluded:true a través de la API, además del recuento de no traducidos.
Opciones de exclusión:
-
Excluye una sola traducción en un idioma dentro del editor de traducción.
-
Excluye varias traducciones en un idioma dentro del editor de traducción.
-
Excluye varias traducciones seleccionando los idiomas al crear o editar la clave.
Para excluir una clave, sigue estos pasos:
-
Desde la página de claves, haz clic en
para la clave que requiere exclusión.
Se abre la ventana .
-
Selecciona la pestaña .
-
Selecciona los idiomas para excluir.
-
Haz clic en Guardar.
La selección se excluye en la clave especificada.
Las claves también se pueden excluir individualmente o de forma masiva desde la lista de claves del editor seleccionando la(s) clave(s) y utilizando el menú .