概述

• 利用功能丰富的 highlight.js JavaScript 库。
• 支持 90+ 种编程语言。
• 从所有 95+ 种可用主题中选择。
• 提供添加代码片段的组件。
• 突出显示多行代码块。
• 检测 language- 和 lang- 类前缀。
• 自定义 highlight.js 初始化 JavaScript。
• 智能加载 CSS & JS 资产。

使用方法

将 pagetop-hljs 添加到您的 Cargo.toml

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

将 pagetop_hljs::HighlightJS 添加到您的依赖包

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));
    }
    // ...
}

然后在网页上放置您的代码片段

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()
}

📦 关于 PageTop

PageTop 是一个具有观点的网页框架，用于构建模块化的 服务器端渲染 网页解决方案。

🚧 警告

PageTop 框架目前处于积极开发中。API 不稳定且经常更改。不建议在生产环境中使用，直到版本 0.1.0。

📜 许可证

本项目的所有代码均采用以下任一许可证双重授权：

• MIT 许可证 (LICENSE-MIT 或 https://opensource.org/licenses/MIT)

• Apache 许可证 2.0 版本 (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)

您可以选择您喜欢的许可证！这种双重许可方法是 Rust 生态系统中的事实标准。