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:
npm install -g lingo.devInstallation prüfen#
Prüfen Sie, ob die CLI korrekt installiert ist:
lingo --versionDie Ausgabe sollte in etwa so aussehen:
lingo.dev v0.133.9
Node.js v20.10.0Projekt initialisieren#
Wechseln Sie in Ihr Projektverzeichnis und führen Sie aus:
cd my-project
lingo initMit diesem interaktiven Befehl können Sie:
- Ihr Konto verbinden – Authentifizieren Sie sich mit Ihrem API-Schlüssel
- Ein Projekt auswählen – Wählen Sie ein bestehendes Projekt aus oder erstellen Sie ein neues
- Sprachen konfigurieren – Wählen Sie die Sprachen aus, die Sie unterstützen möchten
- 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:
{
"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:
lingo runDie 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:
lingo run --watchDrücken Sie Ctrl+C, um den Watch-Modus zu beenden.
Hilfe#
Sie brauchen Unterstützung?
# Show help for all commands
lingo --help
# Show help for a specific command
lingo run --helpTreten Sie unserer Discord-Community bei und erhalten Sie Support in Echtzeit!
