aphid 0.2.2

A static site generator for blogs and wikis, with wiki-links across both.
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

use pulldown_cmark::{CowStr, Event, LinkType, Tag};

/// Rewrite relative URLs in link and image events to be root-relative.
/// A path like `static/blog/image.png` becomes `/static/blog/image.png`.
/// Already-absolute paths (`/...`), external URLs (`http(s)://`), fragments
/// (`#`), and schemes like `mailto:` are left untouched.
pub fn rewrite_relative_urls(events: Vec<Event<'_>>) -> Vec<Event<'_>> {
    events
        .into_iter()
        .map(|event| match event {
            Event::Start(Tag::Link {
                link_type,
                dest_url,
                title,
                id,
            }) if !matches!(link_type, LinkType::WikiLink { .. }) && needs_rewrite(&dest_url) => {
                Event::Start(Tag::Link {
                    link_type,
                    dest_url: prepend_slash(dest_url),
                    title,
                    id,
                })
            }
            Event::Start(Tag::Image {
                link_type,
                dest_url,
                title,
                id,
            }) if needs_rewrite(&dest_url) => Event::Start(Tag::Image {
                link_type,
                dest_url: prepend_slash(dest_url),
                title,
                id,
            }),
            other => other,
        })
        .collect()
}

fn needs_rewrite(url: &str) -> bool {
    !url.is_empty()
        && !url.starts_with('/')
        && !url.starts_with('#')
        && !url.starts_with("http://")
        && !url.starts_with("https://")
        && !url.contains(':')
}

fn prepend_slash(url: CowStr<'_>) -> CowStr<'_> {
    CowStr::from(format!("/{url}"))
}

#[cfg(test)]
mod tests {
    use super::*;
    use pulldown_cmark::{Options, Parser};

    fn render(input: &str) -> String {
        let events: Vec<_> = Parser::new_ext(input, Options::empty()).collect();
        let events = rewrite_relative_urls(events);
        crate::markdown::render_html(events)
    }

    #[test]
    fn relative_image_gets_leading_slash() {
        let html = render("![alt](static/blog/image.png)");
        assert!(html.contains("src=\"/static/blog/image.png\""));
    }

    #[test]
    fn relative_link_gets_leading_slash() {
        let html = render("[click](pages/about.html)");
        assert!(html.contains("href=\"/pages/about.html\""));
    }

    #[test]
    fn root_relative_unchanged() {
        let html = render("![alt](/static/blog/image.png)");
        assert!(html.contains("src=\"/static/blog/image.png\""));
    }

    #[test]
    fn absolute_url_unchanged() {
        let html = render("[ex](https://example.com/img.png)");
        assert!(html.contains("href=\"https://example.com/img.png\""));
    }

    #[test]
    fn fragment_unchanged() {
        let html = render("[top](#heading)");
        assert!(html.contains("href=\"#heading\""));
    }

    #[test]
    fn mailto_unchanged() {
        let html = render("[mail](mailto:a@b.c)");
        assert!(html.contains("href=\"mailto:a@b.c\""));
    }
}