Notion
Cách trình xuất Notion hoạt động, từ kết nối đến khắc phục.
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 Notion. Đăng nhập bằng Apple, trình duyệt mở trang của Notion, nơi bạn chọn các trang Exporter được đọc và cho phép truy cập. Exporter chỉ xin quyền đọc Notion. Quay lại Exporter, chọn nơi đặt tệp và nhấn «Dùng thư mục này».
Token Notion đượ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.
Chia sẻ trang
Chỉ các trang bạn chia sẻ với Exporter mới được đồng bộ, cùng mọi trang và cơ sở dữ liệu bên dưới chúng. Để thêm một trang sau này, mở menu ⋯ của nó trong Notion và thêm kết nối exporter.dev; nó đến ở lần đồng bộ tiếp theo. Một trang bạn thôi chia sẻ sẽ rời khỏi thư mục của bạn ở lần kiểm tra hằng ngày tiếp theo.
Chọn mục
Trang chọn liệt kê mọi trang và cơ sở dữ liệu đã chia sẻ, tất cả đều được đánh dấu, với ba tab: «Tất cả», «Trang» và «Cơ sở dữ 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 notion-export bên trong. Thư mục sâu hơn được dùng nguyên như vậy.
- Trang: trong những thư mục mà Notion hiển thị chúng, đặt tên theo tiêu đề:
Projects/Plan Q4.md. Một trang có trang con có một thư mục cùng tên bên cạnh tệp của nó. - Cơ sở dữ liệu: một thư mục đặt tên theo cơ sở dữ liệu với một tệp cho mỗi dòng, và cả bảng bên cạnh:
Projects/Tasks/Write the plan.mdvàProjects/Tasks.csv - Ảnh và tệp do Notion lưu trữ:
attachments/trong thư mục của trang, được trang liên kết tới
/ và : trong tiêu đề trở thành dấu cách. Khi hai trang trong một thư mục trùng tiêu đề, trang tạo trước giữ tiêu đề đó và trang kia lấy 6 ký tự đầu của id đặt trong ngoặc.
Tệp
Front matter của một trang chứa title, id, created, modified, source_url và parent, là trang hoặc cơ sở dữ liệu chứa nó. Một dòng cơ sở dữ liệu thêm các thuộc tính của nó dưới tên trong Notion, theo thứ tự của cơ sở dữ liệu: văn bản, số, ngày, đúng hoặc sai, và danh sách tên. Sau đó là tiêu đề và trang dưới dạng Markdown thuần. Một callout là một trích dẫn kèm biểu tượng, một toggle là một khối details, và màu sắc bị bỏ. Một liên kết tới trang khác đã xuất là liên kết tương đối tới tệp của nó. Thời gian theo UTC.
CSV của cơ sở dữ liệu có một cột cho mỗi thuộc tính và một dòng cho mỗi dòng, cũ nhất trước.
Đồng bộ
Notion báo cho máy chủ của Exporter mọi chỉnh sửa, di chuyển và xóa. Máy chủ viết lại tệp và báo cho Mac, Mac tải về, nên thay đổi đến trong vài phút; bản thân Notion chờ một hai phút trước khi báo. Một trang bạn đổi tên hoặc di chuyển sẽ di chuyển tệp và tệp đính kèm của nó. «Đồ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 Notion, hoặc All Cloud cho Linear, Notion và 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. Ngắt kết nối Notion sẽ thu hồi quyền truy cập của Exporter trong Notion và xóa các bản sao của Exporter trên exporter.dev. «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 notion --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ý
- Thiếu một trang: chia sẻ nó với kết nối exporter.dev từ menu ⋯ của nó trong Notion, kiểm tra xem nó đã được đánh dấu chưa, rồi nhấn «Đồng bộ ngay».
- Một ảnh hiện thành liên kết: Notion không chịu giao nó, nên tệp liên kết tới ảnh đó trong Notion.
- Thẻ hiện «Kết nối lại…»: Notion không còn chấp nhận kết nối, thường vì nó đã bị gỡ trong cài đặt của Notion. Nhấn vào và cho phép truy cậ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.