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 伺服器上提出問題或開始討論。