handmade-blog：轻量级静态博客生成器，快速搭建个性博客
项目地址: https://gitcode.com/gh_mirrors/ha/handmade-blog 项目介绍
handmade-blog 是一款轻量级的静态博客生成器，旨在帮助那些希望迅速启动博客的用户。它支持文章类型文档用于博客文章，工作类型文档用于作品集，代码高亮显示，KaTeX 语法，脚注等多种功能。handmade-blog 的设计简单直观，用户无需复杂的配置即可快速创建并部署自己的博客。
项目技术分析
handmade-blog 使用 Node.js 作为后端运行环境，采用 EJS 作为模板引擎，Markdown 用于文章编写，并利用 Parcel 进行资源打包。项目结构清晰，包含文章、作品集、静态资源和模板等目录，便于用户进行自定义和扩展。
- Node.js：提供服务器端的运行环境。
- EJS：嵌入式JavaScript模板引擎，用于生成HTML页面。
- Markdown：轻量级标记语言，用于撰写文章。
- Parcel：模块打包器，用于打包资源文件。
项目技术应用场景
handmade-blog 适合以下场景：
- 个人博客：快速搭建属于自己的博客，分享生活、技术、学习心得。
- 作品展示：通过作品集功能展示个人作品，适合设计师、开发者等展示作品。
- 教学平台：教师或教育机构可以用来创建教学博客，分享教育资源。
项目特点
handmade-blog 具有以下特点：
- 快速搭建：一键生成模板，快速开始博客搭建。
- 易于定制：通过简单的模板编辑即可定制博客样式。
- 支持Markdown：使用Markdown编写文章，简单易用。
- 代码高亮：支持代码高亮显示，适合技术博客。
- 响应式设计：博客界面适配移动端和桌面端，具有良好的用户体验。
- SEO优化：项目在SEO方面进行了优化，有助于博客内容在搜索引擎中更好地展示。
以下为handmade-blog的详细使用和项目结构的介绍：
使用方法
- 创建新仓库：在代码托管平台上创建新仓库，并使用handmade-blog模板。
- 配置GitHub Pages：在仓库设置中配置GitHub Pages，选择
gh-pages分支作为源。 - 安装依赖：克隆仓库后，在本地安装Node.js依赖。
- 自定义模板：修改模板文件，如导航栏标题，并运行
npm run build。 - 启动本地服务器：运行
npm start启动本地服务器，预览博客效果。 - 部署博客：完成修改后，提交代码到远程仓库，并运行
npm run deploy部署博客。
项目结构
_articles：存放Markdown格式的博客文章。_works：存放Markdown格式的作品集内容。app：包含资产、公共文件、样式、静态资源和模板文件。assets：存放导入HTML文件的资源，如图像、字体等。public：存放生成的HTML文件。styles：存放CSS源代码。static：存放不会被build脚本编译的静态文件。templates：EJS模板文件。
dist：编译后的文件存放目录。services：实现publish脚本的源代码。tools：实现npm脚本的源代码。
handmade-blog 的设计理念是简单、快速、可定制，非常适合需要快速搭建个人博客的用户。通过上述的特点和使用方法，相信handmade-blog能够成为你搭建博客的不错选择。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
扫一扫
2万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
