Utiliser Lantern

Lantern est un gestionnaire de localisation : une organisation contient des projets, un projet contient des clés de traduction, et chaque clé a une valeur dans chaque langue. Vous modifiez les valeurs dans une grille, vous collaborez, et vos applications récupèrent (et éventuellement renvoient) le résultat via l'API.

Instance en ligne : https://lantern.abyss-inn.ch

1. Compte, organisations et projets#

1. Créez un compte avec un nom, un e-mail et un mot de passe (≥ 8 caractères), puis connectez-vous. Nous vous envoyons un lien de vérification : tant que vous n'avez pas confirmé votre adresse, une bannière vous le rappelle et vous ne pouvez ni créer ni rejoindre d'organisation. Utilisez Renvoyer dans la bannière si le message n'arrive pas.
2. Créez une organisation (ou faites-vous ajouter à une organisation existante). Son créateur en est le propriétaire. La collaboration se joue au niveau de l'organisation : les membres ont accès à tous les projets de l'organisation.
3. Dans une organisation, créez un projet (nom + description facultative). L'organisation a les onglets Projets, Membres, Rôles et Paramètres (Rôles et Paramètres n'apparaissent que si vous pouvez les gérer).
4. Changez d'organisation ou de projet depuis la barre supérieure ; cliquez sur 🏮 Lantern pour revenir en arrière.

Chaque projet a les onglets Éditeur, Glossaire, Import / Export, API, Membres et Activité — plus Paramètres, visible uniquement par un propriétaire.

La suppression d'un projet se trouve sur cet onglet Paramètres. Elle est définitive et emporte tout : chaque clé, traduction, commentaire, terme de glossaire et jeton d'API du projet. Vous devez saisir le nom du projet pour confirmer, et la suppression est enregistrée dans l'activité de l'organisation.

Authentification à deux facteurs (facultative). Depuis Compte, activez l'authentification à deux facteurs : scannez le QR code avec une application d'authentification (ou saisissez la clé manuellement), confirmez un code à 6 chiffres et conservez les 10 codes de secours à usage unique affichés une seule fois. Ensuite, la connexion demande un code de votre application — ou l'un de vos codes de secours si vous perdez votre appareil. Vous pouvez régénérer les codes de secours ou désactiver la 2FA depuis Compte (les deux exigent un code valide). Votre secret TOTP et vos codes de secours ne sont jamais inclus dans un export de données.

2. Rôles et permissions#

L'accès repose sur des permissions. Chaque organisation a trois rôles intégrés ; le propriétaire a toujours toutes les permissions et ne peut pas se retrouver bloqué.

Rôles personnalisés. Dans l'onglet Rôles de l'organisation, un propriétaire ou un admin peut définir un rôle personnalisé comme n'importe quel ensemble de ces permissions (par exemple un « Relecteur » qui peut modifier et marquer comme relu mais pas créer de clés), puis l'attribuer à un membre depuis l'onglet Membres. Les rôles personnalisés s'appliquent à tous les projets de l'organisation, exactement comme les rôles intégrés.

3. Langues#

Dans l'onglet Éditeur, les propriétaires et admins ajoutent une langue via son code de locale (par exemple en, fr, de-CH) et un nom d'affichage. La première langue devient la langue par défaut. Les codes de locale sont ce que renvoie l'API et ce qui nomme vos fichiers : choisissez donc les codes attendus par votre application. Supprimez une langue avec le ✕ de sa puce (cela supprime ses valeurs).

4. Clés#

Ajoutez une clé avec un espace de noms facultatif, un nom et une description facultative. Le chemin complet de la clé est espacedenoms.nom (ou simplement nom sans espace de noms) — par exemple espace de noms home + nom title → home.title.

Une clé est rejetée si son chemin complet existe déjà, même par un découpage différent (home+title entre en collision avec un home.title simple). Adoptez une seule convention.

Utilisez le champ de recherche pour filtrer les clés. Les propriétaires et admins peuvent modifier une clé (renommer, changer son espace de noms ou sa description) avec le ✎ situé à côté — la modification conserve toutes les traductions, les statuts et les commentaires existants — ou la supprimer avec le ✕.

5. La grille de l'éditeur#

Les lignes sont les clés, les colonnes les langues. Saisissez une valeur dans une cellule : elle est enregistrée automatiquement quand vous quittez le champ (uniquement si elle a changé).

• Pastille de statut à côté de chaque cellule : gris = non traduit (vide), vert = traduit, bleu = relu. Cliquez sur une pastille verte pour marquer la valeur comme relue ; cliquez à nouveau pour annuler. Modifier une valeur relue la ramène à « traduit ».
• Les barres de complétion en haut indiquent la progression de chaque langue (valeurs remplies / total des clés), et se mettent à jour en direct pendant la saisie.
• La case À relire filtre les clés dont les valeurs sont traduites mais pas encore relues — pratique pour une passe de relecture.
• Personnes assignées — assignez un ou plusieurs membres à une clé pour clarifier qui en est responsable (qui la traduit ou la relit). Cliquez sur la pile d'avatars (ou sur le ➕ d'une clé non assignée) pour choisir des membres dans une liste ; leurs avatars apparaissent sur la clé dans la grille et dans la vue détaillée. Seuls les membres ayant accès au projet peuvent être assignés, et chaque personne assignée reçoit une notification dans l'application. L'assignation requiert la permission assigner des clés (propriétaires, admins et membres par défaut). Les changements apparaissent dans le flux d'activité sous Assignations.

6. Commentaires#

Chaque ligne de clé a un bouton 💬 avec un compteur. Ouvrez-le pour lire le fil et ajouter un commentaire — utile pour donner du contexte (« ne pas dépasser 20 caractères », « c'est un libellé de bouton », etc.).

7. Glossaire#

L'onglet Glossaire contient les termes approuvés d'un projet — noms de produits, mots de marque et vocabulaire délicat que vous voulez voir traduit de façon cohérente. Pour chaque terme, vous pouvez ajouter une description, une traduction approuvée par langue, le marquer ne pas traduire (un nom de marque à conserver tel quel) ou sensible à la casse. Tout le monde peut lire le glossaire ; le gérer requiert la permission gérer le glossaire (propriétaires et admins par défaut).

Dans la vue Focus de l'éditeur, les mots du texte source qui correspondent à un terme du glossaire sont mis en évidence — survolez-les pour voir la traduction approuvée dans la langue que vous êtes en train de traduire, ou une mention « ne pas traduire ». Les modifications de termes apparaissent dans le flux d'activité.

8. Membres et rôles#

Les membres sont gérés au niveau de l'organisation (onglet Membres de l'organisation), pas par projet — un membre peut atteindre tous les projets de l'organisation. Le propriétaire (ou toute personne ayant la permission gérer les membres) peut inviter quelqu'un par e-mail avec le rôle de son choix (Admin, Membre ou n'importe quel rôle personnalisé). La personne invitée reçoit un lien par e-mail et rejoint l'organisation lorsqu'elle accepte — vous pouvez inviter une adresse qui n'a pas encore de compte Lantern (elle s'inscrit, confirme son e-mail, puis accepte). Les invitations en attente sont listées dans l'onglet Membres, où vous pouvez les renvoyer ou les révoquer ; une fois la personne arrivée, vous pouvez changer son rôle ou la retirer. Construisez vos rôles personnalisés dans l'onglet Rôles de l'organisation (voir §2).

9. Import / Export#

Dans l'onglet Import / Export :

• Import
  • JSON — accepte le format plat {"home.title": "..."} comme le format imbriqué {"home": {"title": "..."}}. Importez plusieurs locales à la fois : sélectionnez plusieurs fichiers (la locale est lue dans chaque nom de fichier — en.json, de-CH.json — et affichée pour que vous puissiez la corriger), ou envoyez un seul objet indexé par locale ({"en": {…}, "fr": {…}}) et cochez indexé par locale.
  • CSV / XLSX — une colonne key plus une colonne par locale ; la fusion se fait sur toutes les langues.
  • Tous les formats fusionnent (valeurs existantes mises à jour, nouvelles clés ajoutées), créent automatiquement les langues manquantes (requiert la permission ajouter / supprimer des langues), ignorent les cellules vides (pour ne pas effacer de valeurs) et enregistrent une seule entrée dans le flux d'activité.
• Export
  • JSON pour une langue (plat ou imbriqué), ou CSV / XLSX pour toutes.

L'import est le moyen groupé de faire entrer des clés ; l'API (INTEGRATION.fr.md) est le moyen automatisé de faire sortir les traductions vers vos applications.

10. Jetons d'API#

Dans l'onglet API, les propriétaires et admins créent un jeton, limité à ce projet. La chaîne du jeton est affichée une seule fois — copiez-la à ce moment-là. La liste indique le nom de chaque jeton, son préfixe et sa dernière utilisation ; révoquez un jeton pour couper l'accès immédiatement.

Les jetons sont en lecture seule par défaut. Dépliez Permissions d'écriture au moment de la création pour accorder des portées (par exemple créer des clés, modifier les traductions) afin qu'un agent IA ou un script de CI puisse renvoyer des clés et des valeurs — voir la section sur l'écriture dans INTEGRATION.fr.md.