以前学Django时,看的视频教程就是以搭建博客为案例讲解的。虽然最终也没搭建成功,但是当时就想搭建属于自己的博客。偶然间了解到了hexo搭建博客,恰好最近有空,索性就利用这段时间搭建一个属于自己的博客。首先,我先介绍一下用hexo搭建博客的基本流程:
基本流程:
1.搭建前的准备(包括node.js,git,github账户的配置)
2.安装hexo
3.配置hexo
4.连接hexo与github page
5.发布文章
搭建前的准备
1.安装node.js
2.安装git
3.github账户管理
配置Node.js
下载node.js。根据自己电脑的配置自行安装。
安装完成后打开终端输入:
1 | node -v |
进行是否安装成功测试。如不正确,回头检查哪一步错误。
配置Git
git官网。自行安装。
安装完成后打开终端输入:
1 | git --version |
以上步骤进行是否安装成功。如果安装失败自行面壁。
github管理
已拥有账号可跳过注册此步
打开github进行注册。
登录后点击右上角加号,选择New repository新建代码库。
进入代码库创建页面:
在Repository name下填写yourname.github.io,Description (optional)下填写描述(此步可忽略)。
注意:我的github名称是qianyouyou ,这里就填qianyouyou.github.io
建立后,点击界面右侧的Settings,你将会打开这个库的setting页面,向下拖动,直到看见GitHub Pages。点击Automatic page generator,Github将会自动替你创建出一个gh-pages的页面。 如果你的配置没有问题,那么大约15分钟之后,yourname.github.io这个网址就可以正常访问了~ 如果yourname.github.io已经可以正常访问了,那么Github一侧的配置已经全部结束了。
安装hexo
在合适的地方创建文件夹,这里我以E:/blog 为例子讲解,首先在E盘目录下创建blog文件夹,终端锁定该文件夹
在命令行输入
1 | npm install hexo -g //进行安装 |
输入
1 | hexo -v //检验是否安装成功。 |
配置hexo
输入
1 | hexo init //初始化该文件夹 |
看到后面的“Start blogging with Hexo!”证明正在执行。
输入
1 | npm install //安装所需要的组件 |
输入
1 | hexo g //生成 |
输入
1 | hexo s |
开启服务器,访问该网址,正式体验Hexo
连接hexo与github page
设置Git的user name和email(如果是第一次的话)在blog文件夹里面鼠标右键,点击Git Base Here。
输入cd ~/.ssh,检查是否由.ssh的文件夹
输入ls,列出该文件下的内容
输入ssh-keygen -t rsa -C “xxxxxx@xx.com”,(你的邮箱)连续三个回车,生成密钥,最后得到了两个文件:id_rsa和id_rsa.pub(默认存储路径是:C:\Users\Administrator.ssh)。
输入eval “$(ssh-agent -s)”,添加密钥到ssh-agent
再输入ssh-add ~/.ssh/id_rsa,添加生成的SSH key到ssh-agent
登录Github,点击头像下的settings,添加ssh
新建一个new ssh key,将id_rsa.pub文件里的内容复制上去
输入ssh -T git@github.com,测试添加ssh是否成功。如果看到Hi后面是你的用户名,就说明成功了
问题:假如ssh-key配置失败,那么只要以下步骤就能完全解决
首先,清除所有的key-pair
ssh-add -D
rm -r ~/.ssh
删除你在github中的public-key
重新生成ssh密钥对
ssh-keygen -t rsa -C “xxx@xxx.com“
接下来正常操作
在github上添加公钥public-key:
1、首先在你的终端运行 xclip -sel c ~/.ssh/id_rsa.pub将公钥内容复制到剪切板
2、在github上添加公钥时,直接复制即可
3、保存
测试:
在终端 ssh -T git@github.com
配置Deployment,在其文件夹中,找到_config.yml文件,修改repo值(在末尾)
repo值是你在github项目里的ssh(右下角)
发布文章
新建一篇博客,在cmd执行命令:hexo new post “博客名”
这时候在我的 电脑的目录下 E:\blog\source\ _posts 将会看到 article title.md 文件
在生成以及部署文章之前,需要安装一个扩展:
1 | npm install hexo-deployer-git --save |
用MarDown编辑器打开就可以编辑文章了。文章编辑好之后,运行生成、部署命令:
1 | hexo g // 生成 |
当然你也可以执行下面的命令,相当于上面两条命令的效果
1 | hexo g -d //在部署前先生成 |
部署成功后访问你的地址:http://用户名.github.io。那么将看到生成的文章。
到此为止,最基本的也是最全面的hexo+github搭建博客完结。