bard

Crates.iobard
lib.rsbard
version2.0.1
sourcesrc
created_at2020-04-09 21:47:44.2123
updated_at2023-07-01 21:00:14.247565
descriptionCreates PDF and HTML songbooks out of easy-to-write Markdown sources.
homepagehttps://bard.md
repositoryhttps://github.com/vojtechkral/bard
max_upload_size
id228142
size18,018,470
Vojtech Kral (vojtechkral)

documentation

README

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

Commit count: 338

cargo fmt