Linear

연결

Exporter 홈의 「클라우드」에서 Linear 옆의 「연결」를 누릅니다. Apple로 로그인하면 브라우저에 Linear 페이지가 열리고, 거기서 「Authorize」를 누릅니다. Exporter는 Linear에 읽기만 요청합니다. Exporter로 돌아와 파일이 저장될 위치를 고르고 「이 폴더 사용」를 누릅니다.

Linear 토큰은 Exporter 서버에 봉인된 채로 있습니다. Mac은 그 서버에 로그인할 뿐 토큰을 갖지 않습니다.

항목 고르기

선택 페이지에는 모든 이슈, 프로젝트, 문서가 선택된 채로 나오며, 「이슈」「프로젝트」「문서」 세 탭이 있습니다. 원하지 않는 것의 선택을 해제하면 그 파일은 빠집니다.

파일이 가는 곳

~/Documents처럼 홈 폴더 바로 아래의 폴더에는 안에 linear-export 폴더가 생깁니다. 더 깊은 폴더는 그대로 쓰입니다.

• 이슈: 팀마다 폴더 하나, 이슈마다 ID와 제목으로 이름 붙인 파일 하나: Northwind/NW-142 Invite flow.md
• 프로젝트: Projects/Q4 launch.md
• 문서: Documents/<project or team>/<title>.md

파일

이슈의 프런트매터에는 id, team, state, priority, assignee, creator, labels, project, cycle, parent, estimate, due와 날짜가 들어가며, source_url로 Linear에서 열 수 있습니다. 그다음 제목, 설명, 오래된 순서의 모든 댓글. 프로젝트에는 상태, 리드, 팀, 날짜가, 문서에는 프로젝트, 팀, 작성자가 들어갑니다. 시간은 UTC입니다.

동기화

Linear는 변경이 있을 때마다 Exporter 서버에 알립니다. 서버는 바로 파일을 다시 쓰고 Mac에 알리며, Mac이 내려받으므로 변경은 몇 초, 늦어도 1분 안에 도착합니다. 이름을 바꾼 이슈는 파일을 옮기고, 보관하거나 버리거나 삭제한 이슈는 파일이 없어집니다. 「지금 동기화」는 먼저 서버에 묻고, 「전체 재동기화」는 모든 파일을 다시 씁니다.

Exporter Cloud

처음 연결한 날부터 7일은 무료입니다. 그 뒤 Exporter Cloud는 App Store 구독입니다. Linear만, 또는 앞으로 추가되는 모든 클라우드 소스를 포함한 All Cloud를 월간이나 연간으로. 플랜이 끝나면 동기화가 멈추고 파일은 남습니다. 30일 뒤 서버는 사본과 토큰을 삭제합니다.

계정

「설정」 › 「계정」에 로그인한 이메일이 나옵니다. 「로그아웃」은 다음 로그인을 위해 연결을 남겨 둡니다. 「계정 삭제…」는 모든 워크스페이스의 연결을 끊고 서버가 보관한 모든 것을 삭제합니다. Mac의 파일은 남습니다.

명령줄

exporter export --source linear --dest <folder>는 명령줄 카드에서 허용한 폴더에 워크스페이스 파일을 씁니다. 명령줄을 참고하세요.

문제와 해결

• 카드에 「다시 연결…」이 보임: Linear가 더 이상 연결을 받아들이지 않습니다. 대개 Linear 설정에서 앱이 제거된 경우입니다. 눌러서 다시 허용하세요.
• 카드에 「로그인…」이 보임: 세션이 끝났습니다. 같은 Apple 계정으로 로그인하면 동기화가 이어집니다.
• 이슈가 없음: 선택되어 있는지 확인한 뒤 「지금 동기화」를 누르세요. 보관한 이슈는 내보내지 않습니다.