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
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

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

//! Configuration: HtmlConfig builder, validation, and field inspection.
//!
//! Run: `cargo run --example config`

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

use html_generator::{
    generate_html, validate_language_code, HtmlConfig,
};

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

    // ── Default configuration ───────────────────────────────────────
    support::task_with_output("Inspect default HtmlConfig", || {
        let c = HtmlConfig::default();
        vec![
            format!(
                "syntax_highlighting = {}",
                c.enable_syntax_highlighting
            ),
            format!("syntax_theme        = {:?}", c.syntax_theme),
            format!("minify_output       = {}", c.minify_output),
            format!("add_aria            = {}", c.add_aria_attributes),
            format!(
                "structured_data     = {}",
                c.generate_structured_data
            ),
            format!("generate_toc        = {}", c.generate_toc),
            format!("language            = {}", c.language),
            format!("max_input_size      = {} bytes", c.max_input_size),
            format!("allow_unsafe_html   = {}", c.allow_unsafe_html),
        ]
    });

    // ── Builder pattern ─────────────────────────────────────────────
    support::task_with_output(
        "Build config with builder pattern",
        || {
            let config = HtmlConfig::builder()
                .with_syntax_highlighting(true, Some("monokai".into()))
                .with_language("en-US")
                .build()
                .unwrap();
            vec![
                format!("theme    = {:?}", config.syntax_theme),
                format!("language = {}", config.language),
            ]
        },
    );

    // ── Language code validation ─────────────────────────────────────
    support::task_with_output("Language code validation", || {
        let codes = ["en-GB", "fr-FR", "en", "123", "en_US"];
        codes
            .iter()
            .map(|c| {
                format!(
                    "{c:<6} -> valid = {}",
                    validate_language_code(c)
                )
            })
            .collect()
    });

    // ── Config affects output ───────────────────────────────────────
    support::task_with_output("Config toggles change output", || {
        let md = "# Test\n\nParagraph.";
        let plain = generate_html(md, &HtmlConfig::default()).unwrap();
        let minified = generate_html(
            md,
            &HtmlConfig {
                minify_output: true,
                ..HtmlConfig::default()
            },
        )
        .unwrap();
        vec![
            format!("default_len  = {} bytes", plain.len()),
            format!("minified_len = {} bytes", minified.len()),
            format!("smaller      = {}", minified.len() < plain.len()),
        ]
    });

    // ── Direct struct construction ──────────────────────────────────
    support::task_with_output("Direct struct construction", || {
        let config = HtmlConfig {
            enable_syntax_highlighting: false,
            syntax_theme: None,
            minify_output: true,
            add_aria_attributes: true,
            generate_structured_data: false,
            generate_toc: false,
            allow_unsafe_html: false,
            sanitize_html: false,
            generate_full_document: false,
            max_input_size: 1024,
            language: "de-DE".into(),
            max_buffer_size: 8 * 1024 * 1024,
            encoding: "utf-8".into(),
            enable_math: false,
            enable_diagrams: false,
        };
        vec![
            format!("language = {}", config.language),
            format!("max_in   = {} bytes", config.max_input_size),
        ]
    });

    support::summary(5);
}