How do I create a Pull Request (PR)?

Go to the Download page on Lokalise, select the relevant options, and trigger GitHub by ticking the GitHub checkbox. Then, click Build only. In this case, the PR will be created in your repo. If you have more than one repo linked to the project, select the appropriate one using the Filter repositories field.

I have updated strings in my GitHub file, but the values are not updating on Lokalise. What am I doing wrong?

Make sure that the ''Replace modified values'' option is enabled in the pull settings. You can read more about all the upload parameters in the Upload files article.

How do I make sure the file structure in PR matches the file structure in my repository?

To match the right structure of your files, you have to name files properly and select the right options when creating a PR. This is easy when enabling "Include full path in the filenames" in the general GitHub app settings. Then during download, select "Multiple files per language (use assigned filenames)", and modify or delete the prefix. Please check the Filenames article for reference.

I have key names that repeat across files. How can I support repeated key names in Lokalise?

To support repeated key names in Lokalise, make sure that the "Differentiate keys by file" option is enabled in the pull settings.

Why does Lokalise request access to all my repositories?

Lokalise requests access to all repositories to list them during setup so you can specify which repository to connect to Lokalise. There is no more restrictive OAuth scope for this purpose. Once the app is configured, Lokalise only works with the repository you selected. Admin scopes are not required.

What actions does the app use the OAuth token for?

Lokalise only creates merge requests and fetches the files you selected during setup. The Lokalise GitHub app does not alter the repo's settings.

Is there any way to restrict the app's permissions?

GitHub user permission scopes limit access for OAuth tokens. The Lokalise app's access is limited by the permissions of the user who configures the integration. If you need to limit the integration's access to a specific repository, you can do so by limiting the permissions of the authorizing user's GitHub account. GitHub users can always revoke a token or edit the token scopes for more control over what the integration can do.

How is my access token stored?

Your token is stored in an encrypted form in our database. The database itself is stored on dedicated servers at the Hetzner Online provider, which ensures top-level physical security. You can learn more on the Hetzner website. We take regular snapshots of the database and store them in a 256-bit encrypted Amazon S3 bucket for 30 days.

Can I use GitHub Actions in Lokalise?

Yes. You can manipulate any object or data in your Lokalise workspace that's accessed using the Lokalise CLI or API with GitHub Actions. Learn more about how to use Github Actions in Lokalise.

Native GitHub-Integration

Automatisiere GitHub-Übersetzungen für mühelose Lokalisierung

Sprachdateien können automatisch zwischen GitHub und Lokalise ausgetauscht werden. Du kannst also Inhalte importieren und exportieren, sobald sie fertig sind. So bleibt deine Software in jeder Sprache aktuell.

GitHub mit Lokalise verbinden

So verbindest du GitHub und Lokalise

Lokalise – beliebt bei Tech-Teams von mehr als 3.000 Unternehmen weltweit

„Unsere Entwickler müssen keine Zeit mehr damit verbringen, Übersetzungen hochzuladen und wieder abzurufen – das ist großartig.“

Kate Cobb

Senior Full Stack Engineer

Übersetzungsdateien zentral verwalten mit GitHub und Lokalise

Übersetze auf GitHub gehostete Sprachdateien mit nur wenigen Klicks.

Automatische Key-Eingabe und -Aktualisierung

Richte automatische Pulls ein, um Sprachdateien zwischen GitHub und deinem Lokalise-Projekt auszutauschen.

Organisierte Lokalisierung mit GitHub

Du kannst immer sicher sein, dass du mit den neusten Dateiversionen arbeitest, und so Bugs und Fehler vermeiden.

Keine verpassten Übersetzungsupdates mehr

Steuere mit Webhooks, wann und wie du Informationen austauschst, und behalte Lokalisierungsaufgaben im Blick.

Weniger Zeit für Dateiaktualisierung

Verabschiede dich von zeitaufwendigen manuellen Lokalisierungsprozessen, die zu fehlenden Dateien, Bugs und Verzögerungen führen.

GitHub-Actions von Lokalise

Nutze unsere Open-Source-GitHub-Actions – eine Drop-in-Lösung mit minimaler Konfiguration (~5 Zeilen Code). Damit kannst du Im- und Exporte planen und sogar andere Lösungen einbinden (zum Beispiel, um Pull Requests automatisch mit aktualisierten Übersetzungen zu mergen).

GitHub-Actions-Dokumentation

⚙️ Einrichtung von
Lokalise und GitHub

Öffne das „Apps“-Dashboard in Lokalise.

Suche nach GitHub und klicke auf „Installieren“.

Klicke auf „Verbinden“ und gewähre Lokalise Zugriffsrechte.

Gib den Repository-Namen (mit dem Namen deiner Organisation als Präfix) und den Branch ein, von dem du pullen möchtest.

🔧 Voraussetzungen

Du musst ein Web- und Mobile-Projekt in Lokalise erstellen.

Dokumentation anzeigen

Übersetzungsmanagement mit GitHub und Lokalise

Pull

Wähle deine Ausgangsdateien auf GitHub aus und importiere sie in Lokalise.

Übersetzen

Nutze die integrierte KI-Übersetzung, um in wenigen Minuten mehrsprachige Inhalte zu erstellen.

Exportieren

Öffne in Lokalise den Tab „Download“, wähle dein Dateiformat und übertrage die Übersetzungen nach GitHub.

„Unsere Entwickler weigern sich, mit anderer Lokalisierungssoftware zu arbeiten – sie bestehen auf Lokalise. Es spart ihnen Zeit und Mühe und beseitigt viele Probleme.“

Gaia Castronovo

Education Localization Specialist

„Einer der Vorteile ist, dass dieser Prozess nicht viel manuelle Arbeit erfordert. Wir wollten, dass Entwicklung und Veröffentlichung unserer App reibungslos und nahtlos ablaufen. Mit Lokalise ist das machbar.“

Yoni Lindenfeld

Mitbegründer und VP Engineering

„Unsere Entwickler weigern sich, mit anderer Lokalisierungssoftware zu arbeiten – sie bestehen auf Lokalise. Es spart ihnen Zeit und Mühe und beseitigt viele Probleme.“

Gaia Castronovo

Education Localization Specialist

Yoni Lindenfeld

Mitbegründer und VP Engineering

💡 So funktioniert die Einrichtung automatischer GitHub-Übersetzungen

Richte bei GitHub einen Webhook ein, um Inhalte in Lokalise zu übernehmen, sobald du Änderungen in GitHub pushst. Gehe in GitHub zu Settings > Webhooks > Add webhook. Kopiere die Auto-pull-URL und das Auto-pull-Secret von Lokalise nach GitHub. Aktiviere zum Schluss den Auslöser für Push-Ereignisse.

GitHub-Übersetzungen in Minutenschnelle

Tausche Übersetzungsdateien automatisch zwischen GitHub und Lokalise aus.

GitHub mit Lokalise verbinden Kostenlos bei Lokalise registrieren

FAQ

Wie erstelle ich einen Pull Request (PR)?

Öffne die Download-Seite in Lokalise, wähle die gewünschten Optionen aus und aktiviere GitHub, indem du das Kontrollkästchen anklickst. Klicke dann auf „Nur Build“. In diesem Fall wird der PR in deinem Repo erstellt. Wenn du mehr als ein Repo mit dem Projekt verknüpft hast, wähle das passende über das Feld „Repositorys filtern“ aus.

Ich habe Texte in meiner GitHub-Datei geändert, aber die Werte werden in Lokalise nicht aktualisiert. Was mache ich falsch?

Vergewissere dich, dass in den Pull-Einstellungen die Option „Geänderte Werte ersetzen“ aktiviert ist. Weitere Infos zu den verschiedenen Upload-Parametern findest du im Artikel Dateien hochladen.

Wie stelle ich sicher, dass die Dateistruktur im PR mit der Dateistruktur in meinem Repository übereinstimmt?

Damit die Struktur deiner Dateien korrekt übereinstimmt, musst du die Dateien richtig benennen und beim Erstellen eines PR die passenden Optionen auswählen. Das ist ganz einfach, wenn du in den allgemeinen Einstellungen der GitHub-App „Vollständigen Pfad in Dateinamen einfügen“ aktivierst. Wähle dann beim Herunterladen „Mehrere Dateien pro Sprache (zugewiesene Dateinamen verwenden)“ und passe das Präfix an oder entferne es. Lies dazu auch den Artikel zu Dateinamen.

Ich habe Key-Bezeichnungen, die sich über mehrere Dateien hinweg wiederholen. Wie kann ich wiederholte Key-Bezeichnungen in Lokalise unterstützen?

Um wiederholte Key-Bezeichnungen in Lokalise zu unterstützen, muss in den Pull-Einstellungen die Option „Key nach Datei unterscheiden“ aktiviert sein.

Warum fordert Lokalise Zugriff auf alle meine Repositorys an?

Lokalise fordert Zugriff auf alle Repositorys an, um sie bei der Einrichtung aufzulisten, damit du angeben kannst, welches Repository mit Lokalise verbunden werden soll. Für diesen Zweck gibt es keinen restriktiveren OAuth-Geltungsbereich. Sobald die App konfiguriert ist, arbeitet Lokalise nur mit deinem gewählten Repository. Admin-Berechtigungen sind nicht erforderlich.

Für welche Aktionen verwendet die App das OAuth-Token?

Lokalise erstellt nur Merge Requests und ruft die Dateien ab, die du bei der Einrichtung ausgewählt hast. Die Lokalise-GitHub-App ändert die Einstellungen des Repos nicht.

Gibt es eine Möglichkeit, die Berechtigungen der App einzuschränken?

GitHub-Nutzerberechtigungen begrenzen den Zugriff für OAuth-Tokens. Der Zugriff der Lokalise-App ist durch die Berechtigungen des Nutzers beschränkt, der die Integration konfiguriert. Wenn du den Zugriff der Integration auf ein bestimmtes Repository beschränken musst, kannst du dazu die Berechtigungen des GitHub-Kontos des autorisierenden Nutzers einschränken.

GitHub-Nutzer können ein Token jederzeit widerrufen oder die Token-Scopes bearbeiten, um die Möglichkeiten der Integration besser zu kontrollieren.

Wie wird mein Zugriffstoken gespeichert?

Dein Token wird in verschlüsselter Form in unserer Datenbank gespeichert. Die Datenbank selbst wird auf dedizierten Servern beim Anbieter Hetzner Online gespeichert, der höchste physische Sicherheit gewährleistet. Mehr dazu findest du auf der Hetzner-Website.

Wir erstellen regelmäßig Snapshots der Datenbank und speichern sie für 30 Tage in einem 256-Bit-verschlüsselten Amazon-S3-Bucket.

Kann ich GitHub-Actions in Lokalise verwenden?

Ja. Du kannst mit GitHub Actions alle Objekte und Daten in deinem Lokalise-Workspace bearbeiten, auf die du über die Lokalise-CLI oder die API zugreifst. Erfahre mehr darüber, wie du GitHub Actions in Lokalise nutzen kannst.

Automatisiere GitHub-Übersetzungen für mühelose Lokalisierung

„Unsere Entwickler müssen keine Zeit mehr damit verbringen, Übersetzungen hochzuladen und wieder abzurufen – das ist großartig.“

Übersetzungsdateien zentral verwalten mit GitHub und Lokalise