ftml 1.41.0

Foundation Text Markup Language - a library to render Wikidot text as HTML
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
128
129

/*
 * render/html/element/text.rs
 *
 * ftml - Library to parse Wikidot text
 * Copyright (C) 2019-2026 Wikijump Team
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
 */

use super::prelude::*;

pub fn render_wikitext_raw(ctx: &mut HtmlContext, text: &str) {
    debug!("Escaping raw string '{text}'");

    match ctx.layout() {
        Layout::Wikidot => {
            ctx.html()
                .span()
                .attr(attr!("style" => "white-space: pre-wrap;"))
                .contents(text);
        }
        Layout::Wikijump => {
            ctx.html()
                .span()
                .attr(attr!("class" => "wj-raw"))
                .contents(text);
        }
    }
}

pub fn render_email(ctx: &mut HtmlContext, email: &str) {
    debug!("Rendering email address '{email}'");

    match ctx.layout() {
        Layout::Wikidot => {
            ctx.html()
                .span()
                .attr(attr!(
                    "class" => "wiki-email",
                    "style" => "visibility: visible;",
                ))
                .inner(|ctx| {
                    ctx.html()
                        .a()
                        .attr(attr!("href" => "mailto:" email))
                        .contents(email);
                });
        }
        Layout::Wikijump => {
            // Since our usecase doesn't typically have emails as real,
            // but rather as fictional elements, we're just rendering as text.

            ctx.html()
                .span()
                .attr(attr!("class" => "wj-email"))
                .contents(email);
        }
    }
}

pub fn render_code(ctx: &mut HtmlContext, language: Option<&str>, contents: &str) {
    debug!(
        "Rendering code block (language {})",
        language.unwrap_or("<none>"),
    );
    let index = ctx.next_code_snippet_index();
    ctx.handle().post_code(index, contents);

    let class = {
        let mut class = format!("wj-code wj-language-{}", language.unwrap_or("none"));
        class.make_ascii_lowercase();
        class
    };

    ctx.html()
        .element("wj-code")
        .attr(attr!("class" => &class))
        .inner(|ctx| {
            // Panel for holding additional features
            ctx.html()
                .div()
                .attr(attr!(
                    "class" => "wj-code-panel",
                ))
                .inner(|ctx| {
                    let button_title = ctx
                        .handle()
                        .get_message(ctx.language(), "button-copy-clipboard");

                    // Copy to clipboard button
                    ctx.html()
                        .element("wj-code-copy")
                        .attr(attr!(
                            "type" => "button",
                            "class" => "wj-code-copy",
                            "title" => button_title,
                        ))
                        .inner(|ctx| {
                            ctx.html().sprite("wj-clipboard");
                            // Hidden normally, shown when clicked
                            ctx.html().sprite("wj-clipboard-success");
                        });

                    // Span showing name of language
                    ctx.html()
                        .span()
                        .attr(attr!(
                            "class" => "wj-code-language",
                        ))
                        .contents(language.unwrap_or(""));
                });

            // Code block containing highlighted contents
            ctx.html().pre().inner(|ctx| {
                ctx.html().code().contents(contents);
            });
        });
}