Lantern verwenden

Lantern ist ein Lokalisierungs-Manager: Eine Organisation enthält Projekte, ein Projekt enthält Übersetzungs-Schlüssel, und jeder Schlüssel hat einen Wert in jeder Sprache. Sie bearbeiten die Werte in einem Raster, arbeiten zusammen, und Ihre Anwendungen holen sich das Ergebnis über die API (und schreiben es optional zurück).

Live-Instanz: https://lantern.abyss-inn.ch

1. Konto, Organisationen und Projekte#

1. Registrieren Sie sich mit Name, E-Mail-Adresse und einem Passwort (≥ 8 Zeichen) und melden Sie sich an. Wir senden Ihnen einen Bestätigungslink: Solange Sie Ihre Adresse nicht bestätigt haben, erinnert Sie ein Banner daran, und Sie können keine Organisationen erstellen oder ihnen beitreten. Nutzen Sie Erneut senden im Banner, falls die E-Mail nicht ankommt.
2. Erstellen Sie eine Organisation (oder lassen Sie sich einer hinzufügen). Wer sie erstellt, ist ihr Eigentümer. Die Zusammenarbeit findet auf Organisationsebene statt — Mitglieder haben Zugriff auf jedes Projekt der Organisation.
3. Erstellen Sie innerhalb einer Organisation ein Projekt (Name + optionale Beschreibung). Die Organisation hat die Tabs Projekte, Mitglieder, Rollen und Einstellungen (Rollen/Einstellungen erscheinen nur, wenn Sie sie verwalten dürfen).
4. Wechseln Sie Organisationen und Projekte über die obere Leiste; klicken Sie auf 🏮 Lantern, um zurückzugehen.

Jedes Projekt hat die Tabs Editor, Glossar, Import / Export, API, Mitglieder und Aktivität — dazu Einstellungen, das nur ein Eigentümer sieht.

Das Löschen eines Projekts liegt auf diesem Tab Einstellungen. Es ist endgültig und nimmt alles mit: jeden Schlüssel, jede Übersetzung, jeden Kommentar, jeden Glossarbegriff und jedes API-Token des Projekts. Sie müssen zur Bestätigung den Projektnamen eingeben, und die Löschung wird in der Aktivität der Organisation festgehalten.

Zwei-Faktor-Authentifizierung (optional). Aktivieren Sie unter Konto die Zwei-Faktor-Authentifizierung: Scannen Sie den QR-Code mit einer Authenticator-App (oder geben Sie den Schlüssel manuell ein), bestätigen Sie einen 6-stelligen Code und sichern Sie die 10 einmalig verwendbaren Backup-Codes, die nur einmal angezeigt werden. Danach fragt die Anmeldung nach einem Code aus Ihrer App — oder nach einem Backup-Code, falls Sie Ihr Gerät verlieren. Sie können die Backup-Codes neu erzeugen oder 2FA im Konto deaktivieren (beides erfordert einen aktuellen Code). Ihr TOTP-Geheimnis und Ihre Backup-Codes sind nie Teil eines Datenexports.

2. Rollen und Berechtigungen#

Der Zugriff ist berechtigungsbasiert. Jede Organisation hat drei eingebaute Rollen; der Eigentümer hat immer alle Berechtigungen und kann sich nicht aussperren.

Eigene Rollen. Im Tab Rollen der Organisation kann ein Eigentümer oder Admin eine eigene Rolle als beliebige Kombination dieser Berechtigungen definieren (z. B. eine „Prüferin“, die bearbeiten und als geprüft markieren, aber keine Schlüssel erstellen darf) und sie im Tab Mitglieder zuweisen. Eigene Rollen gelten in jedem Projekt der Organisation, genau wie die eingebauten.

3. Sprachen#

Im Tab Editor fügen Eigentümer und Admins eine Sprache über ihren Locale-Code (z. B. en, fr, de-CH) und einen Anzeigenamen hinzu. Die erste Sprache wird zur Standardsprache. Die Locale-Codes sind das, was die API zurückgibt und wonach Ihre Dateien benannt werden — wählen Sie also die Codes, die Ihre Anwendung erwartet. Entfernen Sie eine Sprache über das ✕ auf ihrem Chip (das löscht ihre Werte).

4. Schlüssel#

Legen Sie einen Schlüssel mit optionalem Namensraum, einem Namen und einer optionalen Beschreibung an. Der vollständige Pfad des Schlüssels lautet namensraum.name (oder nur name ohne Namensraum) — z. B. Namensraum home + Name title → home.title.

Ein Schlüssel wird abgelehnt, wenn sein vollständiger Pfad bereits existiert, auch bei anderer Aufteilung (home+title kollidiert mit einem einfachen home.title). Entscheiden Sie sich für eine Konvention.

Nutzen Sie das Suchfeld, um Schlüssel zu filtern. Eigentümer und Admins können einen Schlüssel über das ✎ daneben bearbeiten (umbenennen, Namensraum oder Beschreibung ändern) — dabei bleiben alle vorhandenen Übersetzungen, Status und Kommentare erhalten — oder ihn über das ✕ löschen.

5. Das Editor-Raster#

Zeilen sind Schlüssel, Spalten sind Sprachen. Tippen Sie einen Wert in eine Zelle — er wird automatisch gespeichert, sobald Sie das Feld verlassen (nur wenn er sich geändert hat).

• Statuspunkt neben jeder Zelle: grau = nicht übersetzt (leer), grün = übersetzt, blau = geprüft. Klicken Sie auf einen grünen Punkt, um den Wert als geprüft zu markieren; ein weiterer Klick hebt das auf. Wird ein geprüfter Wert bearbeitet, fällt er auf „übersetzt“ zurück.
• Die Fortschrittsbalken oben zeigen den Stand jeder Sprache (gefüllte Werte / Schlüssel gesamt) und aktualisieren sich live beim Tippen.
• Das Kästchen Zu prüfen filtert auf Schlüssel mit übersetzten, aber noch nicht geprüften Werten — praktisch für einen Prüfdurchgang.
• Zuständige — weisen Sie einem Schlüssel ein oder mehrere Mitglieder zu, damit die Verantwortung klar ist (wer übersetzt bzw. prüft). Klicken Sie auf den Avatar-Stapel (oder das ➕ eines nicht zugewiesenen Schlüssels), um Mitglieder aus einer Liste zu wählen; ihre Avatare erscheinen am Schlüssel im Raster und in der Detailansicht. Zuweisbar sind nur Mitglieder mit Zugriff auf das Projekt, und jede zugewiesene Person erhält eine In-App-Benachrichtigung. Das Zuweisen erfordert die Berechtigung Schlüssel zuweisen (standardmäßig Eigentümer, Admins und Mitglieder). Änderungen erscheinen im Aktivitäts-Feed unter Zuweisungen.

6. Kommentare#

Jede Schlüsselzeile hat einen 💬-Button mit Zähler. Öffnen Sie ihn, um den Verlauf zu lesen und einen Kommentar zu schreiben — nützlich für Kontext („unter 20 Zeichen halten“, „das ist eine Button-Beschriftung“ usw.).

7. Glossar#

Der Tab Glossar enthält die freigegebenen Begriffe eines Projekts — Produktnamen, Markenbegriffe und kniffliges Vokabular, das einheitlich übersetzt werden soll. Zu jedem Begriff können Sie eine Beschreibung und eine freigegebene Übersetzung pro Sprache hinterlegen, ihn als nicht übersetzen (ein Markenname, der wörtlich bleibt) oder Groß-/Kleinschreibung beachten markieren. Lesen darf das Glossar jede Person; es zu verwalten erfordert die Berechtigung Glossar verwalten (standardmäßig Eigentümer und Admins).

In der Fokus-Ansicht des Editors werden Wörter im Ausgangstext hervorgehoben, die einem Glossarbegriff entsprechen — fahren Sie mit der Maus darüber, um die freigegebene Übersetzung für die Zielsprache oder einen „nicht übersetzen“-Hinweis zu sehen. Änderungen an Begriffen erscheinen im Aktivitäts-Feed.

8. Mitglieder und Rollen#

Mitglieder werden auf Organisationsebene verwaltet (Tab Mitglieder der Organisation), nicht pro Projekt — ein Mitglied erreicht jedes Projekt der Organisation. Der Eigentümer (oder jede Person mit der Berechtigung Mitglieder verwalten) kann jemanden per E-Mail einladen und dabei eine Rolle wählen (Admin, Mitglied oder eine beliebige eigene Rolle). Die eingeladene Person erhält einen Link per E-Mail und tritt bei, sobald sie annimmt — Sie können auch eine Adresse einladen, die noch kein Lantern-Konto hat (sie registriert sich, bestätigt ihre E-Mail und nimmt dann an). Offene Einladungen stehen im Tab Mitglieder, wo Sie sie erneut senden oder widerrufen können; nach dem Beitritt können Sie die Rolle ändern oder die Person entfernen. Eigene Rollen bauen Sie im Tab Rollen der Organisation (siehe §2).

9. Import / Export#

Im Tab Import / Export:

• Import
  • JSON — verarbeitet flaches {"home.title": "..."} und verschachteltes {"home": {"title": "..."}}. Importieren Sie mehrere Locales auf einmal: Wählen Sie mehrere Dateien aus (die Locale wird aus dem jeweiligen Dateinamen gelesen — en.json, de-CH.json — und zum Überschreiben angezeigt), oder laden Sie ein einzelnes, nach Locale geschlüsseltes Objekt hoch ({"en": {…}, "fr": {…}}) und haken Sie nach Locale geschlüsselt an.
  • CSV / XLSX — eine key-Spalte plus eine Spalte je Locale; wird über alle Sprachen hinweg zusammengeführt.
  • Alle Formate führen zusammen (bestehende Werte werden aktualisiert, neue Schlüssel ergänzt), legen fehlende Sprachen automatisch an (erfordert die Berechtigung Sprachen hinzufügen / löschen), überspringen leere Zellen (löschen also keine Werte) und schreiben einen einzigen Eintrag in den Aktivitäts-Feed.
• Export
  • JSON für eine Sprache (flach oder verschachtelt), oder CSV / XLSX über alle.

Der Import ist der Massenweg, um Schlüssel hineinzubekommen; die API (INTEGRATION.de.md) ist der automatisierte Weg, Übersetzungen in Ihre Anwendungen hinauszubekommen.

10. API-Token#

Im Tab API erstellen Eigentümer und Admins einen Token, der auf dieses Projekt beschränkt ist. Die Token-Zeichenkette wird nur einmal angezeigt — kopieren Sie sie sofort. Die Liste zeigt Name, Präfix und letzte Verwendung jedes Tokens; widerrufen Sie einen Token, um den Zugriff sofort zu kappen.

Token sind standardmäßig schreibgeschützt. Klappen Sie beim Erstellen Schreibberechtigungen auf, um Scopes zu vergeben (z. B. Schlüssel erstellen, Übersetzungen bearbeiten), damit ein KI-Agent oder ein CI-Skript Schlüssel und Werte zurückschreiben kann — siehe den Schreib-Abschnitt in INTEGRATION.de.md.