Jak przesyłać obrazy z Typory do S3 lub Cloudflare R2

Własne narzędzie przesyłania w Typorze uruchamia polecenie ze ścieżkami obrazów i odczytuje wypisane przez nie linki. aktar robi dokładnie to, korzystając z miejsc docelowych, które już skonfigurowałeś w Aktarze na Maca lub Windows.

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

1. W Aktarze otwórz Ustawienia > Integracje, włącz Zezwalaj na połączenia lokalne i skopiuj token.
2. Uruchom aktar login w terminalu i wklej go.
3. Sprawdź to poleceniem aktar upload some-image.png. Powinno wypisać link.

1. Otwórz ustawienia Typory (Typora > Settings… na Macu, File > Preferences… na Windows) i przejdź do Image.
2. W sekcji Image Uploader wybierz Custom Command.
3. Wpisz polecenie z pełną ścieżką. Na Macu z Homebrew jest to:

/opt/homebrew/bin/aktar upload

Uruchom which aktar (na Windows where aktar), aby sprawdzić, gdzie jest Twoje. Typora nie zawsze widzi PATH z Twojego terminala, dlatego pełna ścieżka jest pewniejsza niż samo aktar.

4. Kliknij Test Uploader. Typora prześle dwa małe obrazy testowe i pokaże otrzymane linki.

W tych samych ustawieniach Image ustaw When Insert… na Upload Image. Od tej chwili wklejenie lub przeciągnięcie obrazu do dokumentu przesyła go i wpisuje link do bucketu w Markdown.

Dla dokumentu, który ma już lokalne obrazy, użyj Format > Image > Upload All Local Images.

Domyślnie obrazy trafiają do miejsca docelowego wybranego w pasku menu Aktara i dostają nazwy według jego szablonu ścieżki. Aby wysyłać obrazy z Typory gdzie indziej, dodaj do polecenia opcje:

/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

Zostaw wynik jako zwykłe adresy URL (domyślnie): Typora sama zapisuje Markdown, więc nie dodawaj tu --format ani --json.

• Nie znaleziono polecenia lub node: użyj pełnej ścieżki z which aktar. Wersja z Homebrew ma wpisaną własną ścieżkę do Node, więc działa z Typory od razu. Przy instalacji przez npm uruchamiaj ją jako /path/to/node /path/to/aktar upload.
• Brak połączenia z Aktarem: uruchom aktar login w terminalu i upewnij się, że Aktar działa z włączoną opcją „Zezwalaj na połączenia lokalne”.
• Link otwiera się z błędem Access Denied: przesyłanie się udało, ale bucket nie jest publiczny pod swoim publicznym adresem URL. Zobacz błędy Access Denied.