/bard

Markdown-based songbook compiler.

Primary LanguageRustApache License 2.0Apache-2.0

bard

crates.io CI

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:

example-output

Check out the Example PDF from the Example project.

Getting Started

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

cotributors