Usare Lantern

Lantern è un gestore di localizzazione: un'organizzazione contiene progetti, un progetto contiene chiavi di traduzione e ogni chiave ha un valore in ogni lingua. Modifichi i valori in una griglia, collabori e le tue applicazioni scaricano (ed eventualmente inviano) il risultato tramite l'API.

Istanza live: https://lantern.abyss-inn.ch

1. Account, organizzazioni e progetti#

1. Registrati con nome, email e una password (≥ 8 caratteri), poi accedi. Ti inviamo un link di verifica: finché non confermi il tuo indirizzo, un banner te lo ricorda e non puoi creare organizzazioni né unirti a esse. Usa Invia di nuovo nel banner se il messaggio non arriva.
2. Crea un'organizzazione (o fatti aggiungere a una esistente). Chi la crea ne è il proprietario. La collaborazione avviene a livello di organizzazione: i membri hanno accesso a tutti i progetti dell'organizzazione.
3. All'interno di un'organizzazione, crea un progetto (nome + descrizione facoltativa). L'organizzazione ha le schede Progetti, Membri, Ruoli e Impostazioni (Ruoli e Impostazioni compaiono solo se puoi gestirli).
4. Cambia organizzazione o progetto dalla barra in alto; clicca su 🏮 Lantern per tornare indietro.

Ogni progetto ha le schede Editor, Glossario, Importa / Esporta, API, Membri e Attività — più Impostazioni, che vede solo un proprietario.

L'eliminazione di un progetto si trova in quella scheda Impostazioni. È definitiva e porta via tutto: ogni chiave, traduzione, commento, termine di glossario e token API del progetto. Devi digitare il nome del progetto per confermare, e l'eliminazione viene registrata nell'attività dell'organizzazione.

Autenticazione a due fattori (facoltativa). Da Account, attiva l'autenticazione a due fattori: scansiona il QR code con un'app di autenticazione (o incolla la chiave manualmente), conferma un codice a 6 cifre e conserva i 10 codici di backup monouso mostrati una sola volta. Da quel momento l'accesso richiede un codice dalla tua app — oppure uno dei codici di backup se perdi il dispositivo. Puoi rigenerare i codici di backup o disattivare la 2FA da Account (entrambe le operazioni richiedono un codice valido). Il tuo segreto TOTP e i codici di backup non sono mai inclusi in un'esportazione dei dati.

2. Ruoli e permessi#

L'accesso è basato sui permessi. Ogni organizzazione ha tre ruoli integrati; il proprietario ha sempre tutti i permessi e non può essere escluso.

Ruoli personalizzati. Nella scheda Ruoli dell'organizzazione, un proprietario o un admin può definire un ruolo personalizzato come qualsiasi insieme di questi permessi (per esempio un « Revisore » che può modificare e segnare come revisionato ma non creare chiavi), poi assegnarlo a un membro nella scheda Membri. I ruoli personalizzati valgono in tutti i progetti dell'organizzazione, esattamente come quelli integrati.

3. Lingue#

Nella scheda Editor, proprietari e admin aggiungono una lingua tramite il suo codice locale (per esempio en, fr, de-CH) e un nome visualizzato. La prima lingua diventa quella predefinita. I codici locale sono ciò che restituisce l'API e ciò da cui prendono il nome i tuoi file, quindi scegli i codici che la tua applicazione si aspetta. Rimuovi una lingua con la ✕ sul suo chip (questo ne elimina i valori).

4. Chiavi#

Aggiungi una chiave con un namespace facoltativo, un nome e una descrizione facoltativa. Il percorso completo della chiave è namespace.nome (o solo nome senza namespace) — per esempio namespace home + nome title → home.title.

Una chiave viene rifiutata se il suo percorso completo esiste già, anche con una suddivisione diversa (home+title va in conflitto con un semplice home.title). Scegli una sola convenzione.

Usa il campo di ricerca per filtrare le chiavi. Proprietari e admin possono modificare una chiave (rinominarla, cambiarne il namespace o la descrizione) con la ✎ accanto — la modifica conserva tutte le traduzioni, gli stati e i commenti esistenti — oppure eliminarla con la ✕.

5. La griglia dell'editor#

Le righe sono le chiavi, le colonne le lingue. Digita un valore in una cella: viene salvato automaticamente quando esci dal campo (solo se è cambiato).

• Pallino di stato accanto a ogni cella: grigio = non tradotto (vuoto), verde = tradotto, blu = revisionato. Clicca su un pallino verde per segnare il valore come revisionato; clicca di nuovo per annullare. Modificare un valore revisionato lo riporta a « tradotto ».
• Le barre di completamento in alto mostrano l'avanzamento di ogni lingua (valori compilati / chiavi totali) e si aggiornano in tempo reale mentre digiti.
• La casella Da revisionare filtra le chiavi con valori tradotti ma non ancora revisionati — comoda per una passata di revisione.
• Assegnatari — assegna uno o più membri a una chiave per rendere chiara la responsabilità (chi la traduce o la revisiona). Clicca sulla pila di avatar (o sul ➕ di una chiave non assegnata) per scegliere i membri da un elenco; i loro avatar compaiono sulla chiave nella griglia e nella vista di dettaglio. Sono assegnabili solo i membri che hanno accesso al progetto, e ogni assegnatario riceve una notifica nell'applicazione. Assegnare richiede il permesso assegnare chiavi (proprietari, admin e membri per impostazione predefinita). Le modifiche compaiono nel feed delle attività sotto Assegnazioni.

6. Commenti#

Ogni riga di chiave ha un pulsante 💬 con un contatore. Aprilo per leggere la discussione e aggiungere un commento — utile per dare contesto (« non superare i 20 caratteri », « questa è l'etichetta di un pulsante », ecc.).

7. Glossario#

La scheda Glossario contiene i termini approvati di un progetto — nomi di prodotto, parole del marchio e vocaboli delicati che vuoi tradurre in modo coerente. Per ogni termine puoi aggiungere una descrizione, una traduzione approvata per lingua, contrassegnarlo come da non tradurre (un nome di marchio da mantenere identico) o sensibile alle maiuscole. Chiunque può leggere il glossario; gestirlo richiede il permesso gestire il glossario (proprietari e admin per impostazione predefinita).

Nella vista Focus dell'editor, le parole del testo sorgente che corrispondono a un termine del glossario sono evidenziate — passaci sopra per vedere la traduzione approvata nella lingua verso cui stai traducendo, o una nota « da non tradurre ». Le modifiche ai termini compaiono nel feed delle attività.

8. Membri e ruoli#

I membri si gestiscono a livello di organizzazione (scheda Membri dell'organizzazione), non per progetto: un membro può raggiungere tutti i progetti dell'organizzazione. Il proprietario (o chiunque abbia il permesso gestire i membri) può invitare qualcuno via email con un ruolo a scelta (Admin, Membro o qualsiasi ruolo personalizzato). La persona invitata riceve un link via email e entra quando accetta — puoi invitare anche un indirizzo che non ha ancora un account Lantern (si registra, conferma l'email, poi accetta). Gli inviti in sospeso sono elencati nella scheda Membri, dove puoi inviarli di nuovo o revocarli; una volta entrata, puoi cambiarne il ruolo o rimuoverla. Costruisci i ruoli personalizzati nella scheda Ruoli dell'organizzazione (vedi §2).

9. Importa / Esporta#

Nella scheda Importa / Esporta:

• Importazione
  • JSON — gestisce sia il formato piatto {"home.title": "..."} sia quello annidato {"home": {"title": "..."}}. Importa più lingue in una volta: seleziona più file (la lingua viene letta da ciascun nome di file — en.json, de-CH.json — e mostrata perché tu possa correggerla), oppure carica un singolo oggetto indicizzato per lingua ({"en": {…}, "fr": {…}}) e spunta indicizzato per lingua.
  • CSV / XLSX — una colonna key più una colonna per lingua; unisce tutte le lingue.
  • Tutti i formati uniscono (i valori esistenti vengono aggiornati, le nuove chiavi aggiunte), creano automaticamente le lingue mancanti (richiede il permesso aggiungere / eliminare lingue), saltano le celle vuote (per non cancellare valori) e registrano una sola voce nel feed delle attività.
• Esportazione
  • JSON per una lingua (piatto o annidato), oppure CSV / XLSX per tutte.

L'importazione è il modo massivo per far entrare le chiavi; l'API (INTEGRATION.it.md) è il modo automatico per far uscire le traduzioni verso le tue applicazioni.

10. Token API#

Nella scheda API, proprietari e admin creano un token, limitato a quel progetto. La stringa del token viene mostrata una sola volta — copiala subito. L'elenco mostra nome, prefisso e ultimo utilizzo di ogni token; revoca un token per interrompere l'accesso immediatamente.

I token sono in sola lettura per impostazione predefinita. Espandi Permessi di scrittura durante la creazione per concedere ambiti (per esempio creare chiavi, modificare traduzioni) così che un agente IA o uno script di CI possa inviare chiavi e valori — vedi la sezione sulla scrittura in INTEGRATION.it.md.