Linear

Kết nối

Trên màn hình chính của Exporter, trong «Đám mây», nhấn «Kết nối» cạnh Linear. Đăng nhập bằng Apple, trình duyệt mở trang của Linear, và nhấn «Authorize» ở đó. Exporter chỉ xin quyền đọc Linear. Quay lại Exporter, chọn nơi đặt tệp và nhấn «Dùng thư mục này».

Token Linear được niêm phong trên máy chủ của Exporter. Mac chỉ đăng nhập vào máy chủ đó và không bao giờ giữ token.

Chọn mục

Trang chọn liệt kê mọi issue, dự án và tài liệu, tất cả đều được đánh dấu, với các tab «Issue», «Dự án» và «Tài liệu». Bỏ đánh dấu một mục và tệp của nó sẽ bị bỏ đi.

Các tệp đi đâu

Một thư mục nằm ngay dưới thư mục nhà, như ~/Documents, sẽ có một thư mục linear-export bên trong. Thư mục sâu hơn được dùng nguyên như vậy.

• Issue: một thư mục cho mỗi nhóm, một tệp cho mỗi issue đặt tên theo id và tiêu đề: Northwind/NW-142 Invite flow.md
• Dự án: Projects/Q4 launch.md
• Tài liệu: Documents/<project or team>/<title>.md

Tệp

Front matter của một issue chứa id, team, state, priority, assignee, creator, labels, project, cycle, parent, estimate, due và các ngày, với source_url để mở nó trong Linear. Sau đó là tiêu đề, mô tả và mọi bình luận, cũ nhất trước. Một dự án có trạng thái, người dẫn dắt, các nhóm và ngày; một tài liệu có dự án, nhóm và người tạo. Thời gian theo UTC.

Đồng bộ

Linear báo cho máy chủ của Exporter mọi thay đổi. Máy chủ viết lại tệp ngay và báo cho Mac, Mac tải về, nên thay đổi đến trong vài giây, nhiều nhất một phút. Một issue đổi tên sẽ di chuyển tệp; một issue bị lưu trữ, bỏ đi hay xóa sẽ mất tệp. «Đồng bộ ngay» hỏi máy chủ trước; «Đồng bộ lại toàn bộ» viết lại mọi tệp.

Exporter Cloud

7 ngày kể từ lần kết nối đầu tiên là miễn phí. Sau đó Exporter Cloud là gói đăng ký trên App Store: riêng Linear, hoặc All Cloud cho mọi nguồn đám mây chúng tôi thêm vào, theo tháng hoặc theo năm. Khi gói kết thúc, việc đồng bộ dừng và các tệp vẫn còn; sau 30 ngày máy chủ xóa bản sao và token.

Tài khoản

«Cài đặt» › «Tài khoản» hiển thị email bạn đã dùng để đăng nhập. «Đăng xuất» giữ các kết nối cho lần đăng nhập sau. «Xóa tài khoản…» ngắt mọi workspace và xóa mọi thứ máy chủ đang giữ. Các tệp trên Mac vẫn còn.

Dòng lệnh

exporter export --source linear --dest <folder> ghi các tệp của workspace vào một thư mục bạn đã cho phép trong thẻ dòng lệnh. Xem Dòng lệnh.

Sự cố và cách xử lý

• Thẻ hiện «Kết nối lại…»: Linear không còn chấp nhận kết nối, thường vì ứng dụng đã bị gỡ trong cài đặt Linear. Nhấn vào để cho phép lại.
• Thẻ hiện «Đăng nhập…»: phiên đã kết thúc. Đăng nhập bằng cùng tài khoản Apple và việc đồng bộ tiếp tục.
• Thiếu một issue: kiểm tra xem nó đã được đánh dấu chưa, rồi nhấn «Đồng bộ ngay». Issue đã lưu trữ không được xuất.