Las claves se utilizan para identificar cadenas de texto traducibles dentro del código de software. Esto permite que se use una clave (como un nombre de código para una cadena traducible) que se haga referencia solo una vez por Phrase en lugar de para cada traducción requerida de la cadena.
Una clave puede tener múltiples traducciones asociadas, cada una correspondiente a un idioma local diferente del proyecto. La función es similar a la de la clave primaria en 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 que las plataformas de gestión de localización presenten texto traducible a los traductores sin tener que presentar código.
Normalmente, no es necesario agregar claves a un proyecto, ya que idealmente se crean cuando se carga un archivo de recursos a través de la pestaña de una página de proyecto.
Para evitar que se carguen o creen claves, utiliza la funcionalidad de clave de bloqueo. Si ya existe una clave bloqueada, no se puede traducir en el editor.
Para excluir claves de la exportación, utiliza la funcionalidad de excluir claves. Las claves excluidas tampoco se pueden traducir en el editor.
Las claves en un proyecto se pueden duplicar seleccionando Más/Duplicar clave en la sección de una página de proyecto o en la parte superior del panel del editor de cadenas.
Diferentes claves de traducción con los mismos valores en uno o varios proyectos se pueden vincular para automatizar actualizaciones de contenido. Claves vinculadas se utilizan para garantizar la consistencia 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, las claves deben eliminarse tanto de Phrase como del repositorio para ser eliminadas permanentemente. Esto es para prevenir 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 dependiendo del formato del archivo cargado:
-
Cadena (predeterminado)
Nota
Los traductores solo pueden editar claves de cadena a menos que la opción esté habilitada en la configuración avanzada del 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.
Hay múltiples estrategias para nombrar claves:
-
Descriptivo
El texto original se identifica por función. Esto puede dificultar la identificación del texto al leer el código, pero seguirá siendo una constante.
Ejemplo:
-
Cadenas fuente (no recomendado)
El texto original en sí se utiliza como la clave, lo que facilita identificar el uso del texto. Esto es problemático ya que si el texto original cambia, rompe la relación con las traducciones.
Ejemplo:
Si las claves no están cargadas, se pueden crear manualmente.
Para crear una clave, sigue estos pasos:
-
Desde la pestaña , haz clic en Agregar clave.
Se abre la ventana Agregar 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 de 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 Strings al editar las traducciones de la clave correspondiente.
-
Haz clic en Guardar.
La clave se agrega al proyecto y se puede ver en la pestaña .
Eliminar una clave del editor o de la pestaña eliminará todas las traducciones asociadas de esa clave y no se puede revertir.
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 claves enteras se agreguen a un proyecto; si el nombre de una clave bloqueada aparece en un archivo cargado, esa clave se omite y no se agrega al proyecto.
El bloqueo se utiliza para omitir claves de un proyecto para que no se gestionen en absoluto.
Claves típicamente bloqueadas:
-
Cadenas de formato de fecha y hora.
-
Claves que incluyen configuraciones.
-
Claves que causan problemas cuando se gestionan con la gema Phrase.
Gestiona las claves bloqueadas en un archivo de idioma separado que no se procesa ni se mantiene.
Estas claves pueden causar problemas y, si se utilizan, deben ser bloqueadas cuando se crea un proyecto.
-
activemodel.errors* -
number.format* -
number.currency* -
number.percentage* -
datetime.prompts*
Para bloquear una clave, sigue estos pasos:
-
Desde una página de proyecto, selecciona la pestaña .
-
Haz clic en Agregar 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 agrega a la lista.
Consejo
Los chatbots de IA pueden ser muy efectivos para generar y verificar regex.
Usa herramientas como Regex101 para probar regex con diferentes entradas.
Las claves pueden ser modificadas más tarde haciendo clic en o eliminadas
.
Algunas claves pueden necesitar ser excluidas de ciertos idiomas y pueden ser marcadas como excluidas. Estas claves se suben y existen dentro de un proyecto, pero son ignoradas.
Las traducciones excluidas son:
-
Excluidas de la exportación del idioma relacionado.
-
Excluidas 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.
Opciones de exclusión:
-
Excluir una sola traducción en un idioma dentro del editor de traducción.
-
Excluir múltiples traducciones en un idioma dentro del editor de traducción.
-
Excluir múltiples 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 .
-
Seleccione los idiomas para exclusión.
-
Haz clic en Guardar.
La selección se excluye en la clave especificada.
Las claves también se pueden excluir individualmente o en bloque de la lista de claves del editor seleccionando la(s) clave(s) y utilizando el menú de .