0%

使用Node.js、Hexo和GitHub Pages搭建个人博客

在这篇文章中,我将分享如何使用Node.js、Hexo框架和GitHub Pages来搭建一个免费的个人博客网站。通过这种方式,你可以拥有一个完全属于自己的网络空间,记录和分享你的想法、经验和知识。

准备工作

在开始之前,确保你已经安装了以下工具:

  • Node.js:Hexo是基于Node.js的静态博客框架
  • Git:用于版本控制和部署到GitHub
  • GitHub账号:用于托管你的博客

第一步:安装Hexo

首先,我们需要全局安装Hexo命令行工具:

1
npm install -g hexo-cli

安装完成后,可以验证安装是否成功:

1
hexo version

初始化博客项目

选择一个合适的目录,初始化你的博客项目:

1
2
3
hexo init my-blog
cd my-blog
npm install

这将创建一个基本的博客项目结构,并安装所需的依赖项。

本地预览博客

初始化完成后,可以启动本地服务器预览博客:

1
2
3
hexo clean   # 清除缓存文件
hexo generate # 生成静态文件
hexo server # 启动本地服务器

第四步:配置博客

Hexo的主要配置文件是项目根目录下的 _config.yml。你需要修改一些基本设置:

1
2
3
4
5
6
7
8
9
10
11
# 网站基本信息
title: 你的博客名称
subtitle: '副标题'
description: '描述'
keywords:
author: 你的名字
language: zh-CN
timezone: 'Asia/Shanghai'

# URL设置(GitHub Pages)
url: https://你的用户名.github.io

第五步:安装主题

Hexo默认的主题比较简单,我选择了Next主题:

1
git clone https://github.com/theme-next/hexo-theme-next themes/next

然后在 _config.yml 中设置主题:

1
theme: next

Next主题有自己的配置文件,位于 themes/next/_config.yml,你可以根据需要进行个性化设置。

第六步:创建新文章

使用以下命令创建新文章:

1
hexo new "文章标题"

这将在 source/_posts 目录下创建一个名为 文章标题.md 的文件。你可以使用Markdown语法编写文章内容。

第七步:部署到GitHub Pages

1.首先,在GitHub创建一个名为 你的用户名.github.io 的仓库

2.安装部署插件:

1
npm install hexo-deployer-git --save

3.修改配置文件中的部署设置:

1
2
3
4
deploy:
type: git
repository: git@github.com:你的用户名/你的用户名.github.io.git
branch: main

4.执行部署命令:

1
2
3
hexo clean
hexo generate
hexo deploy

总结

通过Node.js、Hexo和GitHub Pages的组合,我们可以轻松搭建一个个人博客网站,而且完全免费。这种方式的优点是:

无需服务器费用,GitHub Pages提供免费托管
静态网站加载速度快
Markdown写作体验好
可版本控制
自由度高,可以自定义主题和功能
希望这篇教程对你有所帮助!如果你遇到任何问题,可以参考Hexo官方文档或GitHub Pages文档获取更多信息。