您现在的位置是:首页 >学无止境 >Hexo+GitHub搭建个人博客教程(2023最新版)网站首页学无止境
Hexo+GitHub搭建个人博客教程(2023最新版)
一、准备环境
1、node环境
首先,安装 nodejs, 因为Hexo是基于 Node.js 驱动的一款博客框架。
2、git 环境
然后,安装git, 一个分布式版本控制系统,用于项目的版本控制管理,作者是 Linux 之父。
⭐Git(官网)
⭐Git for Windows(仅windows安装包)
⭐CNPM Binaries Mirror [阿里镜像](速度快,ctr+f检索)
安装过程一路next就行(安装路径可改)
两者安装完成之后,右击此电脑>属性>高级系统设置>环境变量>系统变量下的Path 可以看到两者已自动修改了环境变量,这是我们可以通过cmd命令(win+r后输入cmd)查看两者版本。(确认是否安装成功及可以使用) 查看Node.js版本命令:node -v 查看Git版本命令:git --version
以上情况即安装成功
二、注册GitHub账号并且创建仓库
1.注册(已有GitHub账号可忽略此步)
注册之后邮箱会收到一封Github的邮件,点击Github的链接确认注册
2.创建仓库
注意选择public
注意仓库的取名格式:用户名.github.io(这将是以后的访问域名)
到这里代表我们Github账号以及仓库都已经创建完毕 可以把下面这段仓库的地址复制下来留着后面配置时会用到
(推荐使用ssh,https容易后期出现bug)
三、本地配置安装Hexo
首先在磁盘中创建一个用来存放Github本地仓库文件的目录blog(可自定义目录存放)
选中创建的目录(文件夹)右键选择使用Gti Bash Here打开Git命令窗口(这就是开始安装的Git工具,现在开始使用)
也可以使用Windows的cmd命令行(不推荐)
(因为是从国外服务器下载,受网络的影响比较大,有可能会出现异常,所以我们需要连接国内淘宝官方的服务器来进行)
输入命令:npm install -g cnpm --registry=https://registry.npm.taobao.org
注:之后再次使用命令则是以cnpm开头~而不是npm
第一步:正式开始安装hexo
输入命令:cnpm install -g hexo-cli第二步:初始化Hexo
输入命令:hexo init(初始化成功后blog目录(文件夹)会多出许多文件)
这时输入命令:hexo s
【hexo sever的缩写,作用是启动本地服务器,用于预览主题】
然后在浏览器输入localhost:4000即可以在本地浏览博客(自带一篇Hello World博客)
关闭 ctrl + c
四、设置ssh
1.生成sshkey
首先在git下
输入命令:cd ~/.ssh进入.ssh文件
输入命令:ssh-keygen -t rsa -C ‘注册时的邮箱地址’
接着去查看C盘目录(此文件夹所在C:用户用户名目录下),然后在记事本中打开id_rsa.put文件并复制生成的key
2.将key配置到GitHub中
在GitHub主页的头像下找到seething
然后点击SSH and GPG keys,点击New SSH key
将刚刚在.ssh目录下所复制的id_rsa.put文件中的信息复制进key(注意空格)(名字随意)
验证:
输入命令(git):ssh -T git@github.com 并且输入yes之后,行末尾会显示你的用户名
(绑定成功邮箱会收到邮件提醒)
接着在本地绑定与Github的用户名和邮箱(git)
输入命令:git config --global user.name “注册时用户名”
输入命令:git config --global user.email “注册时邮箱”
五、上传博客
首先找到之前创建仓库生成的Github仓库Http或SSH地址(推荐SSH)
(如果没有保存点击仓库主页的Clone or download可重新查看)
然后打开blog文件夹下的_config.yml
然后将文章末尾改为以下格式:
(repo即复制的HTTP/SSH)【推荐SSH(git开头)】
deploy:
type: git
repo: https://github.com/用户名/用户名.github.io.git(或者git@github.com:用户名/用户名.github.io.git)【推荐】
branch: main
注:
很多博客中branch仍填写为master,2020年10月1日后master正式由main取代!!!
从 2020 年 10 月 1 日开始,GitHub 上的所有新库都将用中性词「main」命名,取代原来的「master」,因为后者是一个容易让人联想到奴隶制的术语。
接着需要安装一个上传工具
输入命令(git):cnpm install hexo-deployer-git
新建文章(不新建的话也会有一篇自带的Hello World文章)
输入命令:hexo new “文章名称”
然后根据返回的地址即可找到创建的文件位置,即可使用编辑器打开编辑(推荐使用vscode或者typora)
预览
输入命令(blog目录下使用git):hexo s(如上)
确认无误后先生成一遍文件
输入命令(blog目录下使用git):hexo g
之后即可部署到GitHub
输入命令(blog目录下使用git):hexo d
之后每次上传博客都是此顺序
部署之后可发现GitHub中多了文件,此时浏览器输入:用户名.github.io(Github仓库名)就可以访问博客啦(刚刚部署后需要一定时间加载,出现未更新等待一段时间即可)