Linear
Jak funguje export Linearu, od připojení po řešení problémů.
Připojení
Stiskněte „Připojit“ u Linearu pod „Cloud“ na úvodní obrazovce Exporteru. Přihlaste se přes Apple; prohlížeč otevře stránku Linearu, kde stisknete „Authorize“. Exporter žádá Linear jen o čtení. Zpět v Exporteru zvolte, kam půjdou soubory, a stiskněte „Použít tuto složku“.
Token Linearu zůstává zapečetěný na serveru Exporteru. Váš Mac se k tomu serveru přihlašuje a token nikdy nedrží.
Výběr položek
Stránka výběru ukazuje každý úkol, projekt a dokument, vše zaškrtnuté, na třech kartách: Úkoly, Projekty a Dokumenty. Odškrtněte, co nechcete; jeho soubor zůstane mimo.
Kam soubory jdou
Složka přímo ve vaší domovské složce, třeba ~/Documents, dostane uvnitř složku linear-export; hlubší se použije tak, jak je.
- Úkoly: složka na tým, jeden soubor na úkol, pojmenovaný podle id a názvu úkolu:
Northwind/NW-142 Invite flow.md - Projekty:
Projects/Q4 launch.md - Dokumenty:
Documents/<project or team>/<title>.md
Soubor
Frontmatter úkolu nese id, team, state, priority, assignee, creator, labels, project, cycle, parent, estimate, due a data, a source_url ho otevře v Linearu. Pak název, popis a každý komentář, od nejstaršího. Projekt nese svůj stav, vedoucího, týmy a data; dokument svůj projekt, tým a autora. Časy jsou v UTC.
Synchronizace
Linear dává serveru Exporteru vědět o každé změně. Server soubor hned přepíše a dá vědět vašemu Macu, který si ho stáhne, takže úprava dorazí během sekund, nejvýš do minuty. Úkol, který přejmenujete, svůj soubor přesune; úkol, který archivujete, přesunete do koše nebo smažete, o něj přijde. „Synchronizovat nyní“ se nejdřív zeptá serveru; „Úplná resynchronizace“ zapíše každý soubor znovu.
Exporter Cloud
Prvních 7 dní od prvního připojení je zdarma. Pak je Exporter Cloud předplatné v App Storu: Linear samotný nebo All Cloud pro každý cloudový zdroj, který přidáme, měsíčně nebo ročně. Když tarif skončí, synchronizace se zastaví a vaše soubory zůstanou. O třicet dní později server smaže své kopie i token.
Účet
Nastavení › Účet ukazuje e-mail, se kterým jste se přihlásili. „Odhlásit se“ zachová připojení pro chvíli, kdy se znovu přihlásíte. „Smazat účet…“ odpojí každý pracovní prostor a smaže vše, co pro vás server drží. Soubory na vašem Macu zůstanou.
Příkazová řádka
exporter export --source linear --dest <folder> zapíše soubory pracovního prostoru do složky povolené na kartě Příkazová řádka. Viz příkazová řádka.
Problémy a řešení
- Karta ukazuje „Připojit znovu…“: Linear už připojení nepřijímá, často proto, že byla aplikace odebrána v nastavení Linearu. Stiskněte tlačítko a znovu autorizujte.
- Karta ukazuje „Přihlásit se…“: relace skončila. Přihlaste se stejným Apple účtem a synchronizace bude pokračovat.
- Chybí úkol: zkontrolujte, že je zaškrtnutý, pak stiskněte „Synchronizovat nyní“. Archivované úkoly se neexportují.