html-generator 0.0.5

A robust Rust library designed for transforming Markdown into SEO-optimized, accessible HTML. Featuring front matter extraction, custom header processing, table of contents generation, and performance optimization for web projects of any scale.
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

// SPDX-License-Identifier: Apache-2.0 OR MIT
// Copyright (c) 2025 HTML Generator. All rights reserved.

//! Front matter extraction: YAML, TOML, and JSON metadata parsing.
//!
//! Supports nested structures and arrays via industrial-strength
//! parsers (the inlined private `yaml` module for YAML, the `toml`
//! crate for TOML).
//!
//! Run: `cargo run --example frontmatter`

#[path = "support.rs"]
mod support;

use html_generator::utils::{
    extract_front_matter, extract_front_matter_data,
};

fn main() {
    support::header("html-generator -- frontmatter");

    // ── YAML front matter (---) ─────────────────────────────────────
    support::task_with_output("Extract YAML front matter", || {
        let content =
            "---\ntitle: My Page\nauthor: Jane Doe\n---\n# Hello";
        let (data, body) = extract_front_matter_data(content).unwrap();
        vec![
            format!("title  = {}", data["title"]),
            format!("author = {}", data["author"]),
            format!("body   = {body}"),
        ]
    });

    // ── TOML front matter (+++) ─────────────────────────────────────
    support::task_with_output("Extract TOML front matter", || {
        let content =
            "+++\ntitle = \"TOML Page\"\ndraft = true\n+++\n# Content";
        let (data, body) = extract_front_matter_data(content).unwrap();
        vec![
            format!("title = {}", data["title"]),
            format!("draft = {}", data["draft"]),
            format!("body  = {body}"),
        ]
    });

    // ── JSON front matter ({...}) ───────────────────────────────────
    support::task_with_output("Extract JSON front matter", || {
        let content =
            "{\"title\": \"JSON Page\", \"lang\": \"en\"}\n# Content";
        let (data, body) = extract_front_matter_data(content).unwrap();
        vec![
            format!("title = {}", data["title"]),
            format!("lang  = {}", data["lang"]),
            format!("body  = {body}"),
        ]
    });

    // ── Raw extraction (strip only) ─────────────────────────────────
    support::task_with_output(
        "Strip front matter without parsing",
        || {
            let content = "---\ntitle: Stripped\n---\n# Body only";
            let body = extract_front_matter(content).unwrap();
            vec![format!("body = {body}")]
        },
    );

    // ── Content without front matter ────────────────────────────────
    support::task_with_output("Content without front matter", || {
        let content = "# Just a heading\n\nNo metadata here.";
        let (data, body) = extract_front_matter_data(content).unwrap();
        vec![format!("data = {data}"), format!("body = {body}")]
    });

    // ── Nested YAML structures ──────────────────────────────────────
    support::task_with_output("YAML with many metadata fields", || {
        let content = "---\ntitle: Blog Post\nauthor: Jane Doe\ndate: 2025-01-15\nlang: en-GB\ndraft: false\n---\n# Content";
        let (data, body) = extract_front_matter_data(content).unwrap();
        vec![
            format!("title  = {}", data["title"]),
            format!("author = {}", data["author"]),
            format!("date   = {}", data["date"]),
            format!("lang   = {}", data["lang"]),
            format!("draft  = {}", data["draft"]),
            format!("body   = {body}"),
        ]
    });

    support::summary(6);
}