Linear

Podłączenie

Naciśnij „Połącz” obok Linear w sekcji „Chmura” na ekranie głównym Exportera. Zaloguj się przez Apple; przeglądarka otworzy stronę Linear, na której naciśniesz „Authorize”. Exporter prosi Linear tylko o odczyt. Po powrocie do Exportera wybierz, gdzie trafią pliki, i naciśnij „Użyj tego folderu”.

Token Linear zostaje zapieczętowany na serwerze Exportera. Twój Mac loguje się do tego serwera i nigdy nie trzyma tokenu.

Wybór elementów

Strona wyboru pokazuje każde zgłoszenie, projekt i dokument, wszystko zaznaczone, na trzech kartach: Zgłoszenia, Projekty i Dokumenty. Odznacz, czego nie chcesz; jego plik zostaje poza eksportem.

Gdzie trafiają pliki

Folder leżący wprost w katalogu domowym, na przykład ~/Documents, dostaje w środku folder linear-export; głębszy jest brany taki, jaki jest.

• Zgłoszenia: folder na zespół, po jednym pliku, nazwanym identyfikatorem i tytułem zgłoszenia: Northwind/NW-142 Invite flow.md
• Projekty: Projects/Q4 launch.md
• Dokumenty: Documents/<project or team>/<title>.md

Plik

Frontmatter zgłoszenia zawiera id, team, state, priority, assignee, creator, labels, project, cycle, parent, estimate, due i daty, a source_url otwiera je w Linear. Potem tytuł, opis i każdy komentarz, od najstarszego. Projekt zawiera swój status, lidera, zespoły i daty; dokument swój projekt, zespół i autora. Czasy są w UTC.

Synchronizacja

Linear informuje serwer Exportera o każdej zmianie. Serwer od razu przepisuje plik i daje znać twojemu Macowi, który go pobiera, więc zmiana dociera w kilka sekund, najwyżej w minutę. Zgłoszenie, któremu zmienisz nazwę, przenosi swój plik; to, które zarchiwizujesz, przeniesiesz do kosza albo usuniesz, traci go. „Synchronizuj teraz” najpierw pyta serwer; „Pełna resynchronizacja” zapisuje każdy plik od nowa.

Exporter Cloud

Pierwsze 7 dni od pierwszego podłączenia jest za darmo. Potem Exporter Cloud to subskrypcja w App Store: sam Linear albo All Cloud na każde źródło w chmurze, które dodamy, miesięcznie lub rocznie. Gdy plan się skończy, synchronizacja staje, a twoje pliki zostają. Trzydzieści dni później serwer usuwa swoje kopie i token.

Konto

Ustawienia › Konto pokazuje e-mail, którym się zalogowałeś. „Wyloguj się” zachowuje połączenie na czas, gdy zalogujesz się ponownie. „Usuń konto…” rozłącza każdy obszar roboczy i usuwa wszystko, co serwer dla ciebie trzyma. Pliki na twoim Macu zostają.

Wiersz poleceń

exporter export --source linear --dest <folder> zapisuje pliki obszaru roboczego do folderu udostępnionego na karcie Wiersz poleceń. Zobacz wiersz poleceń.

Problemy i rozwiązania

• Karta pokazuje „Połącz ponownie…”: Linear nie przyjmuje już połączenia, często dlatego, że aplikację usunięto w ustawieniach Linear. Naciśnij przycisk i autoryzuj ponownie.
• Karta pokazuje „Zaloguj się…”: sesja się skończyła. Zaloguj się tym samym kontem Apple, a synchronizacja ruszy dalej.
• Brakuje zgłoszenia: sprawdź, czy jest zaznaczone, a potem naciśnij „Synchronizuj teraz”. Zarchiwizowane zgłoszenia nie są eksportowane.