Las claves son usadas para identificar cadenas de texto traducible dentro del código de software. Esto permite que el uso de una clave (como un nombre de código para una cadena traducible) sea referenciado solo una vez por Phrase en lugar de para cada traducción requerida de la cadena.
Una clave puede tener múltiples traducciones asociadas con ella, cada una correspondiente a una localización de idioma diferente del proyecto. La función es similar a la de la clave primaria en bases de datos relacionales con las traducciones siendo un atributo de la clave. Las claves son almacenadas en archivos de recursos y son usadas para identificar idiomas fuente y meta.
El uso de claves permite a las plataformas de gestión de localización presentar texto traducible a traductores sin tener que presentar código.
Las claves normalmente no necesitan ser añadidas a un proyecto ya que idealmente son creadas cuando un archivo de recursos es subido a través de la pestaña de una página de proyecto.
Para prevenir que las claves sean subidas o creadas, usar la funcionalidad bloqueo de clave. Si una clave bloqueada ya existe, no puede ser traducida en el editor.
Para Excluir claves de la exportación, usar la funcionalidad Excluir claves. Las claves excluidas tampoco pueden ser traducidas en el editor.
Las claves en un proyecto pueden duplicar seleccionando Más/Duplicar clave en la sección de una página de proyecto o en la parte superior del Strings Editor pane.
Diferentes claves de traducción con los mismos valores a través de uno o múltiples proyectos pueden ser vinculadas para automatizar actualizaciones de contenido. Claves vinculadas son usadas para asegurar consistencia a través de proyectos y eliminar trabajo repetitivo en contenido idéntico.
Los cambios a las claves pueden ser revertidos desde la ventana de actividad de la barra lateral en el Strings Editor.
Nota
Al trabajar con repositorios (GitHub, GitLab, etc.) y eliminar claves, las claves deben ser eliminadas 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 tanto en Phrase como en el repositorio.
En Strings, las claves pueden ser de diferentes tipos dependiendo del formato del archivo subido:
-
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.
Existen múltiples estrategias para nombrar claves:
-
Descriptiva
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:
-
Strings fuente (no recomendado)
El texto original se usa como la clave, lo que facilita identificar el 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, siga estos pasos:
-
Desde la pestaña , hacer clic en Agregar clave.
Se abre la ventana Agregar clave.
-
Desde la pestaña , proporcionar un , , cualquier
-
Si es necesario, Habilitar formas plurales desde la pestaña y elegir el tipo de forma plural.
-
Seleccionar idiomas excluidos desde la pestaña si es necesario.
-
Proporcionar detalles técnicos en la pestaña si es necesario.
Por ejemplo, es posible establecer un límite de carácter para las traducciones en el campo . Si se establece, el límite de carácter se muestra mediante un indicador en el Strings Editor 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 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 evita que se agreguen claves completas 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 bloqueadas habitualmente:
-
Strings de formato de fecha y hora.
-
Claves que incluyen configuraciones.
-
Claves que causan problemas cuando se gestionan con la gema de Phrase.
Gestione 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 bloquearse cuando se crea un proyecto.
-
activemodel.errors* -
number.format* -
number.currency* -
number.percentage* -
datetime.prompts*
Para bloquear una clave, siga estos pasos:
-
Desde la página de un proyecto, Seleccionar la pestaña .
-
Haga clic en Add key to the blocked keys list.
Se abre la ventana .
-
Proporcione un nombre para la clave o una expresión regular (regex) y haga clic en Save.
La clave se agrega a la lista.
Consejo
Los chatbots de IA pueden ser muy eficaces para generar y verificar regex.
Usar Herramientas como Regex101 para probar regex con diferentes entradas.
Las claves pueden modificarse más tarde haciendo clic en o eliminarse
.
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 exportar 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.
Opciones de exclusión:
-
Excluir una sola traducción en un idioma dentro del editor de traducción.
-
Excluir varias traducciones en un idioma dentro del editor de traducción.
-
Excluir varias traducciones seleccionando los idiomas al crear o editar la clave.
Para excluir una clave, siga estos pasos:
-
Desde la página de claves, haga clic en
para la clave que requiere exclusión.
Se abre la ventana .
-
Seleccionar la pestaña .
-
Seleccione los idiomas para la exclusión.
-
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ú .