Рисунки и диаграммы
BookStack поддерживает создание и редактирование рисунков и диаграмм благодаря интеграции с diagrams.net. Эта интеграция предлагает мощные инструменты для рисования и построения диаграмм, подходящие для множества сценариев. По умолчанию BookStack использует онлайн-версию diagrams.net, но администратор может изменить настройки.
Вставка, редактирование и управление рисунками
Визуальный редактор (WYSIWYG)
При работе с визуальным редактором рисунки можно создавать и вставлять на страницу с помощью кнопки на панели инструментов редактора. Эта кнопка расположена в выпадающем меню рядом с таблицами и ссылками:
Чтобы открыть существующий рисунок для редактирования, просто дважды щелкните на нём в редакторе. Либо можно нажать кнопку рисования на панели инструментов, когда рисунок выбран. При сохранении изменений рисунка новая версия сохраняется как отдельный файл изображения в BookStack, вместо перезаписи существующего рисунка. Это сделано для сохранения истории версий с сохранением старых рисунков.
Существующие файлы рисунков можно повторно использовать или удалить через менеджер рисунков. Его можно вызвать через выпадающее меню рядом с кнопкой рисования на панели инструментов:
Редактор Markdown
В редакторе Markdown рисунок можно вставить с помощью действия, расположенного над областью ввода Markdown-кода:
Чтобы открыть существующий рисунок для редактирования, просто дважды щелкните на изображении в окне предварительного просмотра, и существующий рисунок откроется для редактирования. При сохранении изменений рисунок сохраняется как отдельный файл изображения, что позволяет сохранять историю версий.
Хранение и формат файлов рисунков
Рисунки, созданные с помощью интеграции с diagrams.net, сохраняются в систему BookStack с использованием той же схемы хранения, что и для обычных изображений.
Для переносимости и совместимости рисунки сохраняются в формате PNG-файлов, причем оригинальные данные diagrams.net встраиваются внутрь изображения. Поскольку данные рисунка встроены в PNG-изображение, такие рисунки можно продолжать редактировать в любом экземпляре diagrams.net, просто перетащив или импортировав файл изображения.