Картинки и вложения

Половина инженерного знания — картинки: схема экрана, скриншот ошибки, диаграмма. Они живут в самой странице, а не ссылкой во внешний сервис, которая через полгода перестанет открываться.

Как вставить

Четыре пути, все ведут в одно место:

пункт /картинка в слэш-меню;
перетащить файл в текст;
Ctrl+V — скриншот прямо из буфера обмена;
по внешней ссылке — вкладка «Вставить» в блоке картинки.

Под картинкой заполняется подпись. Она не косметическая: подпись попадает в поиск, а адрес файла — нет.

Форматы и размер

PNG, JPEG, GIF и WebP, до 25 МБ на файл. SVG не принимается намеренно: он умеет исполнять скрипты в домене приложения.

Тип определяется по самому файлу, а не по его имени и не по тому, что заявил браузер: незнакомая сигнатура — отказ, а не «положим как есть».

Кто увидит

Доступ к картинке равен доступу на чтение страницы, в которую она вставлена. Своих прав у вложений нет вовсе: тот же уровень, что при открытии документа, — максимум из роли в проекте, гранта на странице и уровня ссылки. Нет доступа — страница и её вложения просто не существуют для запроса.

Гость по ссылке картинки видит — иначе расшаренная страница ломалась бы: текст на месте, картинки битые.

Байты идут через сервис, а не напрямую из хранилища, и подписанных ссылок с отложенным сроком жизни нет. Практическое следствие: отзыв доступа действует мгновенно, окна, в котором ушедший сотрудник ещё что-то дочитывает, не существует. Второе следствие: адрес картинки, скопированный из текста, сам по себе ничего не открывает.

Что попадает в текст

Обычная markdown-разметка ![подпись](адрес) — своей нотации у картинок нет. Выгруженный .md остаётся правильным markdown и читается вне Hivelore, хотя сам файл по такому адресу без входа не отдаётся.

Не переживают сохранение только ширина картинки и признак предпросмотра — записать их в markdown некуда.

Экспорт и поиск

Картинки попадают в выгрузку в PDF, DOCX и HTML. В индекс поиска уходит подпись, а разметка вырезается — иначе адрес файла оказался бы в сниппете выдачи и в контексте ассистента.

В местах, где тело страницы показывается сырым текстом (история версий, дифф предложения, удалённая страница), картинка остаётся разметкой — там это исходник, а не документ.

Чего пока нет

Блока файла (PDF, DOCX, ZIP приложением к странице) — следующий этап работы; сегодня вкладывают только изображения.
Сборки мусора. Вставленная и тут же отменённая картинка остаётся лежать в хранилище; вреда от этого нет, но и счётчика объёма пока нет тоже.
Ресайза и сжатия на сервере. Картинка отдаётся ровно такой, какой загружена, — большие скриншоты стоит уменьшать до вставки.
Вставки картинок агентом. Агент правит текст; файлы приносит человек.