Das Übersetzen Ihrer Next.js-App ins Französische 🇫🇷, Spanische 🇪🇸, Japanische 🇯🇵 oder in eine andere Sprache ist mühsam und zeitaufwendig.

Locadex ist ein KI-Agent, der 100 % der Internationalisierung (i18n) für Sie übernimmt. Die Installation dauert 5 Minuten.

Locadex:

• Konfiguriert Ihr Projekt für die Verwendung der i18n-Bibliothek gt-next
• Passt Ihre React-Komponenten und Texte an, um mehrsprachige Inhalte zu unterstützen
• Übersetzt Ihre App in so viele Sprachen, wie Sie benötigen
• Internationalisiert und übersetzt fortlaufend, sobald Sie neue Inhalte pushen

Einrichtungsablauf

Schritt 1: Beim General Translation Dashboard anmelden

Gehen Sie zu Ihrem Dashboard und melden Sie sich bei Ihrem Konto an.

Schritt 2: GitHub verbinden

1. Navigiere im Dashboard zum Bereich „GitHub-Integration“
2. Klicke auf „GitHub verbinden“, um dein GitHub-Konto zu verknüpfen
3. Du wirst zu GitHub weitergeleitet, um die Verbindung zu autorisieren

Schritt 3: GitHub-App installieren

1. Nachdem Sie GitHub verbunden haben, werden Sie zur Installation der Locadex-GitHub-App weitergeleitet.
2. Wählen Sie aus, auf welche Repositories Locadex zugreifen darf:
   • Auf allen Repositories installieren oder
   • Bestimmte Repositories auswählen
3. Klicken Sie auf „Install“, um die Installation der GitHub-App abzuschließen.

Schritt 4: Repository mit Projekt verknüpfen

1. Gehen Sie zurück zu Ihrem GT-Dashboard und wählen Sie das Repository aus, das Sie internationalisieren möchten.
2. Dadurch wird Ihr Repo mit Ihren Übersetzungseinstellungen und Zielsprachen verbunden.
3. Pro Projekt kann nur ein Repository verknüpft werden, aber Sie können mehrere Projekte erstellen, jeweils mit einem anderen Repository.

Schritt 5: Einstellungen konfigurieren

Auf dem Konfigurationsbildschirm richten Sie Folgendes ein:

• Zielsprachen: Wählen Sie aus, in welche locales übersetzt werden soll.

Schritt 6: Installation abschließen

1. Überprüfen Sie Ihre Konfiguration
2. Klicken Sie auf „Install“, um Locadex für Ihr Repository zu aktivieren
3. Sie werden zu einer Übersichtsseite weitergeleitet, die Ihr verbundenes GitHub-Repository anzeigt

Wie geht es weiter

Erste Einrichtung

Sobald du die Installation abgeschlossen hast:

1. Sofortige PR-Erstellung: Locadex erstellt einen Pull Request gegen deinen Main-Branch
2. Vollständige Einrichtung: Dieser PR führt den vollständigen Locadex-Setup-Befehl aus, der:
   • die GT-Bibliotheken installiert
   • dein Projekt für Internationalisierung konfiguriert
   • die Übersetzungsinfrastruktur einrichtet
3. Review & Merge: Prüfe den PR und merge ihn, um dein i18n-Setup abzuschließen

Kontinuierliche Internationalisierung

Nachdem das initiale Setup gemergt wurde:

1. Locadex überwacht Ihren Main-Branch oder einen angegebenen Branch auf Pull Requests
2. Wenn Sie neuen Code mit übersetzbarem Inhalt pushen, warten Sie, bis Locadex seinen Commit zum PR hinzufügt
3. Sobald Locadex in den PR committet, kann sicher gemergt werden — Ihr neuer Code ist internationalisiert
4. Ihre App bleibt ohne manuelles Eingreifen übersetzt

Überwachung Ihres Repositories

Dashboard-Status

Im Dashboard können Sie Folgendes überwachen:

• Repository-Status: Anzeige für die aktive Überwachung
• Konfiguration: Aktuelle Einstellungen und Zielsprachen

GitHub-Integration

• Statusprüfungen: Locadex fügt Pull Requests Statusaktualisierungen hinzu
• Prüfläufe: GitHub zeigt den Verarbeitungsstatus von Locadex

Fehlerbehebung

Häufige Probleme

Locadex erstellt keine PRs

• Prüfen, ob die GitHub-App Zugriff auf das Repository hat
• Prüfen, ob Commits übersetzbare Inhalte enthalten

Erforderliche Konfigurationsänderungen

• Branch-Einstellungen im GT-Dashboard aktualisieren
• Änderungen gelten für neue Commits nach dem Update

Unterstützte Frameworks

Derzeit unterstützt Locadex nur Next.js-Apps mit dem App Router.