Typemark Documentation

Branches im Editor

Arbeite im Typemark-Editor an einem Branch, zeig eine Vorschau davon an und führe ihn zusammen, wenn er fertig ist, ohne deine Live-Seite zu verändern. Verfügbar für Pro und Enterprise.

Aktualisiert am 19. Nov. 20263 Min. Lesezeit

Erstelle im Editor einen Branch für Änderungen, die Leser noch nicht halbfertig sehen sollen: eine Überarbeitung, einen neuen Abschnitt oder eine neue Struktur. Speicherungen auf einem Branch bleiben auf diesem Branch, er erhält eine eigene Vorschau, und deine Live-Seite ändert sich erst, wenn der Branch zusammengeführt wird. Branches sind in Pro und Enterprise verfügbar, folgen dem Tarif des Projektinhabers und funktionieren sowohl für von Typemark gehostete Projekte als auch für Projekte, die mit GitHub verbunden sind.

Branch erstellen

  1. Branch-Menü öffnen

    Die obere Leiste des Editors zeigt den aktuellen Branch, etwa main. Klicke darauf.

  2. Branch erstellen

    Wähle Create branch…, gib einen Namen wie rewrite-quickstart ein und klicke auf Create branch. Er startet von der neuesten Version deines Deployment-Branches.

  3. Bearbeiten

    Der Editor lädt auf dem neuen Branch neu. Ein Streifen unter der oberen Leiste zeigt an, welchen Branch du bearbeitest.

Ein Branch-Name folgt den Git-Regeln für Branch-Namen und darf weder der Deployment-Branch noch ein bereits im Projekt vorhandener Branch sein.

Zum Wechseln öffne dasselbe Menü und wähle einen Branch aus. Dein Deployment-Branch ist der mit (live) markierte. Typemark merkt sich für jedes Projekt, auf welchem Branch du dich befindest.

Was auf einem Branch passiert

  • Speicherungen gehen nur auf den Branch. Deine Live-Seite, ihre Seiten und ihr Veröffentlichungsverlauf ändern sich nicht.
  • Alles im Editor funktioniert auf dem Branch: Seiten erstellen und sortieren, Bilder hochladen und KI-Bearbeitungen über mehrere Seiten.
  • Eine Seite speichert auf den Branch, auf dem sie geöffnet wurde. Ein Tab, den du vor dem Wechsel offen gelassen hast, speichert weiterhin auf seinen eigenen Branch.
  • Wer gerade bearbeitet und der Build-Status sind pro Branch, du siehst also nur die Personen auf demselben Branch.
  • Einstellungen ändern die Live-Seite. Settings, eigener Code und die GitHub-Verbindung gelten immer für den Deployment-Branch, unabhängig davon, wo der Editor geöffnet ist.
  • Bei einem mit GitHub verbundenen Projekt wird der Branch als gleichnamiger Branch zu GitHub übertragen. Commits, die jemand auf GitHub in diesen Branch pusht, werden beim nächsten Build der Vorschau übernommen.
  • KI-Übersetzungen laufen nicht auf Branches. Ein Branch startet mit den Übersetzungen der Live-Seite, und der Sprachumschalter zeigt dort keinen KI-Status und keinen Re-translate-Button.

Branch-Vorschau anzeigen

Klicke im Streifen unter der oberen Leiste auf Preview, um die eigene Vorschau des Branches unter einer Adresse zu öffnen, die aus dem Branch-Namen gebildet wird:

https://acme-docs--rewrite-quickstart.typemark.dev

Sie funktioniert wie eine Vorschau für Pull Requests: Ein Banner zeigt an, welcher Branch angezeigt wird, Suchmaschinen indexieren sie nicht, und KI-Tools können sie nicht lesen. Anders als bei Pull-Request-Vorschauen bleibt die Vorschau eines Branches bestehen, bis der Branch gelöscht wird, egal wie lange keine Änderungen vorgenommen werden. Die Schaltfläche Preview in der oberen Leiste öffnet weiterhin die Seite auf deiner Live-Seite.

Änderungen live schalten

Klicke im Streifen auf Open pull request. Typemark pusht den Branch und öffnet einen Pull Request in deinen Deployment-Branch mit dem Titel „Docs changes from“, gefolgt vom Branch-Namen. Der Streifen zeigt dann View pull request.

Prüfe und führe den Pull Request auf GitHub zusammen. Das Zusammenführen veröffentlicht die Änderung, wie jeder Push auf den Deployment-Branch. Der Pull Request verwendet die Vorschau des Branches, die jede Speicherung nachverfolgt. Der Branch bleibt nach dem Schließen des Pull Requests im Editor erhalten, lösche ihn also, wenn du fertig bist.

Der Projektinhaber klickt auf Merge into und dann auf den Namen des Deployment-Branches, etwa Merge into main. Typemark führt den Branch mit einem Commit des Inhabers zusammen und baut deine Live-Seite neu.

Wenn der Branch und der Deployment-Branch dieselben Zeilen geändert haben, wird nichts zusammengeführt, und die Meldung nennt die betroffenen Dateien. Bearbeite diese Dateien auf dem Branch, damit sie zur Live-Version passen, und führe dann erneut zusammen.

Branch löschen

Klicke im Streifen auf Delete branch und bestätige. Die Bearbeitungen des Branches, seine Vorschau und seine Seiten in Typemark werden gelöscht. Bereits in den Deployment-Branch übernommene Änderungen bleiben erhalten, und bei einem verbundenen Projekt bleibt auch der Branch auf GitHub bestehen.

Wer was darf

AktionWer
Branches wechseln und ansehenAlle im Projekt
Branch erstellen, darauf speichern, Pull Request öffnenEditoren und Inhaber
Branch zusammenführen, bei einem von Typemark gehosteten ProjektInhaber
Branch löschenInhaber oder wer ihn erstellt hat

Die Rollen findest du unter Teammitglieder.

Tarife

Branches folgen dem Tarif des Projektinhabers. Im Free-Tarif zeigt die Branch-Schaltfläche in der oberen Leiste ein Pro-Abzeichen und öffnet die Abrechnungsseite. Wechselt der Inhaber auf Free, kehrt der Editor zum Deployment-Branch zurück, und Branches lassen sich nicht mehr ändern, bleiben aber erhalten: Upgradest du erneut, sind alle wieder da.

Ein Branch, der im Editor geöffnet ist, kann nicht zum Deployment-Branch deiner Seite werden. Lösche ihn zuerst im Editor.