0%

使用hexo创建个人博客

使用github+hexo创建个人博客

1. 下载工具

自行下载node.js npm ,使用以下命令检查是否正确安装

1
2
node -v
npm -v

2. 在github上创建仓库

image-20250128013605341

3. 安装hexo

使用以下命令暗转hexo

1
npm install -g hexo -cli

4. 创建Hexo文件夹

1
2
3
hexo init <folder>
cd <folder>
npm install

使用以下命令可以本地查看效果

1
hexo server

网页浏览: localhost:4000查看效果

初次登录会要求登录github, 现在github不支持密码登录了,只能通过token登录,去GitHub首页

image-20250128014633141

进入setting后拉到最下面的Developer settings 进行生成,期限选择永久。

修改<folder>下的配置文件_config.yml

1
2
3
4
5
deploy:
type: git
repo: <repository url> # 库地址
branch: [branch] # 分支,如main
message: [message] # 缺省为创建时间

5. 发布文章

进入site目录, 右键打开Git Bash, 创建博文:

1
hexo new "My New Post"

然后source文件夹中会出现一个My New Post.md 文件,可以使用Markdown写文章。写完之后运行下面代码将文章渲染到GitHub Pages 上完成发布。

1
2
hexo g # 生成静态页面
hexo d # 部署页面

也可以不通过命令直接自己生成页面,但要在页面开始加入如下格式:

1
2
3
4
5
6
7
8
9
10
11
12
13
---
title: Hello World # 标题
date: 2019/3/26 hh:mm:ss # 时间
categories: # 分类
- Diary
tags: # 标签
- PS3
- Games
---

摘要
<!--more-->
正文

常用命令

1
2
3
4
5
6
7
8
hexo new "name"       # 新建文章
hexo new page "name" # 新建页面
hexo g # 生成页面
hexo d # 部署
hexo g -d # 生成页面并部署
hexo s # 本地预览
hexo clean # 清除缓存和已生成的静态文件
hexo help # 帮助

6. 访问

Hexo

8. 更换主题

Themes | Hexo上选择主题,进入网站目录下载主题、

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

然后修改 _config.yml 中的 theme 为新主题名称 next,发布。(有的主题需要将 _config.yml 替换为主题自带的,参考主题说明。)

9. 更改设置

所有设置都在_config.yml目录下,参考官方文档配置 | Hexo

可能遇到的问题

1. 在执行 hexo d 时报错

fatal: 无法访问 ‘https://github.com/chixinn/chixinn.github.io.git/

解决办法: 其实时git push 的问题。先执行以下命令,再执行hexo d

1
git config --global --unset http.proxy
2.在执行 hexo d 时报错

ERROR Deployer not found: git

解决办法: 没有安装hexo-deployer-git

使用以下命令安装

1
npm install hexo-deployer-git --save
3. 修改并部署后没有效果

使用 hexo clean清理后重新部署

如果您读文章后有收获,可以打赏我喝咖啡哦~