本博客系统通过构建工具生成纯静态的博客网站，借助GitHub Pages，你可以在5分钟内免费拥有个人博客。 它具有以下特点

• 生成纯静态网站，访问速度极快
• 使用markdown格式来编写博客内容
• 基于git代码管理来存储你的博客
• 使用CI工具来自动化部署你的博客站点

效果展示：NilTor's Blog

• 主页博客列表，支持搜索和分类和存档筛选
• 自定义网站名称和说明
• 随系统变化的Light和Dark主题
• 移动端的自适应显示
• TOC支持
• mermaid,nomnoml,Math的渲染支持
• 代码高亮及复制支持

1. 点击Fork按钮，并创建自己的仓库。 并取消选择 Copy the main branch only。
2. 进入自己的GitHub仓库，点击Actions，启用workflows。
3. 点击Settings，找到Pages配置，在Build and deployment 选项中选择GitHub Actions.

你可以通过根目录下的webinfo.json，对博客基础信息进行配置，如下所示：

{
  "Name": "Niltor Blog", // 博客名称，显示在主页顶部导航
  "Description": "🗽 for freedom",// 说明，显示在主页顶部中间
  "AuthorName": "Ater", // 作者名称，显示在博客列表
  "BaseHref": "/blazor-blog/" // 子目录
}

当你使用Github Page或使用IIS子应用部署时，需要调整BaseHref。通常是你的项目名称或子目录名。

修改后提交代码，GitHub会触发Action自动构建。

请使用任何你习惯的markdown编辑器编写博客,唯一的要求是将博客内容放到Content目录下。你可以在该目录下创建多级目录。

你只需要正常提交代码即可，github action会自动构建并最终发布你的博客，发布成功后可打开您的 GitHub Page 查看。

如果你不使用Github Page，那么你也可以轻松的部署到其他服务。核心的步骤只需要两步。

BuildSite项目是用来将markdown转换成html的，请在根目录执行:

 dotnet run --project .\Lib\BuildSite\ .\Content .\WebApp Production

其中.\Content是你的markdown存储目录，.\WebApp是生成的静态站点目录。

将WebApp中的所有文件复制到你的服务器即可。

上游代码的更新以dev分支为准，你可以将dev分支合并到你的dev分支，以获取最新的代码更新。

main作为默认的构建发布的分支，请不要合并到你的main分支。

建议您使用dev或其他自己的分支来编写博客和自定义内容，然后再合并到main分支以触发自动构建。

fork之后，你将拥有所有的自定义权限，因为所有的源代码都已经在你自己的仓库中。

核心项目为BuildSite，用来生成静态文件，其中包括将markdown文件转换成html文件。

BuildSite项目是一个.NET项目，你需要安装.NET SDK 8.0。

此外，你可以安装(可选)

• tailwindcss，用来生成css样式内容
• http-server，用来启动本地静态内容，以便调试

1. 预览项目
   1. 打开终端，在WebApp目录下执行http-server，然后在浏览器中打开http://127.0.0.1:8080。
2. 生成静态内容。
   1. 在根目录下执行dotnet run --project ./Lib/BuildSite ./Content ./WebApp，以生成最新的静态内容。
   2. 或者直接运行根目录下的build.ps1脚本。
3. 刷新浏览器，可看到最新生成的内容。

如果你使用tailwindcss，可在WebApp下执行npx tailwindcss -o ./css/app.css --watch。

主页内容模板位于Lib\BuildSite\template\index.html.tpl，其中包括以下变量：

你可以按照自己的想法修改主页的布局和样式。

主页内容包括博客的搜索和分类筛选功能，其功能代码在WebApp\js\index.js中。

关于博客列表和分类列表的自定义，你可以参考BuildSite项目中HtmlBuilder.cs文件中的GenBlogListHtml和GenSiderBar方法。

后续我们会提供更灵活的自定义方式。

博客页内容模板位于Lib\BuildSite\template\blog.html.tpl，其中包括以下变量：

关于博客展示页的内容，你可以通过WebApp/css/markdown.css来修改样式，以及WebApp/js/markdown.js来定义逻辑。

本项目使用ColorCode来格式化markdown中的代码内容，ColorCode使用正则来匹配代码内容。如果你需要对代码高亮进行定义，你需要：

• 添加或修改正则规则，你将在ColorCode.Core/Compilation/Languages目录下找到相应的语言定义，如果不存在，你可以添加新的语言支持。
• 如果是新添加的语言，需要在ColorCode.Core/Languages.cs中加载该语言。