BookStack — база знаний на собственном сервере

Подходить к работе с базами знаний можно по-разному. Кому-то нравится обычное хранение, как в Notion, кто-то жить не может без сложных графов. А можно подойти к этому вопросу, как к книгам в библиотеке.

И для такого подхода есть сервис BookStack — опенсорсное решение для создания и ведения собственной базы знаний с поддержкой русского языка, возможностью поиска и построением связей между данными.

💡

Лучшие альтернативы Confluence: обзор и сравнение

Что требуется для поднятия на своём сервере

Чтобы всё заработало, вам понадобится сервер на Ubuntu. В этом случае установка произойдёт практически в автоматическом режиме. Но есть скрипты и для других Unix-ОС. Из остальных требований остаются:

PHP >= 8.2
MySQL >= 8.0 или MariaDB >= 10.6
Git Version Control
Composer >= v2.2.0
PHP-совместимый сервер

Сама установка выполняется одной командой:

git clone https://source.bookstackapp.com/bookstack.git --branch release --single-branch bookstack

Если вы пока не готовы разворачивать свою копию BookStack, то её можно попробовать в демке по этой ссылке.

Логика работы

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

И первое, что вас ждёт после авторизации (если уже есть какие-то данные), — это три колонки:

Недавние книги.
Недавно обновлённые страницы.
Недавние действия пользователей.

Сама логика хранения данных следующая: Полки > Книги > Страницы. Т.е. есть общий проект (Полка), в нём — папки (Книги), а в них — заметки (Страницы).

Из-за этого сразу становится явным одно из ограничений BookStack. Нельзя создавать папки с множественным вложением. То есть нельзя создать книгу внутри книги. Но «поставить» несколько книг на полку можно.

Какие есть возможности

При создании Полки, кроме её названия, можно задать различные теги для связи данных. Также к Полке и её содержимому можно задать различные права доступа, если вы работаете в команде.

Далее на Полки следует добавить Книги, а у каждой книги есть Содержание. В качестве глав используются названия заметок.

Внутри главы может быть как одна страница, так и сразу несколько, что отражается в блоке Навигации по книге.

При редактировании самой страницы вам доступны все возможности Markdown-разметки, а также добавление необходимых вложений. Если вы не очень знакомы с Markdown, то есть обычная панель форматирования текста.

Для вложений нет никаких ограничений по объёму или типу файлов. Всё-таки вся инфа хранится у вас на сервере.

Кроме этого, BookStack поддерживает простое рисование и создание различных диаграмм на базе diagrams.net.

Как и при чтении реальной книги, в Книге BookStack внизу будет навигация по страницам для быстрого перелистывания.

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