BlazorStatic

利用 Blazor 的强大功能来制作静态网站。

将您的 Blazor 应用程序转变为静态站点。

？它是如何运作的？

BlazorStatic 的目标是对于大多数使用过任何类型前端框架的开发人员来说直观且易于使用，特别是如果您已经使用 Blazor。

BlazorStatic 站点是该库的一个功能丰富的示例。检查源代码。

运行应用程序时， BlazorStatic使用HttpClient获取页面的 HTML，将 HTML 文件和资产输出到output文件夹，然后您可以从那里部署到任何标准 HTTP 服务器或托管服务。

有许多默认设置可以保持使用简单，但您可以对其进行广泛的配置。例如，您可以匹配 Markdown 文件中的 YAML 开头内容（可以从其他静态站点生成器中重用）。

入门

您可以通过三种方式开始使用 BlazorStatic，具体取决于您的设置和预期用途。您需要 .NET SDK 8 或更高版本才能开始。

？推荐方式

安装 BlazorStatic 模板：

dotnet new install BlazorStatic.Templates

这会将新选项添加​​到您的dotnet new模板列表中。然后使用以下命令创建一个新项目：

dotnet new BlazorStaticMinimalBlog -o MyBlazorStaticApp

这将创建一个MyBlazorStaticApp文件夹和项目。它是安装了 BlazorStatic 包的标准 .NET Blazor 应用程序，包括一些预定义的组件、样式和包含示例内容的博客文章。

使用dotnet watch运行应用程序。这将启动应用程序，允许您实时查看它，同时还在output文件夹中生成静态 HTML 文件。

从这里，您就可以探索项目、添加内容、创建新页面等等。

• Markdown 文件位于Content/Blog文件夹中。
• 标准 .NET 建议中包含.gitignore文件，该文件会忽略output文件夹。
• 该模板还包括一个.github文件夹，其中包含用于构建和部署到 GitHub Pages 的 GitHub 操作。请参阅下面的部署部分。
• 你可以定制任何东西。有关更多详细信息，请参阅此文档，其中更深入地解释了所有内容。

?‍➡️最快的方法

使用 BlazorStaticMinimalBlog 作为模板（绿色大按钮）。

它将复制所有内容并为您运行 GitHub 操作。运行后，进入设置并打开 GitHub 页面：

您的页面现已准备就绪！

定制方式

如果您想完全了解 BlazorStatic 的工作原理，或者如果您有一个想要集成 BlazorStatic 库的现有项目，请从头开始。查看此文档以获取指导。

？特征

• 利用您现有的 Blazor 经验。
• 轻松解析和使用 Markdown 文件。
• 支持自定义 YAML 前端事务。
• 自动发现 Razor 文件中的页面。
• 能够根据需要添加/删除页面。
• 适用于所有 CSS 框架和主题。
• 通过 CI/CD 管道轻松部署。
• 支持热重载
• 有dotnet new模板

？部署

您可以将output文件夹部署到任何静态托管服务，例如 GitHub Pages、Netlify、Vercel、Azure Static Web Apps 等。

详细说明请参见此处。

样品

描述	来源	居住
关于 BlazorStatic 的页面（此存储库包含代码本身）	来源	居住
最小的博客	来源	居住
Zodoc - 图像处理和深度学习示例	来源	居住
❓ 在这里添加您的页面！

？贡献

强烈鼓励和赞赏您的贡献。如果您发现某些内容缺失、不清楚或遇到代码问题，我热烈欢迎您的意见。请随意：

• 创建新问题或提交 PR。
• 通过电子邮件联系：[email protected]
• 如有任何疑问或建议，请直接联系我。
• 在 Blazor 社区 Discord 服务器上提出问题或开始讨论。