Як вивантажувати зображення з Typora в S3 чи Cloudflare R2

Власний вивантажувач Typora запускає команду зі шляхами до зображень і зчитує посилання, які вона виводить. aktar робить саме це, використовуючи цілі, які ви вже налаштували в Aktar для Mac чи Windows.

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

1. В Aktar відкрийте Параметри > Інтеграції, увімкніть Дозволити локальні з’єднання і скопіюйте токен.
2. Виконайте aktar login у терміналі й вставте його.
3. Перевірте командою aktar upload some-image.png. Вона має вивести посилання.

1. Відкрийте параметри Typora (Typora > Settings… на Mac, File > Preferences… у Windows) і перейдіть до Image.
2. У розділі Image Uploader виберіть Custom Command.
3. Введіть команду з повним шляхом. На Mac із Homebrew це:

/opt/homebrew/bin/aktar upload

Виконайте which aktar (у Windows where aktar), щоб побачити, де лежить ваша. Typora не завжди бачить PATH вашого термінала, тому повний шлях надійніший, ніж просто aktar.

4. Клацніть Test Uploader. Typora вивантажить два невеликі тестові зображення й покаже отримані посилання.

У тих самих параметрах Image для When Insert… виберіть Upload Image. Відтоді вставлене чи перетягнуте в документ зображення вивантажується, а посилання на бакет записується в Markdown.

Для документа, де вже є локальні зображення, скористайтеся Format > Image > Upload All Local Images.

За замовчуванням зображення йдуть у ціль, вибрану в смузі меню Aktar, і отримують назви за її шаблоном шляху. Щоб надсилати зображення з Typora деінде, додайте до команди параметри:

/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

Перший рядок надсилає зображення в ціль із назвою «Blog», другий зберігає назви файлів і складає їх в одну папку. Залиште виведення у вигляді звичайних URL-адрес (за замовчуванням): Typora сама пише Markdown, тож не додавайте тут --format чи --json.

• Команду або node не знайдено: використайте повний шлях із which aktar. Версія з Homebrew має власний шлях до Node, тож працює з Typora без змін; якщо ви інсталювали через npm, запускайте як /path/to/node /path/to/aktar upload.
• Немає з’єднання з Aktar: виконайте aktar login у терміналі й переконайтеся, що Aktar запущено з увімкненим параметром «Дозволити локальні з’єднання».
• Посилання відкривається з Access Denied: вивантаження вдалося, але бакет не доступний публічно за своєю публічною URL-адресою. Див. помилки Access Denied.