bard is both an executable binary that can be run, and a library that can be used in Rust programs.
Installing bard tex-mock executables
Assuming you have Rust/Cargo installed , run this command in a terminal:
cargo install bard
It will make bard tex-mock commands available in your PATH if you've allowed the PATH to be modified when installing Rust . cargo uninstall bard uninstalls.
Adding bard library as a dependency
Run this command in a terminal, in your project's directory:
cargo add bard
To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:
bard = "2.0.1"
The bard library will be automatically available globally.
Read the bard library documentation .
Back to the crate overview .
Readme
bard
Markdown → songbooks.
bard is a songbook compiler that reads Markdown files and produces songbooks in PDF, HTML, and Hovorka .
bard reads files like this:
# Wild Mountain Thyme
## Irish & Scottish traditional
1. Oh the ` G` summer ` C` time ` G` has come
And the ` C` trees are sweetly ` G` bloomin'
And the ` C` wild ` G` mountain ` Em` thyme
Grows ` C` around the ` Am` bloomin' ` C` heather
Will ye ` G` go ` C` lassie ` G` go?
> And we'll ` C` all go ` G` together to pull ` C` wild ` G` mountain ` Em` thyme
All ` C` around the ` Am` bloomin' ` C` heather, will ye ` G` go ` C` lassie ` G` go?
... and creates output like this:
Check out the Example PDF
from the Example project .
Features
bard is a command-line tool
Project-oriented: A single bard.toml defines inputs, outputs and other configuration
Easy-to-use source format: Markdown
Output formats:
PDF via TeX
HTML
Hovorka XML
JSON and XML for machine processing
Transposition and notation conversion
Optional auto-generated second chord set
Templating: Outputs are fully customizable with Handlebars templates
Code Contributors