使用Hexo和Github搭建个人博客
使用Hexo和Github搭建个人博客
仅为个人经验总结,应该有更好的搭建方式。建议:最好至少要具备一定的前端知识。
准备工具
在开始配置之前,需要下载以下几个程序:
1、Git
2、node
3、Typora (推荐,用来编辑博客,可用其他编辑器,也可搭建完成后再安装)建议直接到官网下载。
4、一个代码编辑器,推荐VScode,用于修改配置文件时使用。
开始配置
windows10使用控制终端操作,快捷键:win+R,搜索cmd打开
1、安装node后可以通过如下命令检查是否安装成功:
1
2 node -v #查看node版本`
`npm -v #查看npm版本
2、安装淘宝的cnpm
npm install -g cnpm –registry=http://registry.npm.taobao.org
检查版本:
1 cnpm -v
3、安装hexo框架
1 cnpm install -g hexo-cli
检查版本:
1 hexo -v
4、在任意位置创建blog文件夹(名字也随意,不一定是blog),用来放本地博客的数据和文件。如我在H盘创建了blog,地址如:H:\blog。
创建完成后,打开Git CMD(Git正确安装的话,应该在开始菜单内)
使用命令进入创建的这个blog文件夹,例如:
1
2 C:\Users\cai'cheng>H:
H:\>cd blog\
无误后输入如下代码,进行配置(此步可能花费很长时间,如失败或退出,删除该这个blog文件夹,重来):
1 hexo init
待出现 “Start blogging with Hexo!”后,即代表成功。此时blog下会出现很多文件(大概八个),这就是以后操作博客的地方。
5、验证是否成功:
1 hexo s #启动服务
(1)待出现提示”Hexo is running at http://localhost:4000. Press Ctrl+C to stop”后即代表成功,其他提示则错。
(2)打开浏览器地址栏输入localhost:4000,出现hexo的页面则代表你的blog创建成功,但这一步是本地预览,还未托管成功,别人在网上看不到。
注:如第(1)步成功,第(2)步失败,代表4000端口被占用,返回Git CMD先按Ctrl+C退出服务,输入:
1 hexo s -p 5000 #以5000端口启动服务
再在浏览器输入localhost:5000,就能进入页面。
上传到Github Pages
1、首先安装插件:
npm install hexo-deployer-git –save
2、、在自己的Github主页创建一个新的repository
。创建的repository的名字必须为 yourname.github.io
。注意替换yourname。
3、设置Git的SSH。
回到博客根目录的git bash中,输入
1
2 git config --global user.name "yourname"`
`git config --global user.email "youremail"
然后创建SSH,一路回车
1 ssh-keygen -t rsa -C "youremail"
成功生成后一般会在C盘user文件夹里找到.ssh这个文件夹,里面的id_rsa.pub文件就是SSH密钥。
将这个密钥复制下来,在Github的SSH设置里面填入这个密钥,保存后才能部署成功
4、在本地hexo目录下的config_yml里定位到deploy编辑成如下格式,注意冒号有一个空格,必须严格按照格式填写。
1 | YML |
5、需要部署时在博客根目录Git bush使用以下三件套命令:
1 | YML |
6、本地测试时在博客根目录Git bush使用命令:
1 hexo s
出现Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.
时则可以在浏览器打开http://localhost:4000进行测试。
如果在浏览器不能打开http://localhost:4000,则代表4000端口被占用,需要使用其他端口,以5000为例:
1 hexo s -p 5000 #以端口5000进行本地测试。
本地测试时可以改动博客的代码或文件,仅需在浏览器刷新就能看到改动,因此更新博客时最好在本地测试无误后再上传。
编写博客并上传
1、如果没安装,可以安装Typora了,这是一个常用的编辑器,具体功能自行探索。
2、安装好后,在blog根目录下打开Git Bush Here,(下文均默认此操作),输入新建文章命令:
hexo n "文章名"
#生成一篇文章
此时,会在source文件夹里的_posts文件夹里生成 “第一篇文章.md”的文件,双击它可调用Typora进行编写。
其中,title是文章标题,time是生成时间,tags是标签(没有tags暂时不管),然后是正文。编写完后即保存。
注:当你编辑一个新文件完成后,必须将此文件保存到/blog/source/_posts/路径下,不然不能上传博客。
在Git Bush Here里面输入:
1 hexo d
即可更新到github。
使用Vercel部署并绑定域名
使用Vercel部署的好处一是快,二是每当push到github时,Vercel会自动同步,省去了手动部署的麻烦,部署完成还会发送邮件通知。
1、前往https://vercel.com/注册,注册时选择绑定github。
2、创建新项目,选择导入github的博客仓库。
3、在域名提供商处将域名解析到Vercel的DNS地址。
4、在setting里选择domain,填入自己的域名,确定。
5、过一会便能通过此域名访问博客。更新时只需要照常hexo d到github即可,Vercel会自动同步部署。
更改主题
由于建立博客后的初始主题很难看,所以应当换个主题。不同的主题配置方式都不太相同,需要自己修改主题配置文件,所以需要自己去动手了解。官方主题网站:https://hexo.io/themes/ , 选择好后跳转到github下载。好看的有butterfly,next等。以Jerry开发的主题butterfly为例:
在GitHub下载ZIP文件后(或者本地clone仓库),解压。
将文件夹复制到/blog/themes下,然后回到blog\根目录下,用记事本打开_config.yml文件,在最后找到这三行代码:
1 | YML |
将上方theme后的代码改为下载主题的 文件夹的文件名,其他不改,注意空格,如改为Next主题:
1 | CODE |
完成后点击保存。回到Git Bush Here输入:
1 | CODE |