Usar Lantern

Lantern es un gestor de localización: una organización contiene proyectos, un proyecto contiene claves de traducción y cada clave tiene un valor en cada idioma. Editas los valores en una cuadrícula, colaboras y tus aplicaciones descargan (y opcionalmente envían) el resultado a través de la API.

Instancia en vivo: https://lantern.abyss-inn.ch

1. Cuenta, organizaciones y proyectos#

1. Regístrate con nombre, correo y una contraseña (≥ 8 caracteres) y luego inicia sesión. Te enviamos un enlace de verificación: hasta que confirmes tu dirección, un aviso te lo recuerda y no puedes crear organizaciones ni unirte a ellas. Usa Reenviar en el aviso si el mensaje no llega.
2. Crea una organización (o pide que te añadan a una). Quien la crea es su propietario. La colaboración ocurre a nivel de organización: los miembros pueden acceder a todos los proyectos de la organización.
3. Dentro de una organización, crea un proyecto (nombre + descripción opcional). La organización tiene las pestañas Proyectos, Miembros, Roles y Ajustes (Roles y Ajustes solo aparecen si puedes gestionarlos).
4. Cambia de organización o de proyecto desde la barra superior; haz clic en 🏮 Lantern para volver.

Cada proyecto tiene las pestañas Editor, Glosario, Importar / Exportar, API, Miembros y Actividad — más Ajustes, que solo ve un propietario.

Eliminar un proyecto está en esa pestaña Ajustes. Es definitivo y se lleva todo por delante: cada clave, traducción, comentario, término del glosario y token de API del proyecto. Tienes que escribir el nombre del proyecto para confirmar, y la eliminación queda registrada en la actividad de la organización.

Autenticación en dos pasos (opcional). Desde Cuenta, activa la autenticación en dos pasos: escanea el código QR con una aplicación de autenticación (o pega la clave manualmente), confirma un código de 6 dígitos y guarda los 10 códigos de respaldo de un solo uso que se muestran una única vez. A partir de ahí, iniciar sesión pide un código de tu aplicación — o uno de tus códigos de respaldo si pierdes el dispositivo. Puedes regenerar los códigos de respaldo o desactivar la 2FA desde Cuenta (ambas acciones requieren un código vigente). Tu secreto TOTP y tus códigos de respaldo nunca se incluyen en una exportación de datos.

2. Roles y permisos#

El acceso se basa en permisos. Cada organización tiene tres roles integrados; el propietario siempre tiene todos los permisos y no puede quedarse fuera.

Roles personalizados. En la pestaña Roles de la organización, un propietario o admin puede definir un rol personalizado como cualquier conjunto de estos permisos (por ejemplo, un «Revisor» que pueda editar y marcar como revisado pero no crear claves) y luego asignarlo a un miembro en la pestaña Miembros. Los roles personalizados se aplican a todos los proyectos de la organización, igual que los integrados.

3. Idiomas#

En la pestaña Editor, propietarios y admins añaden un idioma mediante su código de configuración regional (por ejemplo en, fr, de-CH) y un nombre visible. El primer idioma pasa a ser el predeterminado. Esos códigos son lo que devuelve la API y lo que da nombre a tus archivos, así que elige los que espera tu aplicación. Elimina un idioma con la ✕ de su etiqueta (esto borra sus valores).

4. Claves#

Añade una clave con un espacio de nombres opcional, un nombre y una descripción opcional. La ruta completa de la clave es espaciodenombres.nombre (o solo nombre sin espacio de nombres) — por ejemplo, espacio de nombres home + nombre title → home.title.

Una clave se rechaza si su ruta completa ya existe, incluso con una división distinta (home+title choca con un home.title simple). Elige una sola convención.

Usa el cuadro de búsqueda para filtrar las claves. Propietarios y admins pueden editar una clave (renombrarla, cambiar su espacio de nombres o su descripción) con la ✎ contigua —la edición conserva todas las traducciones, estados y comentarios existentes— o eliminarla con la ✕.

5. La cuadrícula del editor#

Las filas son claves y las columnas idiomas. Escribe un valor en una celda: se guarda automáticamente al salir del campo (solo si ha cambiado).

• Punto de estado junto a cada celda: gris = sin traducir (vacío), verde = traducido, azul = revisado. Haz clic en un punto verde para marcar el valor como revisado; haz clic de nuevo para desmarcarlo. Editar un valor revisado lo devuelve a «traducido».
• Las barras de progreso de la parte superior muestran el avance de cada idioma (valores rellenados / claves totales) y se actualizan en directo mientras escribes.
• La casilla Pendiente de revisión filtra las claves con valores traducidos pero aún no revisados — útil para una pasada de revisión.
• Asignados — asigna uno o varios miembros a una clave para dejar clara la responsabilidad (quién la traduce o la revisa). Haz clic en la pila de avatares (o en el ➕ de una clave sin asignar) para elegir miembros de una lista; sus avatares aparecen en la clave tanto en la cuadrícula como en la vista de detalle. Solo se pueden asignar miembros con acceso al proyecto, y cada persona asignada recibe una notificación dentro de la aplicación. Asignar requiere el permiso asignar claves (propietarios, admins y miembros de forma predeterminada). Los cambios aparecen en el registro de actividad bajo Asignaciones.

6. Comentarios#

Cada fila de clave tiene un botón 💬 con un contador. Ábrelo para leer el hilo y añadir un comentario — útil para dar contexto («no superar los 20 caracteres», «esto es la etiqueta de un botón», etc.).

7. Glosario#

La pestaña Glosario contiene los términos aprobados de un proyecto: nombres de producto, palabras de marca y vocabulario delicado que quieres traducir de forma coherente. Para cada término puedes añadir una descripción y una traducción aprobada por idioma, marcarlo como no traducir (un nombre de marca que se mantiene literal) o distingue mayúsculas. Cualquiera puede leer el glosario; gestionarlo requiere el permiso gestionar el glosario (propietarios y admins de forma predeterminada).

En la vista Foco del editor, las palabras del texto de origen que coinciden con un término del glosario se resaltan — pasa el ratón por encima para ver la traducción aprobada en el idioma al que estás traduciendo, o una nota de «no traducir». Los cambios en los términos aparecen en el registro de actividad.

8. Miembros y roles#

Los miembros se gestionan a nivel de organización (pestaña Miembros de la organización), no por proyecto: un miembro puede llegar a todos los proyectos de la organización. El propietario (o cualquiera con el permiso gestionar miembros) puede invitar a alguien por correo con el rol que elija (Admin, Miembro o cualquier rol personalizado). La persona invitada recibe un enlace por correo y se une cuando acepta — puedes invitar a una dirección que todavía no tenga cuenta en Lantern (se registra, confirma su correo y luego acepta). Las invitaciones pendientes se listan en la pestaña Miembros, donde puedes reenviarlas o revocarlas; una vez que alguien se ha unido, puedes cambiar su rol o quitarlo. Crea roles personalizados en la pestaña Roles de la organización (véase §2).

9. Importar / Exportar#

En la pestaña Importar / Exportar:

• Importación
  • JSON — admite tanto el formato plano {"home.title": "..."} como el anidado {"home": {"title": "..."}}. Importa varios idiomas a la vez: selecciona varios archivos (el idioma se lee de cada nombre de archivo — en.json, de-CH.json — y se muestra para que puedas corregirlo), o sube un único objeto indexado por idioma ({"en": {…}, "fr": {…}}) y marca indexado por idioma.
  • CSV / XLSX — una columna key más una columna por idioma; fusiona todos los idiomas.
  • Todos los formatos fusionan (se actualizan los valores existentes y se añaden las claves nuevas), crean automáticamente los idiomas que falten (requiere el permiso añadir / eliminar idiomas), omiten las celdas vacías (no borran valores) y registran una sola entrada en el registro de actividad.
• Exportación
  • JSON para un idioma (plano o anidado), o CSV / XLSX para todos.

La importación es la vía masiva para meter claves; la API (INTEGRATION.es.md) es la vía automatizada para sacar las traducciones hacia tus aplicaciones.

10. Tokens de API#

En la pestaña API, propietarios y admins crean un token, limitado a ese proyecto. La cadena del token se muestra una sola vez — cópiala en ese momento. La lista indica el nombre, el prefijo y el último uso de cada token; revoca cualquier token para cortar el acceso de inmediato.

Los tokens son de solo lectura de forma predeterminada. Despliega Permisos de escritura al crear uno para conceder ámbitos (por ejemplo crear claves, editar traducciones) de modo que un agente de IA o un script de CI pueda enviar claves y valores de vuelta — consulta la sección de escritura en INTEGRATION.es.md.