Cách tải ảnh Typora lên S3 hoặc Cloudflare R2

Trình tải lên tùy chỉnh của Typora chạy một lệnh với đường dẫn ảnh và đọc các liên kết lệnh đó in ra. aktar làm đúng việc này, dùng các đích bạn đã thiết lập trong Aktar cho Mac hoặc Windows.

brew install getaktar/tap/aktar-cli    # or: npm install -g @getaktar/cli

1. Trong Aktar, mở Cài đặt > Tích hợp, bật Cho phép kết nối cục bộ và sao chép token.
2. Chạy aktar login trong terminal và dán token vào.
3. Kiểm tra bằng aktar upload some-image.png. Lệnh sẽ in ra một liên kết.

1. Mở cài đặt của Typora (Typora > Settings… trên Mac, File > Preferences… trên Windows) và vào Image.
2. Trong Image Uploader, chọn Custom Command.
3. Nhập lệnh kèm đường dẫn đầy đủ. Trên Mac có Homebrew, đó là:

/opt/homebrew/bin/aktar upload

Chạy which aktar (trên Windows là where aktar) để xem lệnh của bạn nằm ở đâu. Typora không phải lúc nào cũng thấy PATH của terminal, nên dùng đường dẫn đầy đủ an toàn hơn là chỉ ghi aktar.

4. Nhấp Test Uploader. Typora sẽ tải lên hai ảnh thử nhỏ và hiển thị các liên kết nhận được.

Cũng trong cài đặt Image, đặt When Insert… là Upload Image. Từ đó, mỗi khi dán hoặc kéo ảnh vào tài liệu, ảnh sẽ được tải lên và liên kết bucket được ghi vào Markdown.

Với tài liệu đã có sẵn ảnh cục bộ, hãy dùng Format > Image > Upload All Local Images.

Mặc định, ảnh được đưa đến đích đang chọn trên thanh menu của Aktar và đặt tên theo mẫu đường dẫn của đích đó. Để gửi ảnh Typora đến nơi khác, hãy thêm tùy chọn vào lệnh:

/opt/homebrew/bin/aktar upload -d Blog              # a destination named "Blog"
/opt/homebrew/bin/aktar upload --folder docs/images # keep file names, in one folder

Giữ đầu ra là URL thuần (mặc định): Typora tự viết Markdown, nên đừng thêm --format hay --json ở đây.

• Không tìm thấy lệnh hoặc không tìm thấy node: dùng đường dẫn đầy đủ từ which aktar. Bản Homebrew tự mang theo đường dẫn đến Node, nên chạy được từ Typora ngay; nếu cài bằng npm, hãy chạy dưới dạng /path/to/node /path/to/aktar upload.
• Chưa kết nối với Aktar: chạy aktar login trong terminal, và đảm bảo Aktar đang chạy với Cho phép kết nối cục bộ được bật.
• Liên kết mở ra báo Access Denied: việc tải lên đã thành công, nhưng bucket chưa công khai tại URL công khai của nó. Xem lỗi Access Denied.