bard 2.0.1

Creates PDF and HTML songbooks out of easy-to-write Markdown sources.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

//! XML Renderer.

use std::fs::File;
use std::io;
use std::io::Write;

use super::Render;
use super::RenderContext;
use crate::app::App;
use crate::prelude::*;
use crate::ProgramMeta;

use crate::project::Format;
use crate::project::Output;
use crate::util::xml_support::*;
use crate::xml_write;

xml_write!(struct ProgramMeta {
    name,
    version,
    description,
    homepage,
    authors,
} -> |w| {
    w.tag("program")
        .content()?
        .field(name)?
        .field(version)?
        .field(description)?
        .field(homepage)?
        .field(authors)?
});

impl XmlWrite for Format {
    fn write<W>(&self, mut writer: &mut Writer<W>) -> quick_xml::Result<()>
    where
        W: io::Write,
    {
        writer.write_text(self)
    }
}

xml_write!(struct Output {
    file,
    template,
    format,
    toc_sort,
    toc_sort_key,
    sans_font,
    font_size,
    dpi,
    tex_runs,
    script,
    book_overrides,
} -> |w| {
    let _ = file;
    let _ = template;
    let _ = book_overrides;
    w.tag("output")
        .content()?
        .field_opt(format)?
        .field(sans_font)?
        .field(font_size)?
        .field(toc_sort)?
        .field(toc_sort_key)?
        .field_opt(dpi)?
        .field(tex_runs)?
        .field_opt(script)?
});

xml_write!(struct RenderContext<'a> {
    book,
    songs,
    songs_sorted,
    notation,
    output,
    program,
} -> |w| {
    w.tag("songbook")
        .attr(notation)
        .content()?
        .comment("The [book] section in bard.toml")?
        .field(book)?
        .comment("References to <song> elements in alphabetically-sorted order")?
        .value_wrap("songs-sorted", songs_sorted)?
        .comment("Fields in the [[output]] section in bard.toml")?
        .value_wrap("output", output)?
        .comment("Software metadata")?
        .value(program)?
        .comment("Song data")?
        .field(songs)?
});

#[derive(Debug, Default)]
pub struct RXml;

impl RXml {
    pub fn new() -> Self {
        Self
    }
}

impl Render for RXml {
    fn render(&self, _app: &App, output: &Path, context: RenderContext) -> anyhow::Result<()> {
        File::create(output)
            .map_err(Error::from)
            .and_then(|f| {
                let mut writer = Writer::new_with_indent(f, b' ', 2);
                context.write(&mut writer)?;

                let mut f = writer.into_inner();
                f.write_all(b"\n")?;
                Ok(())
            })
            .with_context(|| format!("Error writing output file: {:?}", output))
    }
}