> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/de/wissensdatenbank/044-github-synchronization.md). # GitHub-Synchronisierung **GitHub-Synchronisierung** ist eine [Premiumfunktion](/latex/de/wissensdatenbank/120-overleaf-premium-features.md). Die Premiumfunktionen von Overleaf stehen Teilnehmern in [Overleaf Commons](https://www.overleaf.com/for/universities), Mitgliedern von Gruppenabonnements [und Inhabern einzelner](https://www.overleaf.com/for/groups), sowie [und Inhabern einzelner](https://www.overleaf.com/user/subscription/plans). Zusammenfassung Die GitHub-Synchronisierungsfunktion ermöglicht es Ihnen, Ihre Overleaf-Projekte direkt mit einem GitHub-Repository zu verknüpfen, das als entferntes Repository für Ihr Overleaf-Projekt dient, und bietet eine Möglichkeit, Änderungen zwischen beiden zu übertragen. Die GitHub-Synchronisierung kann nur auf [GitHub.com](https://www.github.com) und kann nicht verwendet werden, um sich mit anderen GitHub-Enterprise-Installationen zu verbinden. Sie können ein Overleaf-Projekt mit einem GitHub-Repository synchronisieren, indem Sie entweder ein neues Overleaf-Projekt aus einem bestehenden GitHub-Repository erstellen oder ein neues GitHub-Repository aus einem bestehenden Overleaf-Projekt erstellen. Es ist nicht möglich, ein bestehendes Overleaf-Projekt mit einem bestehenden GitHub-Repository zu synchronisieren. * Die GitHub-Synchronisierung wird aktiviert, indem Sie Ihr GitHub-Konto mit Ihrem Overleaf-Konto verknüpfen * Neue Projekte können aus bestehenden GitHub-Repositories erstellt werden * Repositories können in GitHub auf Grundlage bestehender Overleaf-Projekte erstellt werden * Verknüpfte Projekte und Repositories werden mithilfe des **GitHub** Option im Projekt **Menü** ### Verknüpfung Ihres Overleaf-Kontos mit Ihrem GitHub-Konto Um die GitHub-Synchronisierungsfunktion zu verwenden, müssen Sie Ihr Overleaf-Konto mit Ihrem GitHub-Konto verknüpfen. Dies können Sie in Ihrem Overleaf [Kontoeinstellungen](https://www.overleaf.com/user/settings). Bitte beachten Sie, dass die Möglichkeit von Overleaf, sich mit bestimmten Repositories oder Organisationen zu verbinden, die mit Ihrem Konto verknüpft sind, von den in GitHub konfigurierten Berechtigungseinstellungen abhängen kann. ### Erstellen eines neuen Overleaf-Projekts aus einem GitHub-Repository Im Menü „Neues Projekt“ können Sie die GitHub-Option auswählen. Dadurch wird Ihnen eine Liste von Repositories angezeigt, die für Overleaf über Ihr GitHub-Konto sichtbar sind, basierend auf Ihren GitHub-Berechtigungseinstellungen. ![Neues GitHub.png](/files/f7b03a9310e6b8d6d5d987c0c5e981021064aac1) Einige Dinge, die beim Erstellen eines neuen Overleaf-Projekts aus einem bestehenden GitHub-Repository zu beachten sind. * Es gelten Größenbeschränkungen für Overleaf-Projekte, die verhindern können, dass größere GitHub-Repositories zum Erstellen eines Projekts verwendet werden. Bitte siehe [dieser Seite](/latex/de/wissensdatenbank/119-overleaf-plan-limits.md) für einen Überblick über die Beschränkungen hinsichtlich Größe und Anzahl der Dateien in einem Overleaf-Projekt. * Overleaf-Projekte unterstützen keine Git-Submodule oder Git LFS. ### Erstellen eines neuen GitHub-Repositorys aus einem Overleaf-Projekt Im Menü „Overleaf-Projekt“ können Sie GitHub als eine der Synchronisierungsoptionen auswählen. Dadurch erhalten Sie einen Dialog, in dem Sie den Namen eines neuen GitHub-Repositories angeben können, mit dem Ihr Overleaf-Projekt synchronisiert werden soll. ![Projektmenü github.png](/files/607f4e94b1ff16d7ad68739a3b6269ad173d800b) ### Mit GitHub synchronisieren Die Synchronisierung zwischen GitHub und Overleaf erfolgt nicht automatisch; die Synchronisierungsoptionen werden angezeigt, wenn Sie auf **GitHub** Option im Projekt **Menü**. Zu diesem Zeitpunkt meldet das GitHub-Dialogfenster, ob es neue Änderungen zum Abrufen von GitHub gibt. Ihnen wird immer die Möglichkeit geboten, Änderungen zu GitHub zu übertragen (Hinweis: Diese Option wird auch angezeigt, wenn Overleaf und GitHub auf dem neuesten Stand sind). ![Bild des GitHub-Dialogs](/files/38db105101b4b1e2d3e6af198c4866102cfef14f) Commits an GitHub werden erstellt, wenn auf die Schaltfläche „Änderungen von Overleaf zu GitHub übertragen“ geklickt wird. Zu diesem Zeitpunkt kann eine optionale Commit-Nachricht angegeben werden. * Änderungen in der Overleaf-Historie aus GitHub werden als von anonym verfasst angezeigt. * Änderungen in der GitHub-Historie aus Overleaf werden als vom verbundenen Besitzer des GitHub-Kontos verfasst angezeigt. ### Zusammenführungskonflikte lösen Es kann vorkommen, dass Git bei Änderungen sowohl in Overleaf als auch in GitHub nicht herausfinden kann, wie sie automatisch zusammengeführt werden sollen. Wenn beispielsweise Ihr Mitbearbeiter in Overleaf eine Zeile geändert hat und Sie dieselbe Zeile im GitHub-Repository geändert haben, kann Overleaf möglicherweise nicht auswählen, welche Version beibehalten werden soll. Wenn das geschieht, führen wir nicht in Ihren Hauptzweig zusammen, sondern schieben einen neuen Zweig in Ihr Repository. Dieser Zweig hat einen aussagekräftigen Namen (einschließlich Datum und Uhrzeit der Erstellung des Zweigs) und enthält die Version des Dokuments in Overleaf. Wenn Sie versuchen, mit GitHub zu synchronisieren, wird eine Meldung angezeigt, die darauf hinweist, dass ein Zusammenführungskonflikt gelöst werden muss. ![GitHub-Dialog für Zusammenführungskonflikte](/files/da9f33cedca9f11ddfbf17f4903ed81931618b98) Um wieder synchron zu werden, müssen Sie den Overleaf-Zweig in Ihren Hauptzweig (Standardzweig) zusammenführen. Sie können dies auf Ihrem Computer tun, indem Sie beide Zweige abrufen und mit git oder einem anderen Tool zusammenführen und dann das Ergebnis zurück nach GitHub übertragen. Alternativ können Sie die Zusammenführung direkt auf GitHub durchführen, indem Sie aus dem Overleaf-Zweig einen Pull Request erstellen und deren Konfliktlösungsfunktion verwenden. Beide Ansätze werden in der [GitHub-Dokumentation](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts). ### Auf Repositories in Ihren GitHub-Organisationen zugreifen Sie können Overleaf-Projekte mit Repositories synchronisieren, die mit Ihrem verbundenen GitHub-Konto verknüpft sind, und gegebenenfalls auch mit Projekten in GitHub-Organisationen synchronisieren, deren Mitglied Sie sind. Damit die Synchronisierung mit Repositories in Ihren zugeordneten GitHub-Organisationen möglich ist, müssen diese Organisationen die Berechtigung erteilen, über die Overleaf-OAuth-Anwendung auf sie zuzugreifen. * Wenn Sie Mitglied einer Organisation sind, können Sie die beschriebenen Schritte befolgen [hier](https://help.github.com/articles/requesting-organization-approval-for-oauth-apps/) um den Zugriff für die Overleaf-App auf Ihre Organisation anzufordern. * Wenn Sie der Besitzer der Organisation sind, können Sie die beschriebenen Schritte befolgen [hier](https://help.github.com/articles/approving-oauth-apps-for-your-organization/) um die Overleaf-App für die Organisation zu genehmigen. ### Dateibeschränkungen bei der GitHub-Synchronisierung Overleaf-Projekte unterliegen individuellen Größenbeschränkungen sowie Beschränkungen für die Gesamtzahl der Dateien in einem Projekt, wie unter angegeben [hier](/latex/de/wissensdatenbank/119-overleaf-plan-limits.md). Während Git selbst einen einzelnen Commit verarbeiten kann, der Tausende von Dateien ändert, setzt auch die von Overleafs GitHub-Synchronisierungsfunktion verwendete GitHub-API Grenzen für die Anzahl der Dateien, die übertragen oder abgerufen werden können. Es wird empfohlen, die Anzahl der Dateien in einem einzelnen Commit auf unter 100 Dateien und die Gesamtprojektgröße auf weniger als 100 MB zu begrenzen, wenn GitHub-Synchronisierung verwendet wird. Projekte oberhalb dieser Größen können funktionieren, aber wir empfehlen, innerhalb dieser Grenzen zu bleiben, um mögliche Synchronisierungsprobleme zu vermeiden. ### Trennen eines Projekts von einem Repository Obwohl es möglich ist, mehrere Projekte aus einem einzigen vorhandenen GitHub-Repository zu erstellen, **ist es nicht möglich, das mit einem gegebenen Projekt verknüpfte Repository zu ändern**. Sobald ein Projekt mit einem Repository verknüpft ist, kann diese Verknüpfung nicht aufgehoben und das Projekt nicht verwendet werden, um ein neues Repository zu erstellen. Wenn Sie aus einem bestimmten Projekt ein neues Repository erstellen müssen, müssen Sie eine neue Kopie des Projekts erstellen und dann das neue Repository aus der Kopie erstellen. ### Bekannte Einschränkungen **Branches**: Das Overleaf-Git-System unterstützt kein Branching. **Symlinks**: Das Overleaf-Git-System unterstützt keine symbolischen Links. Ein Symlink kann in ein Overleaf-Projekt übertragen werden, wird jedoch in eine normale Datei umgewandelt und überschreibt den lokalen Symlink beim nächsten Abruf des Projekts. **Dateiberechtigungen**: Das Overleaf-Git-System erhält Ausführungsberechtigungen nicht aufrecht. Bei der Arbeit mit GitHub-Synchronisierung wird, wenn Dateien mit gesetztem Ausführungsbit in GitHub mit Overleaf synchronisiert werden, von Overleaf automatisch ein Commit ausgelöst, um die Dateiberechtigungen zurückzusetzen. **Git LFS**: Overleaf-Projekte unterstützen Git Large File Storage nicht. **Git-Submodule**: Overleaf-Projekte können als Git-Submodule innerhalb anderer Repositories fungieren, können jedoch keine anderen Git-Submodule enthalten. Um Dateien aus anderen Projekten zu referenzieren, wird empfohlen, die Funktion „Aus einem anderen Projekt hinzufügen“ zu verwenden. **Nachverfolgte Änderungen und Kommentare**: Leider können Abrufe von GitHub nach Overleaf zum Verlust oder zur Verschiebung von nachverfolgten Änderungen und Kommentaren führen; daher empfehlen wir nicht, aktive Arbeit in GitHub mit der Verwendung von nachverfolgten Änderungen und/oder Kommentaren zu mischen. **Direkte Synchronisierung mit GitHub Enterprise oder GitLab:** Die von Overleaf verwendete GitHub-API kann nur mit Repositories verbunden werden, die auf github.com gehostet werden. Sie können indirekt mit Projekten synchronisieren, die bei anderen Anbietern gehostet werden, indem Sie die [Overleaf-Git-Integration](/latex/de/wissensdatenbank/040-git-integration.md) Funktion importiert werden können. **Ein vorhandenes Projekt mit einem vorhandenen Repository verbinden**: Es ist nicht möglich, ein bestehendes Overleaf-Projekt mit einem bestehenden GitHub-Repository zu synchronisieren. **Urheberschaft von Übertragungen an GitHub**: Der einzige GitHub-Benutzer, der Overleaf bekannt ist, ist der Benutzer, dessen GitHub-Konto mit dem Overleaf-Konto verknüpft ist und diesem Projekt gehört. Alle Commits werden über eine GitHub-API erstellt, die diese Commits ausdrücklich unter Verwendung der Identität dieses Benutzers ausführt. Daher werden alle Commits in der GitHub-Git-Historie als vom verknüpften Benutzer stammend angezeigt. In der Historie von Overleaf werden Änderungen als „Anonym (über GitHub)“ angezeigt. **Git-Historie und Overleaf-Historie:** Änderungen auf der Overleaf-Seite haben keine Eins-zu-eins-Zuordnung zu GitHub-Commits. Mehrere Benutzer können auf der Overleaf-Seite Änderungen vornehmen, aber diese Änderungen werden bei Auslösung der Synchronisierung als ein einzelner Commit unter dem verbundenen GitHub-Benutzer gebündelt. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/de/wissensdatenbank/044-github-synchronization.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.