Плагін для Obsidian
Aktar для Obsidian
Нехай нотатки лишаються легкими, а вкладення зберігаються у вашому бакеті S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces чи MinIO. Вставте або перетягніть файл, і він вирушить у бакет. Перенесіть вкладення, які вже маєте. Кожне посилання є звичайною URL-адресою https://, що працює і з плагіном, і без нього.
Безплатно й з відкритим кодом. Комп’ютер, iPhone, iPad і Android, Obsidian 1.11.4 або новіший.
Звичайні посилання, жодної прив’язки
Aktar замінює вбудовування на стандартне зображення Markdown з URL-адресою бакета. Розмір і підпис зберігаються, і нотатка виглядає так само.
![[IMG_2041.png|300]]- Нотатки важать кілька кілобайтів і синхронізуються так само, як зараз: через Obsidian Sync, iCloud, Git чи будь-що інше.
- Посилання працює в будь-якій програмі для Markdown, на GitHub, у браузері та в Obsidian без плагіна. Видаліть плагін, і нічого не зламається.
- Передумати можна будь-коли: Bring files back завантажує файли у сховище й перетворює посилання назад на звичайні посилання на вкладення.
Усе, що він уміє
Плагін використовує ті самі цілі, шаблони шляхів і правила, що й програми Aktar, тож файл, вивантажений з Obsidian, потрапляє туди ж, куди й файл з Mac чи телефона.
-
Вставлення й перетягування
Вставлений чи перетягнутий файл одразу з’являється в нотатці як заповнювач і стає посиланням, щойно вивантажиться. Виберіть, що надсилати в бакет під час вставлення чи перетягування: зображення, усі файли або нічого, і задайте типову ширину для нових вбудованих зображень.
-
Перенесення наявних вкладень
Перенесіть вкладення однієї нотатки або всього сховища. Пробний запуск заздалегідь показує кожен файл і кожну нотатку, що зміняться. Посилання у властивостях (front matter), блоках коду й на полотнах лишаються як є, разом з їхніми файлами. Локальні копії йдуть у кошик або лишаються, якщо вам так зручніше.
-
Скасування будь-якого перенесення
Undo the last move to the bucket завантажує файли назад у сховище й повертає кожне посилання до попереднього вигляду.
-
Повернення файлів
Завантажте файли нотатки з бакета у сховище. Посилання стануть звичайними посиланнями на вкладення, записаними так, як задано в налаштуваннях посилань Obsidian: вікіпосилання чи Markdown, найкоротший або відносний шлях.
-
Автоматичне перенесення нових вкладень
Фото, додані на телефоні, або файли, які інші плагіни зберігають у сховище, переносяться в бакет, щойно нотатка їх вбудовує. Файли, на які не посилається жодна нотатка, лишаються на місці. За бажання обмежте це однією папкою.
-
Приватні бакети
У нотатках лишаються звичайні посилання, а плагін показує файли через URL-адреси, підписані на вашому пристрої й чинні одну годину. Без ваших ключів їх ніхто не відкриє.
-
Бібліотека
Бічна панель із трьома видами: які файли бакета використовують ваші нотатки й де, папки й файли бакета та черга вивантажень. Знайдіть файли, на які вже не посилається жодна нотатка, і видаліть їх разом після підтвердження.
-
Дії з посиланням
Клацніть посилання правою кнопкою, щоб скопіювати його, скопіювати посилання, чинне 1 годину, 1 день або 7 днів, відкрити його, повернути файл у сховище чи видалити його з бакета. Перед видаленням плагін покаже, які нотатки посилаються на файл.
-
Менші фото
Перед вивантаженням фото можна перетворити на WebP, це приблизно третина розміру JPEG за тієї самої якості, і зменшити до 3840, 2560, 1920, 1280 або 1024 пікселів. GIF і SVG лишаються як є. Там, де пристрій не вміє створювати WebP (iPhone, iPad), фото стають JPEG.
-
Без геоданих у фото
Місце зйомки видаляється, перш ніж фото залишить пристрій. Саме зображення не змінюється.
-
Працює офлайн
Переглянуті зображення зберігаються на пристрої, у межах вибраного вами обсягу, тож нотатки показують їх без з’єднання. Вивантаження чекають у черзі, яка переживає втрату мережі й перезапуск Obsidian, і вирушають самі, коли з’єднання повернеться.
-
Працює з програмою Aktar
На Mac чи ПК з Aktar під’єднайте плагін до програми одним клацанням. Тоді вивантаження йдуть через Aktar, з його цілями, ключами, історією та хуками, а Obsidian ніколи не бачить ключів.
-
Публікація нотатки
Перетворіть нотатку на вебсторінку у вашому бакеті разом із зображеннями, і посилання буде скопійовано. Виберіть постійне посилання або таке, що працює 7 днів (у приватному бакеті завжди 7 днів). Сторінка не може запускати скрипти, а Take down її видаляє.
-
Резервна копія сховища
ZIP-архів усього сховища щодня або щотижня вирушає у ваш бакет під назвою, яку ніхто не вгадає, і зберігаються 3, 7, 14 або 30 найновіших копій. Увімкніть це на одному пристрої, який найчастіше ввімкнений. Папка налаштувань Obsidian не входить у копію, якщо ви її не додасте, адже інші плагіни можуть зберігати там паролі.
-
Ваша структура папок
Типово кожне сховище має власну папку в бакеті,
obsidian/{vault}/{year}/{month}/{short}.{ext}. Використовуйте назву чи папку нотатки, дати, початкову назву файлу або короткий код. Перенесені файли отримують назви, що залежать лише від самого файлу, тож два синхронізовані пристрої, які переносять той самий файл, запишуть той самий об’єкт і ті самі посилання. -
На кожному пристрої
Той самий плагін працює на Mac, Windows і Linux, а також в Obsidian для iPhone, iPad і Android. Цілі синхронізуються разом зі сховищем, ключі ні: кожен пристрій отримує їх один раз за допомогою коду перенесення.
Налаштування
Встановіть Aktar зі сторонніх плагінів Obsidian (Settings › Community plugins › Browse) і ввімкніть його. Потім додайте ціль одним із трьох способів.
З програми Aktar
- В Aktar на Mac, ПК, iPhone чи телефоні з Android відкрийте ціль і виберіть Перенести на інший пристрій. Скопіюйте посилання для перенесення.
- В Obsidian відкрийте Settings › Aktar › Add from Aktar app. Посилання підставиться з буфера обміну.
- Введіть 12-символьний код, який показує Aktar. Ключі передаються зашифрованими, і ціль готова.
Під’єднання до Aktar на цьому комп’ютері
- Встановіть Aktar для Mac 0.19 або Windows 0.12 чи новішу версію й додайте в ньому ціль.
- В Obsidian відкрийте Settings › Aktar › Aktar app і натисніть Connect.
- Натисніть Connect у вікні, яке покаже Aktar. Його цілі з’являться в плагіні, а вивантаження йтимуть через програму.
Вручну
- Виберіть Add manually у Settings › Aktar.
- Введіть кінцеву точку, бакет, регіон, публічну URL-адресу й ключі. Посібники з налаштування показують, де знайти їх у кожного провайдера.
- Перевірте з’єднання й збережіть.
Команди
Кожна дія є в палітрі команд, тож їй можна призначити сполучення клавіш у Settings › Hotkeys. Найпотрібніші є й у контекстному меню редактора.
- Upload a file into this note
- Виберіть файл і вивантажте його в нотатку там, де курсор.
- Move this note’s attachments to the bucket
- Переносить вкладення відкритої нотатки після пробного запуску.
- Move attachments to the bucket…
- Переносить вкладення з усього сховища чи з папки після пробного запуску.
- Bring this note’s files back into the vault
- Завантажує файли відкритої нотатки з бакета у сховище й перетворює посилання на посилання на вкладення.
- Undo the last move to the bucket
- Скасовує останнє перенесення: файли повертаються, а посилання стають такими, як були.
- Open the library
- Відкриває бібліотеку на бічній панелі.
- Publish this note as a web page
- Перетворює відкриту нотатку на вебсторінку у вашому бакеті й копіює її посилання.
- Take down this note’s web page
- Видаляє вебсторінку відкритої нотатки з бакета.
- Back up the vault now
- Одразу архівує сховище в бакет, незалежно від розкладу.
- Retry uploads
- Повторює вивантаження, що очікують.
- Save failed uploads into the vault instead
- Зберігає у сховище вивантаження, які постійно не вдаються, щоб нічого не загубилося.
- Add a destination from an Aktar app
- Додає ціль за посиланням і кодом перенесення.
Ключі лишаються на пристрої
Цілі зберігаються в налаштуваннях плагіна, які синхронізуються разом зі сховищем. Ключі туди ніколи не потрапляють. Вони зберігаються в захищеному сховищі секретів Obsidian на кожному пристрої, яке не синхронізується, тож сховище, яким ви ділитеся чи яке лежить у Git, не містить ключів.
Пристрій, на якому є ціль, але немає її ключів, повідомить про це й попросить код перенесення. Коли плагін під’єднано до програми Aktar, Obsidian узагалі не бачить ключів.
До чого він під’єднується
Лише до кінцевих точок сховищ і публічних URL-адрес доданих вами цілей, а на комп’ютері ще до програми Aktar на 127.0.0.1, якщо ви її під’єднали. Жодного сервера Aktar посередині, жодного облікового запису, аналітики чи телеметрії.
Плагін отримує список файлів сховища, щоб знати, які нотатки посилаються на який файл, і у ваш бакет потрапляють лише файли, які ви вивантажуєте, переносите чи включаєте в резервну копію. Буфер обміну він читає один раз, коли ви відкриваєте Add from Aktar app, щоб підставити посилання для перенесення.
Вимоги
- Obsidian 1.11.4 або новіший на Mac, Windows, Linux, iPhone, iPad чи Android
- Бакет в Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, MinIO чи іншому S3-сумісному сервісі, з публічною URL-адресою або приватний
- За бажання: Aktar для Mac 0.19 або Windows 0.12 чи новіша версія, щоб під’єднатися одним клацанням
Запитання
Чи працюватимуть нотатки без плагіна?
Так. Кожне посилання є звичайним посиланням Markdown на ваш бакет, тож нотатки показують зображення в будь-якій програмі для Markdown, в інтернеті й в Obsidian без Aktar. Плагін потрібен лише для файлів у приватному бакеті, бо для них потрібна підписана URL-адреса.
Що стається з файлами в моєму сховищі?
Під час перенесення локальні копії йдуть у кошик Obsidian або лишаються, якщо вибрати Keep it in the vault too. Файли, на які не посилається жодна нотатка, і файли, на які посилаються властивості, код чи полотна, лишаються на місці.
Чи можна все повернути?
Так. Скасуйте останнє перенесення, поверніть файли однієї нотатки або повертайте файли по одному з меню посилання. Файли завантажуються з вашого бакета, а посилання знову стають звичайними посиланнями на вкладення.
Чи працює він з Obsidian Sync, iCloud або Git?
Так. Він не замінює вашу синхронізацію, а робить менше те, що синхронізується. Два пристрої, які переносять той самий файл, записують той самий об’єкт і те саме посилання, тож не конфліктують.
Скільки це коштує?
Плагін безплатний і з відкритим кодом. Ви платите своєму провайдеру сховища за те, що зберігаєте, а в Cloudflare R2 завантаження безплатне.