Download remote files from Bookstack instance, that you may not have, along with sending any changes to the remote.
Run with pipx install . inside the project to install to your machine.
You can use a .env file in the root of your project for the following secrets:
BOOKSTACK_BASE_URL="https://demo.bookstack.com"
BOOKSTACK_TOKEN_ID=<your_bookstack_api_token_id>
BOOKSTACK_TOKEN_SECRET=<your_bookstack_api_token_secret>
or you may choose to use whatever secret manager you want, like Doppler, so long as it sets those environment variables.
Make sure to setup a conf.toml in the root of your project, example:
[wiki]
url = "https://demo.bookstack.com"
path = "/home/user/notes/"
[wiki.excluded]
shelves = ["private"]Any shelves in wiki.excluded.shelves will not be uploaded to Bookstack.
The structure of the Obsidian Vault is pretty specific as it mirrors the Bookstack structure to be as in sync as possible.
- shelves
-- books
--- pages.md
I may in the future add extra support for pages with no books, along with more nested structure. Bookstack does currently support "chapters" in Books, but this does not support that currently.
Calls local and remote
Pulls down any missing local files
Pushes up any missing files in the remote
Requires either the --remote or the --local flag.
If --remote is specified, any files which have been updated locally will be changed in the remote and vice-versa for --local.
- Add support for pages with no Books