Рисунки и диаграммы

BookStack поддерживает создание и редактирование рисунков и диаграмм благодаря интеграции с diagrams.net. Эта интеграция предлагает мощные инструменты для рисования и построения диаграмм, подходящие для множества сценариев. По умолчанию BookStack использует онлайн-версию diagrams.net, но администратор может изменить настройки.

Вставка, редактирование и управление рисунками

Визуальный редактор (WYSIWYG)

При работе с визуальным редактором рисунки можно создавать и вставлять на страницу с помощью кнопки на панели инструментов редактора. Эта кнопка расположена в выпадающем меню рядом с таблицами и ссылками:

Чтобы открыть существующий рисунок для редактирования, просто дважды щелкните на нём в редакторе. Либо можно нажать кнопку рисования на панели инструментов, когда рисунок выбран. При сохранении изменений рисунка новая версия сохраняется как отдельный файл изображения в BookStack, вместо перезаписи существующего рисунка. Это сделано для сохранения истории версий с сохранением старых рисунков.

Существующие файлы рисунков можно повторно использовать или удалить через менеджер рисунков. Его можно вызвать через выпадающее меню рядом с кнопкой рисования на панели инструментов:

Редактор Markdown

В редакторе Markdown рисунок можно вставить с помощью действия, расположенного над областью ввода Markdown-кода:

Чтобы открыть существующий рисунок для редактирования, просто дважды щелкните на изображении в окне предварительного просмотра, и существующий рисунок откроется для редактирования. При сохранении изменений рисунок сохраняется как отдельный файл изображения, что позволяет сохранять историю версий.

Хранение и формат файлов рисунков

Рисунки, созданные с помощью интеграции с diagrams.net, сохраняются в систему BookStack с использованием той же схемы хранения, что и для обычных изображений.

Для переносимости и совместимости рисунки сохраняются в формате PNG-файлов, причем оригинальные данные diagrams.net встраиваются внутрь изображения. Поскольку данные рисунка встроены в PNG-изображение, такие рисунки можно продолжать редактировать в любом экземпляре diagrams.net, просто перетащив или импортировав файл изображения.