Плагин для 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 скачивание бесплатно.