hexo+github搭建博客简易教程

杂项 , 评论

1.创建仓库

1.1 新建仓库

在Github上创建仓库，名字为username.github.io（username是你的github用户名）

类型public，勾选Add a README file（不勾也可以）

1.2 测试模板

在仓库的settings里，左边的Pages选项卡，选择Choose a theme

随便选择一个，然后Select后，Commit changes。

这时候测试访问username.github.io，便可以看到刚刚的网页，即你选择的模板

2.环境准备与配置

2.1 node.js

http://nodejs.cn/ #下载地址

1
npm --version #验证是否安装成功

弹出版本号，则说明安装成功

image-20220621124810685

2.2 Git

https://gitforwindows.org/ #下载地址

1
git --version #验证是否安装成功

同样，输出版本号，则说明安装成功

2.3 Git设置

在桌面右键菜单里面点击Git Bash Here

1
2
3
4
git config --global user.name "你的Github用户名"
git config --global user.email "你的Github注册邮箱"
ssh-keygen -t rsa -C "你的Github注册邮箱"
ssh git@github.com #获得密钥

2.3.1 验证邮箱和用户名

在设置完用户名和注册邮箱时，使用git config –global user.name以及git config –global user.email来验证是否设置成功

2.3.2 获取配置SSH密钥

在ssh-keygen -t rsa -C “邮箱” 命令输入后，根据提示敲击回车，最后操作完成后，在所提示的目录里面找到sshkey，例如我的是在 “C:\Users\Yurisa\.ssh“ 里面，里面有个 “id_rsa.pub“ 文件，用记事本打开（密钥的最后应该是你刚刚输入的邮箱），复制该密钥

在Settings/SSH and GPG keys里新建一个SSH key（右上角的New SSh key）

image-20220621130550715

title随便写，下面填你刚刚复制的密钥

2.3.3 配置 Github tokens

在Settings/Developer settings/Personal access tokens，点击Generate new token

Note随便填写，Expiration是你的token有效时间，下面勾选repo，然后点击Generate token

image-20220621214457320

点击后会给你一个ghp_XXX开头的token，复制下来（保存下来，不要搞丢了）

2.4 安装Hexo框架

1
npm install -g hexo-cli #安装hexo框架

在你存放博客的文件夹，右键菜单中点击Git Bash Here

2.4.1 本地部署

在你存放博客的文件夹，右键菜单中点击Git Bash Here

1
2
3
hexo init #部署本地博客
#这条命令执行后就会在你的文件夹里生成博客的文件
npm install hexo-deployer-git --save #安装hexo-deployer-git插件
1
2
3
hexo s #启动服务浏览 
hexo server #两条命令的作用都是一样的
//输入http://localhost:4000/即可看到效果页面 Ctrl+C可以停止

image-20220622011420252

2.4.2 创建新文章

1
hexo n "文章名字"

在你本地部署init文件夹里 “\source_posts“ 里就会创建一个md格式的文件，可以用markdown编辑器打开

2.4.3 _config.yml文件

1
2
3
4
5
6
7
8
9
以下是网站信息
# Site 
title: 世界最高城理塘
subtitle: ''
description: edcc的博客
keywords:
author: edcc
language: zh-CN
timezone: ''
1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repository: https://github.com/username/username.github.io.git
  branch: main

deploy一栏一定要修改

2.4.4 部署到Github服务器

各种东西修改完成保存后就可以在git的窗口里面输入以下指令

1
hexo clean && hexo g && hexo d

hexo g == hexo generate #生成

hexo d == hexo deploy #部署

在上传的时候可能会github会弹出窗口让你输入凭证，可以选择输入token，即ghp_XX（2.3.3步骤里）那个token

输入完指令后等几分钟，进入你博客的网址，username.github.io就会看到更新后的内容了。

3.网站主题更换

可以在github上面搜索hexo theme，会有很多主题模板，一般他们的仓库里的README.md里都有教程如何替换，一般都是在博客文件夹里输入 git clone xxxxxxx

然后再_config.yml里面更改

edccCSU在读老鼠

没什么好简介的。