Hexo+Github 搭建博客
搭建过程:Hexo框架 - Github部署 - butterfly主题配置与优化 - 域名
更详细的教程请看 hexo博客搭建 !
Nodejs 和 Git 安装
下载安装过程不多说qwq。Nodejs、Git分别前往官方下载即可。只不过,安装时候,记得勾选Add to path (重启生效)
。否则,环境变量不生效。
安装完成,并重启电脑,检验安装环境:
git version
node -v
npm -v
分别运行以上代码,然后出现版本号时,即为安装成功。
安装Hexo
在自己喜欢的地方(不建议在桌面和C盘),右键Git bash here
,运行以下命令,安装Hexo:
npm install -g hexo-cli
安装完成之后,再分别执行如下命令,进一步安装Hexo文件:
hexo init _myblog
cd _myblog
npm install
其中,
_myblog
为文件夹名称,运行此行命令后,会新建一个文件夹。因此,无需自己提前新建立文件夹。此外,文件夹名称随便起,看自己喜好。
OK. 如果上述过程没有报错的话,就说明以上步骤均已成功。
接下来,进入到自己的_myblog
文件夹,右键Git bash here
,运行
hexo g && hexo s
回车,
然后会看到提示:Hexo is running at http://localhost:4000
。此时,浏览器打开http://localhost:4000
,就可以看到默认的网站了。只不过,这是初始的主题。配置好以后,可以进行更换。
若想停止
server
服务,则在bash
内按下ctrl+c即可,之后,Git bash here
就会自动停止server
服务,并自动退出。
目前为止,本地博客以及搭建成功,接下来搭建至Github Pages。
注册Github
?别告诉我你不知道!
墙裂建议win10的EDGE浏览器!
一样,注册过程不再多说。
不过,有一点需要注意。
不要用QQ邮箱辣!!!QQ邮箱可以生成英文邮箱的,别再用xxxxxx@qq.com
惹。
网页端进入QQ邮箱,会提示使用英文邮箱,点进去,选择@foxmail.com
邮箱,邮箱名称随便起,其一堆好记的英文比较好。
例如,我的就是frank.ka@foxmail.com
,实质上也是QQ邮箱。但是,看起来比上面那一串高端多了吧!
新建仓库
注册好之后,登录,在Github网页端,点击绿色的New
按钮,新建仓库。
注意,这里的仓库名称,要和自己的用户名相同。还有一点,格式必须规范👇。
例如,我的Github用户名为ciraos。那么,我的仓库名,必须为ciraos.github.io
,然后点击create repository
。
然后,点击create repository
。
注意,从2020/10/1起,Github更新了仓库的分支名称:
main
,部署时,请注意仓库分支,记住分支名称main
,稍后会用。
点击creating a new file
,新建一个index.html
文件,内容随便写,可以写一个hello world
,然后页面划到最底下,点击commit
提交。
最后,页面划到最底下,点击commit new file
,即可生成一个index.html
文件。
然后就可以在Github仓库里面看到自己创建的index.html
辣!
然后,点击仓库最右边的settings
,往下拉,看到一个Github Pages
模块。
如果下图,蓝色部分显示ready to be published at
,说明github正在部署。
如果显示的是
ready to be published at
,就说明github正在部署,稍等一会儿,重新刷新网页,就可以看见它显示is published at
了!
如果是下面的情形is published at xxx
,就说明github部署成功了,此时,就可以访问 https://youname.github.io
啦!
此时,网页打开https://用户名.github.io
,例如,我的就是https://ciraos.github.io
。就可以看见刚刚自己写的一行了。
配置SSHKey
运行bash
、cmd
等等,都可以,只要你能运行下列代码:
cat ~/.ssh/id_rsa.pub
在任意文件夹运行此行代码,查看本地生成的密钥。如果有报错或者提示啥的,或者没有以ssh-rsa
开头和youremail@example.com
结尾的话,就说明没有生成过。
那么,接下来,部署sshkey,并关联到Github。
git config --global user.name "用户名"
git config --global user.email "邮箱地址"
其中,
- “用户名”、“邮箱地址”,分别为Github的用户名、邮箱地址。
然后,开始生成密钥,
ssh-keygen -t rsa -C "上面的邮箱"
之后,无需多做什么,连按三次回车,即可。
接下来,再次检查密钥,
cat ~/.ssh/id_rsa.pub
如果显示的是,ssh-rsa
开头的,yourmail@xx.com
结尾的一大串英文。那么,恭喜你。密钥部署成功。
部署至Github
找到密钥文件,通常在C:\Users\yourusername\.ssh\id_rsa.pub
内,用记事本打开,放到一边,或者最小化,稍后会用。
打开Github,点击右上角自己的头像,在下拉菜单中选择Settings
,然后选择SSH and GPG keys
,点击New SSH key
。
Title
随便取,key
填写刚刚找的id_rsa.pub
内的所有内容,复制粘贴即可。
然后,Github会发一条邮箱,提示你新建立了一个密钥。
接下来,将Github添加到SSH信任列表,
ssh -T git@github.com
在提示中输入yes
即可。
如果返回Hi xxx! You've successfully authenticated, but GitHub does not provide shell access.
,则说明添加成功。
打开站点配置文件_myblog
,打开_config.yml
,找到
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
- type: git
repo:
github: git@github.com:username/username.github.io.git
branch: main
将原本配置改为上述配置,并将username
改为自己的Github用户名。
注意,从2020/10/1起,Github更新了仓库的分支名称:main
,部署时,请注意仓库分支,记住分支名称main
。
安装一个部署插件,在博客根目录右键Git bash here
,
并在Git bash here
中输入如下代码,安装插件:
npm install hexo-deployer-git --save
安装完成后,运行如下代码,部署至Github仓库。
hexo cl && hexo g && hexo d
会看到Github仓库更新了很多文件吧,那就是成功了!
然后稍等一会儿,就可以访问https://yourusername.github.io
辣!
[持续更新,未完待续]
好啦,到此结束啦!欢迎讨论哦!