#markdown #music #convert-markdown #pdf #html #compiler #songbooks

bin+lib bard

从易于编写的 Markdown 源文件创建 PDF 和 HTML 歌集

12 个版本 (稳定)

2.0.1 2023 年 7 月 1 日
2.0.0-alpha32023 年 6 月 30 日
2.0.0-alpha12022 年 8 月 13 日
1.3.0 2021 年 7 月 24 日
0.1.0 2020 年 4 月 9 日

119模板引擎

每月 49 次下载

Apache-2.0

10MB
7K SLoC

bard

crates.io CI

Markdown → 歌集。

bard 是一个歌集编译器,它读取 Markdown 文件并生成 PDF、HTML 和 Hovorka 格式的歌集。

bard 读取类似这样的文件

# 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?

... 并创建类似这样的输出

example-output

查看 示例 PDF,来自 示例项目


入门


功能

  • bard 是一个命令行工具
  • 面向项目:单个 bard.toml 定义输入、输出和其他配置
  • 易于使用的源格式:Markdown
  • 输出格式
    • 通过 TeX 生成 PDF
    • HTML
    • Hovorka XML
    • JSON 和 XML 用于机器处理
  • 转调和符号转换
    • 可选自动生成第二套和弦
  • 模板:输出可以通过 Handlebars 模板完全自定义

代码贡献者

cotributors

依赖项

~28–63MB
~886K SLoC