Overview

• Utilizes the versatile highlight.js JavaScript library.
• Supports 90+ coding languages.
• Choose from all 95+ available themes.
• Provides a component for adding code snippets.
• Highlight multi-line blocks of code.
• Detects language- and lang- class prefixes.
• Customize the highlight.js init JavaScript.
• Smart loading of CSS & JS assets.

Usage

Add the following to your Cargo.toml:

[dependencies]
pagetop-hljs = "<Version>"

Add the dependency pagetop_hljs::HighlightJS to your module:

use pagetop::prelude::*;

impl PackageTrait for MyPackage {
    // ...
    fn dependencies(&self) -> Vec<PackageRef> {
        vec![
            // ...
            &pagetop_hljs::HighlightJS
            // ...
        ]
    }

    fn configure_service(&self, cfg: &mut service::web::ServiceConfig) {
        cfg.route("/", service::web::get().to(hljs_sample));
    }
    // ...
}

Now you can put code snippets on web pages:

use pagetop_hljs::prelude::*;

#[service::get("/")]
async fn hljs_sample(request: HttpRequest) -> ResultPage<Markup, ErrorPage> {
    Page::new(request)
        .with_component(
            Snippet::with(
                HljsLang::Rust,
                r###"
// This is the main function.
fn main() {
    // Print text to the console.
    println!("Hello World!");
}
                "###,
            ),
        )
        .render()
}

📦 About PageTop

PageTop is an opinionated web framework to build modular Server-Side Rendering web solutions.

🚧 Warning

PageTop framework is currently in active development. The API is unstable and subject to frequent changes. Production use is not recommended until version 0.1.0.

📜 License

All code in this project is dual-licensed under either:

• MIT License (LICENSE-MIT or https://opensource.org/licenses/MIT)

• Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)

at your option. This means you can select the license you prefer! This dual-licensing approach is the de-facto standard in the Rust ecosystem.