# GitHub-Sync

Verbinden Sie GitHub mit einem Gerätecode oder einem Token, veröffentlichen Sie ein Projekt als neues oder vorhandenes Repository, pushen und pullen Sie zwischen Rechnern, und erfahren Sie, wie Ihr Token geschützt ist.

Der GitHub-Sync ist optionale Sicherung außerhalb Ihres Rechners und Übergabe zwischen mehreren Computern, gebaut auf dem [echten Git-Repository](/docs/git-history/), das jedes Projekt ohnehin ist. Lokale Commits funktionieren ohne GitHub. Wenn Sie eine Verbindung herstellen, ist weiterhin kein Oleafly-Konto im Spiel: nur Ihr GitHub.

## Ihr Konto verbinden

Einstellungen, **Integrationen**, **GitHub**, dann einer von beiden Wegen:

- **GitHub verbinden** (empfohlen): ein Gerätecode-Ablauf. Oleafly zeigt einen kurzen Code, Ihr Browser öffnet `github.com/login/device` (mit einer Schaltfläche **Kopieren** für den Code), Sie stimmen zu, und die App erkennt es innerhalb von Sekunden. Die Verbindung fragt nur die Scopes `repo` und `read:user` an.
- **Persönliches Zugriffstoken**: Klappen Sie „Fortgeschritten: ein persönliches Zugriffstoken verwenden“ aus und fügen Sie ein PAT ein, wenn Sie lieber eigene Zugangsdaten ausstellen.

Einmal verbunden, erscheinen Ihr Avatar und Ihr Benutzername in den Einstellungen und im GitHub-Menü der oberen Werkzeugleiste. **Verbindung trennen** vergisst das Token.

### Wie Ihr Token geschützt ist

Das Token liegt in einer mit AES-256-GCM verschlüsselten, auf den Besitzer beschränkten lokalen Datei und wird nie an die UI-Schicht der App weitergegeben; die Oberfläche erfährt nur „verbunden als @you“. Muss sich Git authentifizieren, wird das Token über einen Credential-Helper im Speicher injiziert, sodass es nie in einer Kommandozeile, in `.git/config` oder in Ihrer Shell-Historie erscheint. Ältere Programmversionen, die Tokens in Remote-URLs eingebettet hatten, werden beim Start automatisch bereinigt.

## Ein Projekt veröffentlichen

Klicken Sie im Bereich Versionsverwaltung auf **Auf GitHub veröffentlichen**:

- **Neues Repository anlegen**: Wählen Sie einen Namen (vorab aus dem Projekt gefüllt), lassen Sie **Privat** (empfohlen) angehakt oder nicht, und klicken Sie auf **Anlegen und pushen**. Oleafly legt das Repository an, committet die Dateien des Projekts, verdrahtet `origin` und pusht.
- **Vorhandenes verknüpfen**: Wählen Sie aus einer durchsuchbaren Liste Ihrer Repositorys (private zeigen ein Schloss) und klicken Sie auf **Verknüpfen und pushen**.

Nach dem Veröffentlichen bietet das GitHub-Menü der Werkzeugleiste **In GitHub öffnen** und **Link zum Repository kopieren** an.

### Dateien, die wie Geheimnisse aussehen, bleiben lokal

Das Veröffentlichen committet nie Dateien, die üblicherweise Schlüssel oder Passwörter enthalten, etwa `.env`, `*.pem`, private SSH-Schlüssel oder `credentials.json`. Sie bleiben im Projektordner, unbereitgestellt, und der Dialog nennt sie. Um eine davon trotzdem zu veröffentlichen, stellen Sie sie selbst in der Versionsverwaltung bereit und committen sie. Vorlagen wie `.env.example`, öffentliche Schlüssel und Keynote-`.key`-Dateien werden wie üblich veröffentlicht.

Ein Push lädt die ganze Historie hoch. Wurde eine Datei mit einem dieser Namen je committet, listet Oleafly sie auf und wartet auf **Abbrechen** oder **Trotzdem veröffentlichen**, bevor es irgendetwas auf GitHub anlegt.

## Sync im Alltag

Die Schaltflächen **Push** und **Pull** im Bereich Versionsverwaltung tun, was sie sagen, gegen `origin` auf Ihrem aktuellen Branch. **Fetch** und **Abgleichen** liegen im Menü **Weitere Aktionen der Versionsverwaltung**, und **Committen & pushen** und **Committen & abgleichen** im Menü neben **Committen**. Die Anzeige **voraus/zurück** (↑ ↓) neben dem Branch-Schild sagt Ihnen, wenn es etwas zu pushen oder zu pullen gibt.

### Zwei Computer

1. Auf Rechner A: Projekt veröffentlichen, arbeiten, **Push**.
2. Auf Rechner B: Verbinden Sie dasselbe GitHub-Konto, wählen Sie dann **Ein Projekt importieren → GitHub** und wählen Sie das Repository aus. Siehe [Importanleitung](/docs/import-project/#import-from-github). Von da an: **Pull**, arbeiten, **Push**.
3. Zurück auf A: **Pull**, bevor Sie beginnen. Die Anzeige erinnert Sie.

Farbe des Deckblatts, die Wahl des Hauptdokuments und die Historie reisen alle mit, weil sie im Projektordner selbst liegen.

## Wenn Sie es anders überlegen

Ist ein Remote gesetzt, hat das Menü **Weitere Aktionen der Versionsverwaltung** zwei Punkte mehr:

- **Repository wechseln** öffnet den Veröffentlichungsdialog erneut, um `origin` woanders hin zu zeigen.
- **Verknüpfung lösen** entfernt das Remote; das lokale Projekt und seine Historie bleiben unberührt.

## Konflikte und Branches

Stößt ein Pull auf einen Merge-Konflikt, listet die Versionsverwaltung die konfliktbehafteten Dateien auf. Wählen Sie für jede **Aktuelle verwenden** oder **Eingehende verwenden**, oder bearbeiten Sie die Datei und wählen Sie **Als gelöst markieren**, dann **Merge abschließen**. **Merge abbrechen** stellt die Dateien wieder her, wie sie waren. Push und Pull arbeiten auf dem Branch, den Sie ausgecheckt haben, und das Branch-Menü oben im Bereich wechselt Branches oder legt sie an. Siehe [Git und Versionsverwaltung](/docs/git-history/#branches-and-stashes).

## Grenzen, klar gesagt

Oleafly authentifiziert HTTPS-Remotes. Veröffentlichen richtet eines korrekt für Sie ein.

## Wenn etwas fehlschlägt

- „No remote ‚origin‘“: Veröffentlichen Sie zuerst; Push und Pull brauchen ein Remote.
- Push abgelehnt, weil das Remote Commits hat: zuerst pullen, dann pushen.
- „No GitHub token set“: Verbinden Sie in den Einstellungen, Integrationen, GitHub.

Mehr in den [FAQ](/docs/faq/#history-and-collaboration).
