Typemark Documentation

Gałęzie w edytorze

Pracuj na gałęzi w edytorze Typemark, podglądaj ją i scalaj, gdy będzie gotowa, bez ingerencji w działającą witrynę. Dostępne w planach Pro i Enterprise.

Uuendatud 19. nov 20263 min lugemist

Utwórz gałąź w edytorze dla zmian, których czytelnicy nie powinni widzieć w połowie drogi: przepisania, nowej sekcji, nowej struktury. Zapisy na gałęzi pozostają na tej gałęzi, ma ona własny podgląd, a Twoja działająca witryna zmienia się dopiero po scaleniu gałęzi. Gałęzie są dostępne w planach Pro i Enterprise, zależą od planu właściciela projektu i działają zarówno dla projektów hostowanych przez Typemark, jak i dla projektów połączonych z GitHubem.

Utwórz gałąź

  1. Otwórz menu gałęzi

    Górny pasek edytora pokazuje gałąź, na której pracujesz, na przykład main. Kliknij ją.

  2. Utwórz gałąź

    Wybierz Utwórz gałąź…, wpisz nazwę, na przykład rewrite-quickstart, i kliknij Utwórz gałąź. Gałąź startuje od najnowszej wersji gałęzi wdrożeniowej.

  3. Edytuj

    Edytor przeładowuje się na nowej gałęzi. Pasek pod górnym paskiem informuje, którą gałąź edytujesz.

Nazwa gałęzi musi spełniać zasady Gita dotyczące nazw gałęzi i nie może być gałęzią wdrożeniową ani gałęzią, która już istnieje w projekcie.

Aby przełączyć się na inną gałąź, otwórz to samo menu i wybierz gałąź. Gałąź wdrożeniowa jest oznaczona (live). Typemark zapamiętuje, na której gałęzi pracujesz, osobno dla każdego projektu.

Co dzieje się na gałęzi

  • Zapisy trafiają tylko na gałąź. Twoja działająca witryna, jej strony i historia publikacji się nie zmieniają.
  • Wszystko w edytorze działa na gałęzi: tworzenie i zmiana kolejności stron, przesyłanie obrazów oraz edycje AI na wielu stronach.
  • Strona zapisuje się na gałęzi, na której została otwarta. Karta, którą zostawiłeś otwartą przed przełączeniem gałęzi, nadal zapisuje na swoją gałąź.
  • Informacja o tym, kto edytuje, i status kompilacji są przypisane do gałęzi, więc widzisz tylko osoby pracujące na tej samej gałęzi.
  • Ustawienia zmieniają działającą witrynę. Ustawienia, własny kod oraz połączenie z GitHubem zawsze dotyczą gałęzi wdrożeniowej, niezależnie od tego, gdzie jest otwarty edytor.
  • W projekcie połączonym z GitHubem gałąź jest wysyłana do GitHuba jako gałąź o tej samej nazwie. Commity, które ktoś wypchnie na tę gałąź na GitHubie, zostaną uwzględnione przy następnym zbudowaniu jej podglądu.
  • Tłumaczenia AI nie działają na gałęziach. Gałąź startuje z tłumaczeniami działającej witryny, a przełącznik języków nie pokazuje tam statusu AI ani przycisku Przetłumacz ponownie.

Podgląd gałęzi

Kliknij Podgląd w pasku pod górnym paskiem, aby otworzyć własny podgląd gałęzi, pod adresem utworzonym z nazwy gałęzi:

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

Działa to jak podgląd pull requesta: baner informuje, którą gałąź pokazuje, wyszukiwarki jej nie indeksują, a narzędzia AI nie mogą jej odczytać. W przeciwieństwie do podglądów pull requestów podgląd gałęzi istnieje, dopóki gałąź nie zostanie usunięta, niezależnie od tego, jak długo nie ma w niej zmian. Przycisk Podgląd w górnym pasku nadal otwiera stronę w działającej witrynie.

Wprowadź zmiany na żywo

Kliknij Otwórz pull request w pasku. Typemark wypycha gałąź i otwiera pull request do gałęzi wdrożeniowej, zatytułowany „Docs changes from” i nazwa gałęzi. Pasek pokaże wtedy Zobacz pull request.

Przejrzyj i scal go na GitHubie. Scalenie publikuje zmianę, tak jak każde wypchnięcie do gałęzi wdrożeniowej. Pull request korzysta z podglądu gałęzi, który aktualizuje się przy każdym zapisie. Gałąź pozostaje w edytorze po zamknięciu pull requesta, więc usuń ją, gdy skończysz.

Właściciel projektu klika Scal do i nazwę gałęzi wdrożeniowej, na przykład Scal do main. Typemark scala gałąź commitem wykonanym przez właściciela i przebudowuje działającą witrynę.

Jeśli gałąź i gałąź wdrożeniowa zmieniły te same wiersze, scalenie się nie odbywa, a komunikat wskazuje pliki. Edytuj te pliki na gałęzi tak, aby były zgodne z wersją działającą, a następnie scal ponownie.

Usuń gałąź

Kliknij Usuń gałąź w pasku i potwierdź. Zostaną usunięte zmiany na gałęzi, jej podgląd oraz jej strony w Typemark. Zmiany już scalone do gałęzi wdrożeniowej pozostają, a w projekcie połączonym z GitHubem gałąź na GitHubie też pozostaje.

Kto może co robić

DziałanieKto
Przełączanie i przeglądanie gałęziWszyscy w projekcie
Tworzenie gałęzi, zapisywanie na niej, otwieranie pull requestaEdytorzy i właściciel
Scalanie gałęzi w projekcie hostowanym przez TypemarkWłaściciel
Usuwanie gałęziWłaściciel lub osoba, która ją utworzyła

Role opisuje Członkowie zespołu.

Plany

Gałęzie zależą od planu właściciela projektu. W planie Free przycisk gałęzi w górnym pasku pokazuje odznakę Pro i otwiera stronę Rozliczeń. Jeśli właściciel przejdzie na Free, edytor wraca do gałęzi wdrożeniowej i gałęzi nie da się zmieniać, ale nie są one usuwane: po ponownym wykupieniu planu wszystkie będą na miejscu.

Gałęzi, która jest otwarta w edytorze, nie można ustawić jako gałęzi wdrożeniowej witryny. Najpierw usuń ją w edytorze.