Сегодня мы решим задачу, как в развернутый BookStack, в созданную страницу вкладывать файлы. Файлы это пояснения к заметке, утилиты, скрипты, бекапы если нужно. Чтобы взглянув на заметку и прочитав ее все было понятно и можно было сразу приступив с помощью нее решению своей задачи.

Задача: Вот я создал страницу в BookStack и хочу внутри нее сделать вложение файлов, т. е. Прикрепить файлы, как это сделать?

ekzorchik@srv-bionic:~$ sudo nano /var/www/html/bookstack/.env
STORAGE_TYPE=local
ekzorchik@srv-bionic:~$ sudo mkdir /var/www/html/bookstack/public/uploads/{images,files}
ekzorchik@srv-bionic:~$ sudo chown -R www-data:www-data /var/www/html/bookstack/public/uploads/
ekzorchik@srv-bionic:~$ sudo nano /etc/php/7.2/apache2/php.ini
;upload_max_filesize = 2M
upload_max_filesize = 1024M
;post_max_size = 8M
post_max_size = 1024M
ekzorchik@srv-bionic:~$ sudo systemctl restart apache2

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

Загружаю файл или через перетаскивание файла вкладываю

я перетащил бекап базы db_bookstack.sql и она успешно загрузилась.

Посмотреть какие элементы загружены:

Прикрепленные элементы в странице

В операционной системе данный файл располагается:

ekzorchik@srv-bionic:~$ sudo apt-get install -y tree
ekzorchik@srv-bionic:~$ sudo tree /var/www/html/bookstack/storage/uploads/files/
/var/www/html/bookstack/storage/uploads/files/
└── 2020-11-Nov
└── ncQDdUhXDVnnuU7c.sql
1 directory, 1 file
ekzorchik@srv-bionic:~$

проверяю md5sum исходного файла который перетащил и перетащенного:

ekzorchik@srv-dbionic:~$ md5sum bookstack/db_bookstack.sql
2770c780b73f93e4b098910a4d8ba586 bookstack/db_bookstack.sql
ekzorchik@srv-bionic:~$ md5sum /var/www/html/bookstack/storage/uploads/files/2020-11-Nov/*.sql
2770c780b73f93e4b098910a4d8ba586 /var/www/html/bookstack/storage/uploads/files/2020-11-Nov/ncQDdUhXDVnnuU7c.sql

они идентичны.

Теперь когда я в книге открываю страницу по левую сторону вижу вложения:

Результат файлов вложений у странице отображаемых по левую сторону

Вообще есть документ где можно настроить и еще что-то

https://www.bookstackapp.com/docs/admin/upload-config/

но как по мне мне нужно было именно как управлять вложениями.

Заметка работоспособна. На этом у меня всё, с уважением автор блога Олло Александр aka ekzorchik.