Typora domyślnie zapisuje wklejone obrazy obok pliku Markdown. To w porządku, dopóki nie opublikujesz dokumentu, nie wkleisz go na GitHuba albo nie wyślesz go komuś: obrazy zostają na Twoim komputerze. Przesyłanie ich do własnego bucketu w trakcie pisania sprawia, że Markdown jest przenośny, a linki wskazują na magazyn, który kontrolujesz.
Zainstaluj i połącz polecenie aktar
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
- W Aktarze otwórz Ustawienia > Integracje, włącz Zezwalaj na połączenia lokalne i skopiuj token.
- Uruchom
aktar loginw terminalu i wklej go. - Sprawdź to poleceniem
aktar upload some-image.png. Powinno wypisać link.
Ustaw aktar jako narzędzie przesyłania obrazów w Typorze
- Otwórz ustawienia Typory (Typora > Settings… na Macu, File > Preferences… na Windows) i przejdź do Image.
- W sekcji Image Uploader wybierz Custom Command.
- 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.
- Kliknij Test Uploader. Typora prześle dwa małe obrazy testowe i pokaże otrzymane linki.
Przesyłaj obrazy automatycznie przy wklejaniu
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.
Wybierz, gdzie trafiają obrazy
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.
Jeśli Test Uploader się nie powiedzie
- 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 loginw 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.
Albo zostaw to Aktarowi
Aktar przechowuje klucze do Twojego magazynu i zajmuje się przesyłaniem, a aktar tylko przekazuje mu obrazy, więc Typora nigdy nie potrzebuje Twoich kluczy. Ten sam bucket działa z paska menu, globalnego skrótu, Raycast i telefonu, a każdy obraz pojawia się w historii Aktara.
Częste pytania
Czy to działa z Cloudflare R2, Backblaze B2 i MinIO?
Czy potrzebuję PicGo lub wtyczki?
Czy przesłane obrazy mogą wygasać?
--expires 30, aby bucket usunął je po 30 dniach. Obrazy w publikowanych dokumentach zwykle jednak warto zachować.