Hilfe-Center
Klare, praktische Anleitungen zum Schreiben, Kompilieren und Teilen von LaTeX- und Typst-Projekten.
Git, GitHub und WebDAV
Projektdateien über Git bewegen oder mit GitHub und externem Speicher synchronisieren.
Die passende Verbindung wählen
Wählen Sie Git, GitHub-Synchronisierung oder WebDAV passend zum Arbeitsablauf Ihres Teams. Die Verbindungen sind in Bildung, Plus und Pro verfügbar.
So geht’s
- Nehmen Sie Git, wenn Sie das Projekt lokal mit Ihrem gewohnten Kommandozeilen-Ablauf bearbeiten wollen.
- Nehmen Sie die GitHub-Synchronisierung, wenn die maßgebliche Quelle ein Repository ist, aus dem Ihr Team ohnehin reviewt und veröffentlicht.
- Nehmen Sie WebDAV, wenn das Projekt in institutionellem oder privatem Speicher landen muss statt bei einem Code-Hoster.
- Kombinieren ist erlaubt, aber legen Sie vor der zweiten Verbindung fest, welche Seite maßgeblich ist.
- Wessen Tarif zählt, ist verschieden: Der Git-Zugang hängt von Ihrem eigenen Tarif ab, die Synchronisierung mit GitHub und WebDAV vom Tarif der Projekteigentümerin.
- Liegen die Dateien bereits woanders, wählen Sie im Dashboard Aus GitHub oder WebDAV importieren. Das legt ein Projekt aus einem Repository-Branch oder einem WebDAV-Ordner an und hält es damit verbunden.
Die Verbindung einrichten
Bereiten Sie die passenden Zugangsdaten vor und richten Sie die Verbindung im gewünschten Projekt ein.
So geht’s
- Für Git auf der Kommandozeile: Öffnen Sie Zugriffstoken in den Kontoeinstellungen und erstellen Sie ein Git-Token. Klappen Sie im Projekt Git auf, kopieren Sie Repository-URL oder Clone-Befehl und nutzen Sie das Token als HTTP-Basic-Passwort. Betrachter können klonen und pullen; Eigentümer und Bearbeiter zusätzlich auf main pushen.
- Ein Push, der hinter dem Projekt liegt, wird automatisch zusammengeführt, wenn Sie und Ihre Mitarbeitenden verschiedene Dateien geändert haben. Haben beide dieselbe Datei geändert, wird der Push abgelehnt und nennt die Pfade: Führen Sie git pull aus, lösen Sie den Konflikt und pushen Sie erneut.
- Für die GitHub-Synchronisierung: Verbinden Sie GitHub unter Externe Verbindungen in den Kontoeinstellungen und installieren Sie die JointTex GitHub App für die gewählten Repositories. Öffnen Sie dann GitHub in der Ansicht Externe Verbindungen des Projekts, wählen Sie vorhandenes Repository und Branch, prüfen Sie die vollständige Änderungsvorschau und bestätigen Sie die manuelle Synchronisierung.
- JointTex synchronisiert das gesamte Stammverzeichnis des Repositorys, ausgenommen .github/workflows. Ein Repository, das Submodule enthält, kann nicht synchronisiert werden. Die Synchronisierung ist immer manuell: Eine Änderung auf GitHub wird im Projekt nur angezeigt, bis Sie Prüfen und synchronisieren wählen.
- Für ein neues Repository wählen Sie Repository auf GitHub erstellen, gewähren der GitHub App bei Bedarf Zugriff darauf und wählen dann Repositories aktualisieren. Bei einem leeren Repository legt JointTex den Branch bei der ersten Synchronisierung an.
- Für WebDAV: Speichern Sie unter Kontoeinstellungen › Externe Verbindungen ein wiederverwendbares Profil mit Stammordner-URL, Benutzername und Anwendungspasswort — oder geben Sie Zugangsdaten nur für ein Projekt ein. Wählen Sie den Projektordner, testen Sie die Verbindung, prüfen Sie die erste Synchronisierung und verbinden Sie.
WebDAV synchron halten
Ein WebDAV-Ordner wird nur kontaktiert, wenn es einen Anlass gibt — eine Änderung, die es nur dort gibt, wartet also auf die nächste Synchronisierung.
So geht’s
- Nutzen Sie Jetzt synchronisieren, um Änderungen zu holen, die es nur auf dem WebDAV gibt. Die optionale automatische WebDAV-Synchronisierung läuft nur nach einer Änderung im JointTex-Projekt; drei aufeinanderfolgende Fehlschläge pausieren sie, bis eine manuelle Synchronisierung gelingt.
- Zeigt die erste Vorschau Konflikte, ändert das Verbinden keine Dateien; prüfen Sie die Konflikte, nachdem die Verbindung angelegt ist.
- Zugangsdaten, die nur für ein Projekt eingegeben wurden, lassen sich später mit Als Kontoprofil speichern für andere Projekte aufbewahren.
Konflikte lösen und Zugriff verwalten
Bei Konflikten prüfen Sie die Unterschiede und wählen die gewünschte Fassung. Zugriffsrechte folgen den Projektrollen.
So geht’s
- Meldet GitHub oder WebDAV einen Konflikt, ändert diese Synchronisierung keine einzige Datei.
- Öffnen Sie Konflikte prüfen, vergleichen Sie beide Fassungen, wählen Sie die zu behaltende Seite — oder beide, wo angeboten — und bestätigen Sie jede Entscheidung; JointTex prüft vor dem Schreiben beide Seiten erneut.
- Mit Auf alle kompatiblen Dateien anwenden treffen Sie eine Entscheidung für viele Dateien. Eine Datei, die sich nicht als Textdiff anzeigen lässt, können Sie vor der Entscheidung in beiden Fassungen herunterladen.
- Die Eigentümerin richtet GitHub und WebDAV ein oder trennt sie; Eigentümer und Bearbeiter synchronisieren und lösen Konflikte, Betrachter sehen den Status.
- Trennen Sie die Verbindung bei ungelösten Konflikten, bleiben beide Fassungen 30 Tage lang unter Letzte Konfliktarchive herunterladbar, lassen sich aber nicht mehr automatisch anwenden.
- Trennen Sie ungenutzte Projekte, bevor Sie ein GitHub-Konto oder ein WebDAV-Profil entfernen.