"Just put your hands over it and play it!"
A guide to piano and music, by contributors from Piano VI's server.
Come help us: https://discord.gg/rEx9Vr662z
This is basically a bog-standard mdBook installation with some custom CSS and the addition of the mdbook-admonish preprocessor. You don't necessarily need Rust or cargo installed on your computer to edit, but it's highly recommended if you want to see changes in a local development server.
For CI/CD, we use a GitHub Actions workflow (stored in mdbook-deploy.yml) which essentially installs mdBook and dependencies, installs mdbook-admonish and mdbook-toc dependencies, builds the HTML output, and deploys it to the gh-pages branch. Since each VM is clean in Actions and dependencies need to be re-installed each time, it might take a few minutes for each deploy to occur (perhaps more than you might be used to).
- Rust 1.82.0
- cargo 1.82.0
- mdBook 0.4.42
- mdbook-admonish 1.18.0
- mdBook-pagetoc*
*Does not require local install or setup.