如何5分钟快速搭建免费开源的EasyBlog静态博客,拥有个人博客?

摘要:本博客系统通过构建工具生成纯静态的博客网站,借助GitHub Pages,你可以在5分钟内免费拥有个人博客。
EasyBlog 说明 本博客系统通过构建工具生成纯静态的博客网站,借助GitHub Pages,你可以在5分钟内免费拥有个人博客。 它具有以下特点 生成纯静态网站,访问速度极快 使用markdown格式来编写博客内容 基于git代码管理来存储你的博客 使用CI工具来自动化部署你的博客站点 效果展示:NilTor's Blog 开源地址 视频介绍 🎖️功能 主页博客列表,支持搜索和分类和存档筛选 自定义网站名称和说明 随系统变化的Light和Dark主题 移动端的自适应显示 TOC支持 mermaid,nomnoml,Math的渲染支持 代码高亮及复制支持 使用Github Page部署 Fork并配置GitHub Page 点击Fork按钮,并创建自己的仓库。 并取消选择 Copy the main branch only。 进入自己的GitHub仓库,点击Actions,启用workflows。 点击Settings,找到Pages配置,在Build and deployment 选项中选择GitHub Actions. 配置 你可以通过根目录下的webinfo.json,对博客基础信息进行配置,如下所示: { "Name": "Niltor Blog", // 博客名称,显示在主页顶部导航 "Description": "🗽 for freedom",// 说明,显示在主页顶部中间 "AuthorName": "Ater", // 作者名称,显示在博客列表 "BaseHref": "/blazor-blog/", // 子目录 "Domain": "https://aterdev.github.io" // 域名,生成sitemap使用,不生成则留空 } 当你使用Github Page或使用IIS子应用部署时,需要调整BaseHref。通常是你的项目名称或子目录名。 [!IMPORTANT] 注意,BaseHref尾部的/是必需的。 如果你配置了自定义域名,并且没有使用子目录,请将BaseHref设置为/。 修改后提交代码,GitHub会触发Action自动构建。 编写博客 请使用任何你习惯的markdown编辑器编写博客,唯一的要求是将博客内容放到Content目录下。你可以在该目录下创建多级目录。 发布博客 你只需要正常提交代码即可,github action会自动构建并最终发布你的博客,发布成功后可打开您的 GitHub Page 查看。 部署到其他服务 如果你不使用Github Page,那么你也可以轻松的部署到其他服务。核心的步骤只需要两步。 生成静态内容 BuildSite项目是用来将markdown转换成html的,请在根目录执行: dotnet run --project .\src\BuildSite\ .\Content .\WebApp Production 其中.\Content是你的markdown存储目录,.\WebApp是生成的静态站点目录。 上传到你的服务器 将WebApp中的所有文件复制到你的服务器即可。 [!TIP] 根目录下的publishToLocal.ps1脚本可以自动完成构建和生成的操作,最终内容将在根目录下WebApp目录中。 如果你使用自动化部署,可参考.github/workflows中的脚本。 更新 上游代码的更新以dev分支为准,你可以将dev分支合并到你的dev分支,以获取最新的代码更新。 main作为默认的构建发布的分支,请不要合并到你的main分支。 建议您使用dev或其他自己的分支来编写博客和自定义内容,然后再合并到main分支以触发自动构建。 二次开发 fork之后,你将拥有所有的自定义权限,因为所有的源代码都已经在你自己的仓库中。 核心项目为BuildSite,用来生成静态文件,其中包括将markdown文件转换成html文件。 [!NOTE] 建议创建自己的分支来自定义开发内容,方便后续的合并。 开发环境 BuildSite项目是一个.NET项目,你需要安装.NET SDK 8.0。 此外,你可以安装(可选) http-server,用来启动本地静态内容,以便调试。 tailwindcss,用来生成css样式内容。 typescript,以便使用tsc命令。 运行项目 预览项目 打开终端,在WebApp目录下执行http-server,然后在浏览器中打开http://127.0.0.1:8080。 生成静态内容。
阅读全文