wcl_wdoc 0.9.0-alpha

WCL documentation format — build structured docs with WCL, render to HTML
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

use std::fmt::Write;

use crate::model::ContentBlock;

/// Render a content block to HTML.
/// The block's `rendered_html` is already produced by the template function.
/// We wrap it with style classes and/or ID attributes if applicable.
pub fn render_content(block: &ContentBlock, out: &mut String) {
    let id_attr = block
        .id
        .as_ref()
        .map(|id| format!(" id=\"{id}\""))
        .unwrap_or_default();

    if let Some(style) = &block.style {
        // Use the leaf name for CSS classes (strip namespace prefix)
        let css_kind = block.kind.rsplit("::").next().unwrap_or(&block.kind);
        writeln!(
            out,
            "<div{id_attr} class=\"wdoc-style-{style}--{css_kind}\">{}</div>",
            block.rendered_html
        )
        .unwrap();
    } else if !id_attr.is_empty() {
        writeln!(out, "<div{id_attr}>{}</div>", block.rendered_html).unwrap();
    } else {
        out.push_str(&block.rendered_html);
        out.push('\n');
    }
}