rst_renderer 0.4.2

a reStructuredText renderer
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
118
119
120
121
122
123
124
125
126
127

use std::{borrow::Borrow, io::Write};

use anyhow::Error;

use super::{HTMLRender, HTMLRenderer};

use document_tree::{element_categories as c, elements as e};

macro_rules! impl_html_render_multi {
    (
        $type1:path $( [$($post1:tt)+] )?,
        $( $type:path $( [$($post:tt)+] )? ),+
    ) => {
        impl_html_render_multi!($type1 $([$($post1)+])?);
        $( impl_html_render_multi!($type $([$($post)+])?); )+
    };
    ( $type:path ) => {
        impl_html_render_multi!($type[""]);
    };
    ( $type:path [ $post:expr ] ) => {
        impl HTMLRender for [&$type] {
            fn render_html<W: Write>(&self, renderer: &mut HTMLRenderer<W>) -> Result<(), Error> {
                write_optional_newlines::<$type, _, _>(renderer, self, $post)
            }
        }
        impl HTMLRender for [$type] {
            fn render_html<W: Write>(&self, renderer: &mut HTMLRenderer<W>) -> Result<(), Error> {
                write_optional_newlines::<$type, _, _>(renderer, self, $post)
            }
        }
    };
}

fn write_optional_newlines<R, E, W>(
    renderer: &mut HTMLRenderer<W>,
    elems: &[E],
    post: &str,
) -> Result<(), Error>
where
    R: HTMLRender,
    E: Borrow<R>,
    W: Write,
{
    let many = elems.len() > 1;
    if many {
        write!(renderer.stream, "{post}")?;
    }
    for c in elems {
        c.borrow().render_html(renderer)?;
        if many {
            write!(renderer.stream, "{post}")?;
        }
    }
    Ok(())
}

macro_rules! impl_html_render_multi_body {
    ( $type1:path, $( $type:path ),+ ) => {
        impl_html_render_multi_body!($type1);
        $( impl_html_render_multi_body!($type); )+
    };
    ( $type:path ) => {
        impl HTMLRender for [$type] {
            fn render_html<W>(&self, renderer: &mut HTMLRenderer<W>) -> Result<(), Error>
            where
                W: Write,
            {
                let many = self.len() > 1;
                if many {
                    writeln!(renderer.stream)?;
                }
                let mut footnotes: Vec<&e::Footnote> = vec![];
                for c in self {
                    if let Ok(&c::BodyElement::Footnote(ref f)) = c.try_into() {
                        footnotes.push(f.as_ref());
                        continue;
                    }
                    write_footnotes(renderer, &footnotes)?;
                    c.render_html(renderer)?;
                    if many {
                        writeln!(renderer.stream)?;
                    }
                }
                write_footnotes(renderer, &footnotes)?;
                Ok(())
            }
        }
    };
}

fn write_footnotes<W>(
    renderer: &mut HTMLRenderer<W>,
    footnotes: &[&e::Footnote],
) -> Result<(), Error>
where
    W: Write,
{
    if footnotes.is_empty() {
        return Ok(());
    }
    writeln!(renderer.stream, "<ol>")?;
    for f in footnotes {
        f.render_html(renderer)?;
        writeln!(renderer.stream)?;
    }
    writeln!(renderer.stream, "</ol>")?;
    Ok(())
}

// Impl

impl_html_render_multi!(
    c::TextOrInlineElement,
    c::SubSidebar,
    c::SubLineBlock,
    c::SubBlockQuote,
    c::SubTopic,
    c::SubFigure,
    e::ListItem["\n"],
    e::DefinitionListItem,
    e::Field,
    e::OptionListItem,
    e::Footnote["\n"],
    String
);

impl_html_render_multi_body!(c::StructuralSubElement, c::SubStructure, c::BodyElement);