Scryber.Core 使用教程

2025-04-20 13:25:02作者：柏廷章Berta

1. 项目介绍

Scryber.Core 是一个基于 .NET 6 开发的 HTML 到 PDF 转换引擎，完全使用 C# 编写。它支持从 HTML 模板创建美观的流动文档，包括 CSS 样式、对象数据绑定和 SVG 绘图。Scryber.Core 提供了灵活的布局和页面设计，适用于创建具有标准 HTML 元素和新型 HTML5 标签的文档。该库同时支持数据绑定、外部内容嵌入、多种字体和图形绘制等功能，是创建 PDF 文档的强大工具。

2. 项目快速启动

环境准备

确保您的开发环境已安装 .NET 6 SDK。

创建项目

使用 NuGet 包管理器安装 Scryber.Core：

Install-Package Scryber.Core

或者如果您使用的是 ASP.NET MVC，可以安装：

Install-Package Scryber.Core.Mvc

示例代码

以下是一个简单的示例，展示如何从 HTML 模板生成 PDF 文档：

using Scryber.Components;

class Program
{
    static void Main(string[] args)
    {
        // 加载 HTML 模板
        string path = "path/to/your/template.html";

        // 创建模型数据
        var model = new {
            titlestyle = "color:#ff6347",
            title = "Hello from scryber",
            items = new[] {
                new { name = "First item" },
                new { name = "Second item" },
                new { name = "Third item" }
            }
        };

        using (var doc = Document.ParseDocument(path))
        {
            // 设置参数
            doc.Params["author"] = "Scryber Engine";
            doc.Params["--head-bg"] = "#333";
            doc.Params["--head-txt"] = "#FFF";
            doc.Params["model"] = model;

            // 生成 PDF 并保存到文件
            using (var stream = new FileStream("output.pdf", FileMode.Create))
            {
                doc.SaveAsPDF(stream);
            }
        }
    }
}

确保替换 path/to/your/template.html 为您的 HTML 模板文件路径。

3. 应用案例和最佳实践

HTML 模板编写

创建一个 HTML 文件作为文档模板，可以使用 HTML 和 CSS 定义页面布局和样式。例如：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Document</title>
    <style>
        body { font-family: sans-serif; }
        .header { background-color: #333; color: #fff; padding: 10px; }
    </style>
</head>
<body>
    <div class="header">Document Header</div>
    <div>Document Body Content</div>
    <div class="footer">Document Footer</div>
</body>
</html>

数据绑定

在模板中使用数据绑定来动态填充内容：

<template data-bind="{{model.items}}">
    <div>{{.name}}</div>
</template>

在代码中传递模型数据：

doc.Params["model"] = new { items = new[] { new { name = "Item 1" }, new { name = "Item 2" } } };

4. 典型生态项目

Scryber.Core 可以与多种 .NET 生态系统中的项目集成，例如：

ASP.NET Core MVC：在 MVC 应用程序中生成 PDF 响应。
.NET Core Console Apps：创建后台任务生成 PDF 文件。
Blazor：在 WebAssembly 应用程序中生成 PDF 文档。

每个项目类型都有其特定的使用方式和集成点，可以根据具体需求进行选择和集成。

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

docs

OpenHarmony documentation | OpenHarmony开发者文档

Ascend Extension for PyTorch

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

Java

kernel

openEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。

245

105

ops-math

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解