hexo+github搭建个人博客(“简略省流”)
魂祈梦
2021-08-02 Redmi K40
#网站搭建# #Hexo# #网站建设#
前排提示,长图文警告⚠。
感谢酷安@吴建国_ ,@Tianli ,哔哩哔哩@hojun_cn,@青年麦克斯韦,以及无数CSDN和博客园网友
。我大概加起来整了六七个小时,如果加上之前gitee翻车,一共九小时。坚持不懈,善用百度,最终成功了。此图文只讲细节不讲原理,命令处的回车自己敲。
如果报错,请耐心核对文末的报错解决方法
目录:
1.git和node.js的安装(太简单懒得放图)
2. github账号创建,搭建仓库
3. git和github绑定,ssh设置
4. 创建文件夹并用命令进入文件夹
5. 一堆powershell或cmd代码,教程中统称命令行
6. 修改_config.yml文件
7. 又是一堆代码(把本地网站推送到github)
8. 查看效果
9. 报错合集(只写了我遇到并解决的)
1.git安装
查看链接
node.js安装
下载
查看链接
如果直接安装一般会报错2503,所以我们用命令行
win+X,再按A(以管理员身份打开命令行)
输入命令
msiexec /package 路径\完整文件名称
例
msiexec /package C:\Download\node-v14.17.4-x64.msi
此处C:\Download为路径,node-v14.17.4-x64.msi是名称
建议全部点next,安装在D盘可能有不必要的报错(我遇到了)
2.github账号创建,搭建仓库
如果你不会注册,那还是放弃这篇图文吧(没必要)
自行注册
查看链接
搭建仓库
网站页面右上角+号,点“New repository”
在Repository name中输入与左侧相同的名称+.github.io
描述不写,勾选“Add a README file”
点击下面绿色按钮创建
3.绑定
回到桌面,点击搜索,输入git bash,打开(只要打开gitbash就行,可以在开始菜单找)
输入
git config --global user.name "GitHub用户名"
注意空格,注意输入法切换到英文
例
git config --global user.name "OldSaltFish"
输入
git config --global user.email "github绑定邮箱"
例
git config --global user.email "3295696322@qq.com"
输入
ssh-keygen -t rsa -C "邮箱如上"
不例了
这里多按几下回车
完成后是这样子
然后可以关闭这个窗口了
打开C盘→用户→用户名→.ssh
用记事本打开其中的id_rsa.pub文件,全选,复制,关闭
浏览器github,点击右上角头像处,下面“Settings”,左侧“SSH and GPG keys”,右上角“New SSH key”,title任意填,key中粘贴,下面绿色按钮添加ssh,成功后你的邮箱会收到消息
回到.ssh文件夹,空白处右键,Git Bash Here
输入
ssh git@github.com
一般是缺少文件,输入yes再回车
一般最后一行是xxxxx closed就成功了
.ssh文件夹中多出一个known_hosts文件
可以关闭此窗口了
4.创建文件夹
创建一个文件夹(图方便就在桌面)
打开文件夹,点击地址栏然后复制
win+x,再按A进入命令行
输入cd空格然后鼠标右键,回车
例
cd C:\Users\言续\Desktop\blog
此处文件夹名称是blog
5.命令(快乐报错环节)
输入
npm install -g hexo-cli
注意是cli不是cil(我一般手打,容易错)
耐心等待,这个时间很长
输入
hexo init
输入
hexo g
输入
hexo s
到浏览器输入
localhost:4000
查看效果
回到命令行
Ctrl+C
终止,如果没反应多试一次
输入
git --version
输入
git config --global init.defaltBranch main
6. 修改_config.yml文件
之前创建的文件夹中,找到_config.yml文件,打开,此处推荐用VS code,当然记事本应该是一样的。
进行
介绍
title:网站名称(主标题)
subtitle: 副标题(可以不写)
description: 网站描述
keywords: 密码,一般不改
auther :作者,网站底部Powered by xx
language:语言,改为zh–CN
timezone:应该是时区,不用改
注意修改时每个冒号后面都要留个空格
url: 网址,改http://后面的内容为用户名.github.io
例
查看链接
鼠标滚轮到最底下
type后改git
回车加一行
repo:
注意不是rope
打开浏览器,github中打开你的仓库,点击code,点击ssh,右侧复制
最小化浏览器,回到编辑页面
粘贴到repo
回车一行
branch: main
最后要有一行空白(有没有用我不知道,这是规范)
Ctrl+S保存,退出,回到命令行
输入
npm install hexo-deployer-git --save
输入
hexo clean
输入
hexo g
输入
hexo d
成功
8.查看效果
打开浏览器
地址栏输入
用户名.github.io
例
OldSaltFish.github.io
别急,换个浏览器,或者直接重启电脑
QQ浏览器
最好重启
9.报错合集
9.1powershell在此系统中禁止执行脚本
输入
set-ExecutionPolicy RemoteSigned
回车
Y
回车
9.2
The authenticity of host 'github.com (192.30.253.113)' can't be established.
yes
回车
9.3
node.js卸载报错2503
使用腾讯软件管家等软件卸载(系统自带的会报错)
9.4
长期停在rollbackFailedOptional verb xxx
网络不太行,给magic换个节点或者使用淘宝源
输入
npm config set registry 查看链接
之后你输入的所有命令都要吧npm改为cnpm
9.5
Permission denied (publickey)
一般来说是你没有在github上建立ssh就执行了ssh git@github.com
仔细看看第3条,去github上添加ssh
9.6
but GitHub does not provide shell access
这是配置ssh显示的中间一段,其实这不是报错
9.7
You should configure deployment settings in _config.yml first!
插件没装或者branch没改对
输入
npm install hexo-deployer-git --save
打开文件夹中_config.yml
把branch后面改为main
9.8
输入hexo d后只显示一行Validating config
你可能没有保存_config.yml,保存后再输入hexo d
9.9如果实在有问题无法解决
卸载重装node.js,删除当初新建的文件夹(不能只删除里面的文件),重新看看哪里错了。
行文框架查看链接
仔细看看还是有很多不同的,我觉得我不算抄袭。
教程到此结束,后续主题以及编写去看其他大佬,教程有用请给个赞。