1 unstable release
0.0.1 | Oct 7, 2024 |
---|
#2 in #seo
335 downloads per month
Used in 4 crates
(2 directly)
87KB
1.5K
SLoC
HTML Generator (html-generator)
A Rust-based HTML generation and optimization library.
• Website • Documentation • Report Bug • Request Feature • Contributing Guidelines
Overview
The html-generator
is 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.
Features
- Markdown to HTML Conversion: Convert Markdown content to HTML with support for custom extensions.
- Front Matter Extraction: Extract and process front matter from Markdown content.
- Advanced Header Processing: Automatically generate id and class attributes for headers.
- Table of Contents Generation: Create a table of contents from HTML content.
- SEO Optimization: Generate meta tags and structured data (JSON-LD) for improved search engine visibility.
- Accessibility Enhancements: Add ARIA attributes and validate against WCAG guidelines.
- Performance Optimization: Minify HTML output and support asynchronous generation for large sites.
- Flexible Configuration: Customize the HTML generation process through a comprehensive set of options.
Installation
Add this to your Cargo.toml
:
[dependencies]
html-generator = "0.0.1"
Usage
Here's a basic example of how to use html-generator
:
use html_generator::utils::{extract_front_matter, format_header_with_id_class, generate_table_of_contents};
fn main() -> Result<(), Box<dyn std::error::Error>> {
// Extract front matter
let content = "---\ntitle: My Page\n---\n# Hello, world!\n\nThis is a test.";
let content_without_front_matter = extract_front_matter(content)?;
println!("Content without front matter:\n{}", content_without_front_matter);
// Format header with ID and class
let header = "<h2>Hello, World!</h2>";
let formatted_header = format_header_with_id_class(header, None, None)?;
println!("Formatted header:\n{}", formatted_header);
// Generate table of contents
let html = "<h1>Title</h1><p>Some content</p><h2>Subtitle</h2><p>More content</p>";
let toc = generate_table_of_contents(html)?;
println!("Table of contents:\n{}", toc);
Ok(())
}
Documentation
For full API documentation, please visit docs.rs/html-generator.
Examples
To run the examples, clone the repository and use the following command:
cargo run --example example_name
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under either of
at your option.
Acknowledgements
Special thanks to all contributors who have helped build the html-generator
library.
Dependencies
~27–39MB
~632K SLoC