hexo框架+github创建属于自己的博客
一、环境准备
- 安装 Node.js
- 前往 Node.js 官网下载并安装最新版本的 Node.js。
- 安装完成后,在终端中运行
node -v
和npm -v
,确认安装成功。
- 安装 Git
- 如果 macOS 未预装 Git,可以通过 Homebrew 安装:
brew install git
。 - 或者从 Git 官网下载安装包进行安装。
- 安装完成后,在终端中运行
git --version
,确认安装成功。
- 如果 macOS 未预装 Git,可以通过 Homebrew 安装:
- 安装 Hexo
- 使用 npm 全局安装 Hexo CLI:
npm install -g hexo-cli
。 - 安装完成后,运行
hexo -v
,确认安装成功。
- 使用 npm 全局安装 Hexo CLI:
二、初始化 Hexo 项目
- 创建项目文件夹
- 在终端中,导航到希望存放博客项目的目录,然后运行
mkdir myblog
创建新文件夹。 - 进入该文件夹:
cd myblog
。
- 在终端中,导航到希望存放博客项目的目录,然后运行
- 初始化 Hexo
- 运行
hexo init 博客名
,Hexo 会自动生成项目所需的文件和目录结构。 - 进入到新创建的博客名目录下
- 运行
- 安装依赖
- 运行
npm install
,安装项目所需的依赖包。
- 运行
三、配置 GitHub 仓库
创建 GitHub 仓库
- 登录 GitHub,创建一个新的仓库,仓库名称必须为
username.github.io
,其中username
是你的 GitHub 用户名。 - 选择 Public(公开)以便所有人都能访问你的博客。
- 登录 GitHub,创建一个新的仓库,仓库名称必须为
生成 SSH Key
(如果尚未配置):
- 在终端中运行
ssh-keygen -t rsa -C "your_email@example.com"
,生成 SSH Key。 - 按照提示操作,将生成的公钥(
id_rsa.pub
)添加到 GitHub 的 SSH Keys 设置中。
- 在终端中运行
四、配置 Hexo 部署
编辑
_config.yml
在项目根目录下找到
_config.yml
文件,编辑deploy
部分:1
2
3
4deploy:
type: git
repo: git@github.com:username/username.github.io.git
branch: main # 或 master,根据 GitHub 仓库的默认分支选择将
username
替换为你的 GitHub 用户名。
安装部署插件
- 运行
npm install hexo-deployer-git --save
,安装 Hexo 的 Git 部署插件。
- 运行
五、生成并部署博客
- 生成静态文件
- 运行
hexo generate
(或简写为hexo g
),生成博客的静态文件。
- 运行
- 部署到 GitHub
- 运行
hexo deploy
(或简写为hexo d
),将生成的静态文件部署到 GitHub 仓库。
- 运行
- 访问博客
- 部署完成后,打开浏览器,访问
https://username.github.io
,即可看到你的博客。
- 部署完成后,打开浏览器,访问
六、个性化与维护
- 选择主题
- Hexo 提供了丰富的主题,可以在 Hexo 主题官网 选择并下载喜欢的主题。
- 将主题文件放置在
themes
目录下,并在_config.yml
中配置theme
字段。
- 编写文章
- 使用
hexo new "文章标题"
命令创建新文章,文章将保存在source/_posts
目录下。 - 使用 Markdown 格式编写文章内容。
- 使用
- 更新与维护
- 每次更新文章后,运行
hexo g
和hexo d
重新生成并部署博客。
- 每次更新文章后,运行
七、主题下载
进入
themes
文件夹下使用Git clone
命令来下载:1
git clone https://github.com/yuang01/hexo-theme-bamboo.git
⚠️如果clone速度较慢,可以用科学上网或者进入github下载压缩包
修改hexo根目录下的站点配置文件
_config.yml
,把主题改为bamboo
在source目录下新创建CNAME文件,文件内容写上访问的域名(如:
penghc.cn
)