Импорт и экспорт

Переезд в обе стороны: готовые файлы становятся страницами, а база знаний забирается обычными файлами, которые читаются без Hivelore.

Окно импорта одно, вкладок в нём две — «Из файлов» и «Из Notion». Место назначения и отчёт у них общие, различается только то, откуда берутся страницы; выбранное место действует на обе вкладки.

Импорт файлов

Строка «Импорт файлов» в конце дерева и пункт «Импорт сюда…» в меню строки дерева — тогда страницы лягут внутрь неё. Принимаются PDF, DOCX, HTML, MD, TXT и ZIP с ними внутри.

Файл становится страницей, а не вложением. Её правят, версионируют, на неё ссылаются, она попадает в поиск, граф и корзину. Тем и отличается от подключённого внешнего документа, который остаётся жить в чужом сервисе.

Архив разворачивается в поддерево. Папки становятся страницами, файл index внутри папки — страницей самой папки. Поэтому выгрузка Hivelore импортируется обратно тем же деревом, а markdown-выгрузка из Obsidian или Confluence приезжает своей структурой. Папки глубже восьмого уровня ложатся плоско в корень архива.

Название страницы выбираете вы — заголовок внутри документа или имя файла. Угадать за вас тут нельзя: у одного скана в метаданных лежит «АКТ», доставшийся от шаблона Word, у соседнего метаданных нет вовсе. Второй источник остаётся запасным — пустой заголовок или IMG_0042 уступают место другому.

Импорт идёт на сервере. Файлы загружаются, дальше их разбирает фоновое задание: окно можно закрыть и открыть снова — ход и отчёт дождутся. Один импорт на проект за раз, общий с импортом из Notion. В поиск страницы попадают сами, по мере индексации.

Повторная загрузка того же файла в то же место обновляет ту же страницу, а не заводит вторую. В отчёте это видно построчно:

Один битый файл не отменяет пачку: остальные доезжают.

Ограничения: 50 файлов за раз, 25 МБ на файл, 300 файлов из всех архивов пачки и 200 МБ в распакованном виде.

PDF стоит просмотреть глазами. В нём нет ни заголовков, ни абзацев — только строки с координатами, и структура достраивается эвристикой. Остальные форматы приезжают точно.

Импорт из Notion

Notion переезжает целиком и без промежуточной выгрузки в файлы: Hivelore читает его по API и раскладывает страницы деревом.

Подключение

Настройки → Профиль и подключения → Notion. Нужен токен интеграции, три шага:

1. заведите интеграцию на notion.so/my-integrations и скопируйте её Internal Integration Secret;
2. вставьте его в поле в настройках;
3. в самом Notion откройте нужную страницу → «⋯» → «Connections» → выберите интеграцию.

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

Подключение принадлежит вам, а не проекту: доступ выдало вашему аккаунту ваше рабочее пространство, и одним токеном вы импортируете во все свои проекты. Токен хранится зашифрованным, импорт только читает — в Notion он ничего не меняет. Отвязать — «Отключить Notion» там же.

Сам импорт

Окно импорта, вкладка «Из Notion»: в списке — корневые страницы и базы, которыми вы поделились с интеграцией. Вложенное в списке не показано намеренно — оно приедет вместе с родителем, и отдельная строка предлагала бы привезти его дважды.

Импорт идёт заданием на сервере: вкладку можно закрыть и вернуться, полоса выполнения дождётся сама. Число «всего» при этом растёт по ходу дела, а полоса иногда идёт назад — вложенные страницы находятся только тогда, когда прочитана родительская. Это честнее выдуманного заранее числа.

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

Что переезжает

Абзацы, заголовки, списки всех видов вместе с флажками, блоки кода, цитаты, callout, toggle, разделители, формулы, таблицы и колонки. Правило одно: не терять текст — страница, из которой при переезде молча пропал абзац, хуже страницы с некрасивой ссылкой вместо карточки. Виджеты и встроенные блоки, которых у нас нет, оседают текстом или ссылкой.

• Картинки скачиваются и становятся вложениями Hivelore: ссылки Notion на своё хранилище живут около часа, и оставить их значило бы получить дырявую базу к вечеру. Видео, PDF и файлы остаются ссылками.
• Ссылки между страницами становятся wiki-ссылками — упоминания @Страница, «link to page» и вложенные страницы, если цель едет тем же импортом. Переезжает не только текст, но и связность: граф строится сразу, без ручной перелинковки.
• Записи базы становятся страницами. Сама база — страницей-разделом, каждая её запись — вложенной страницей, свойства записи — таблицей «поле → значение» в начале текста. Запись базы в Notion и есть страница, у неё собственный текст, и сворачивать её в строку таблицы значило бы терять именно его.
• Повторный импорт обновляет те же страницы, а не заводит вторые, — даже если вы их успели передвинуть, в дереве Hivelore или в самом Notion.

Ограничения: 1000 страниц за импорт, 50 выбранных корней, 30 картинок на страницу, 6 уровней вложенности блоков. Один импорт на проект за раз.

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

Экспорт страницы

Меню «⋯» над страницей → «Экспорт» — PDF, DOCX, HTML, Markdown, TXT; рядом пункт «Печать». Доступно всем, включая читателя: забрать документ себе — часть чтения.

Внизу каждого файла — две строки происхождения: когда выгружено и с какого адреса. Файл живёт своей жизнью — уезжает в почту, лежит в чужой папке год, — и вопрос «где оригинал и не устарел ли он» возникает к нему всегда.

Что доезжает: цвета, таблицы, картинки, ссылки на страницы (в PDF, DOCX и HTML … становится настоящей кликаемой ссылкой). Диаграммы едут картинкой во все читающие форматы и исходником в markdown и TXT; в выгруженном файле они всегда светлые, даже если вы работаете в тёмной теме. Блоки кода доезжают текстом: цвета подсветки нет ни в одном файле, но в HTML остаётся класс языка, и принимающая сторона подсветит сама. Ключи секретов выгружаются ссылкой с подписью — сам пароль в файл не попадает, его в Hivelore и нет. Что распускается в обычный текст в читающих форматах: теги и карточки внешних документов. В markdown остаётся всё как есть.

Экспорт всей базы знаний

Настройки → Проект → Общее → «Экспорт базы знаний» → «Скачать архив»: все страницы проекта одним zip, в выбранном формате.

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

• Раскладка архива повторяет дерево. Распакованная папка листается ссылками, как сама база знаний, — в HTML и DOCX ссылки между страницами относительные, и Hivelore для чтения не нужен. В PDF они ведут полным адресом на живую страницу: относительные файловые пути встроенные просмотрщики браузеров не открывают.
• Длинные названия в именах файлов укорачиваются. Проводник Windows не открывает zip целиком, если хоть один путь внутри слишком длинный, а глубокая ветка с длинными названиями до этого предела доходит. Поэтому путь в архиве ограничен: не поместившееся название обрезается, и имя файла кончается меткой вроде ~3fa9c1 — началом идентификатора страницы. По метке видно, что имя укорочено; от выгрузки к выгрузке она та же, и две страницы с одинаковым началом названия не совпадут. Полное название остаётся заголовком внутри файла — при импорте архива обратно оставьте источником названия заголовок документа (так и стоит по умолчанию), и страницы вернутся под своими именами.
• Файл в архиве ровно тот же, что даёт экспорт на самой странице.
• Внешние документы приезжают отдельным файлом со ссылками: сами Google-документы и доски в архив не кладутся — они лежат в чужих сервисах со своими правами.
• Уезжает то, что доступно вам на чтение. Страница, прав на которую нет, попадёт строкой в список «Не выгружено», а не в архив.
• Идёт это минуту-другую и показывает счёт в страницах («14 из 87»); закрытие окна отменяет сборку.

Переезд из другой вики

Из Notion — подключением и вкладкой «Из Notion», см. выше. Из остальных: выгрузить старую базу в markdown, импортировать архивом, а дальше позвать агента — он разложит поддеревья, проставит ссылки и теги и приведёт документы к общему виду. Разбирать выгрузку руками не нужно.