Schnellstart

Zuletzt aktualisiert: letztes Quartal · 2 Min. Lesezeit

Veraltet

Diese Doku behandelt die alte CLI (v0). Die aktuelle CLI ist v1. Zur aktuellen CLI-Doku

Starten Sie mit der CLI in weniger als 5 Minuten durch.

Voraussetzungen

Stellen Sie sicher, dass Node.js 18.0 oder höher installiert ist. Führen Sie node --version aus, um das zu überprüfen.

Installation#

Installieren Sie die CLI global mit dem Paketmanager Ihrer Wahl:

bash
npm install -g lingo.dev

Installation prüfen#

Prüfen Sie, ob die CLI korrekt installiert ist:

bash
lingo --version

Die Ausgabe sollte in etwa so aussehen:

plaintext
lingo.dev v0.133.9
Node.js v20.10.0

Projekt initialisieren#

Wechseln Sie in Ihr Projektverzeichnis und führen Sie aus:

bash
cd my-project
lingo init

Mit diesem interaktiven Befehl können Sie:

  1. Ihr Konto verbinden – Authentifizieren Sie sich mit Ihrem API-Schlüssel
  2. Ein Projekt auswählen – Wählen Sie ein bestehendes Projekt aus oder erstellen Sie ein neues
  3. Sprachen konfigurieren – Wählen Sie die Sprachen aus, die Sie unterstützen möchten
  4. Die Dateistruktur einrichten – Legen Sie fest, wo Ihre Übersetzungsdateien gespeichert werden

Konfiguration erstellt

Die CLI erstellt eine i18n.json-Datei mit Ihren Einstellungen. Sie können diese Datei später jederzeit anpassen.

Ihre erste Übersetzung#

Erstellen Sie eine einfache Übersetzungsdatei:

json
{
  "welcome": {
    "title": "Welcome to Lingo.dev",
    "subtitle": "The Localization Engineering Platform"
  },
  "auth": {
    "login": "Log in",
    "logout": "Log out"
  }
}

Übersetzungen ausführen#

Übersetzen Sie Ihre Inhalte in alle konfigurierten Zielsprachen:

bash
lingo run

Die CLI übernimmt dabei Folgendes:

  • ✅ Ihre Quelldateien erkennen
  • ✅ Ein Delta mit der Lockdatei berechnen
  • ✅ Geänderte Inhalte an Ihr Übersetzungs-Backend senden
  • ✅ Übersetzungen auf die Festplatte schreiben

Watch-Modus (Entwicklung)#

Aktivieren Sie im aktiven Entwicklungsprozess den Watch-Modus, damit bei Änderungen an Quelldateien automatisch neu übersetzt wird:

bash
lingo run --watch

Drücken Sie Ctrl+C, um den Watch-Modus zu beenden.

Hilfe#

Sie brauchen Unterstützung?

bash
# Show help for all commands
lingo --help

# Show help for a specific command
lingo run --help

Treten Sie unserer Discord-Community bei und erhalten Sie Support in Echtzeit!

Nächste Schritte#