BookStack Site, Documentation & Blog

This project holds all the data for the https://www.bookstackapp.com/ website.

This site is built using Hugo. Images are stored using git-lfs. The "extended" version of hugo must be used (Has support for certain features like WebP resize).

Data Locations

• Blog Posts - content/posts
• Docs - content/docs
• Theme - themes/bookstack

Hacks

The website also contains a repository of customization hacks which can be found at the /hacks part of the site. These are managed via a separate "Hacks" repo which is part of this repository as a git submodule. This is included into this site repo as a module mount.

Theme

The theme is custom made with snippets taken from the hugo capser theme.

SCSS is used for the styling. Install NPM dependencies via npm install or yarn then you can use npm run build to build the css and site once or npm run dev to watch for changes.

Search

Search is performed using webidx, which essentially builds a sqlite database search index. This is then queried via a php file (static/search.php in theme) with results passed back to the front-end JS logic.

This files required are all in this repo, and hacked to suit our use-case. The script to build the index is located at search/webidx.pl, and can be ran via the npm script

npm run build:search

Note: you may need to install some dependencies to run the script see the search/webidx.pl for more information.

The above command will build the sqlite index database to static/search.db, intended to be deployed to production.

Much of the search UI handling logic can be found in our themes/bookstack/static/js/scripts.js file.

Local Dev Server

A Docker-based environment is available to serve the built site locally. Once the site has been built (via Hugo), run:

docker compose up

The site will be accessible at http://localhost:8066. The ./public folder (Hugo's build output) is served as the document root.