windows-hexo-github搭建个人博客步骤及常见问题
小白花了两天时间搭建了自己的独立博客,进了很多坑,在这里分享一下,愿大家少走弯路。
特别鸣谢Code_Y,我也是跟着他的教程一点点学的。
1. 环境安装:
下载安装软件:
我使用的版本是:
这里说明一下:
版本过低时,可能会报错,因此建议下载最新版本。
安装好后,桌面会出现两个小图标
2. 测试SSH Key
在桌面或开始菜单找到Git Shell
如上图显示;
等待打开后输入一下命令
1 | ssh -T git@github.com |
如图:
如果出现问题,可以卸载GitHub for Windows 客户端,重新安装一遍
3. 注册Github
ps:这里要注意一点,因为博客名称要与用户名一致,所以注册填写用户名的时候最好先想一下博客的名称;
例如,我的博客想用这个地址http://zhouxm0604.github.io/,那么申请的用户名就应该是zhouxm0604,只是个人经验,不一定对。
如图:
点击sign up或者直接在下侧填写,申请成功后验证邮箱并登录(点击sign in)。
4. 在github上创建仓储:
登录后-点击右上角new repository创建仓储,创建仓储名称填写yourname.github.io,
如图:
例如:仓储名称,我就写的是zhouxm0604.github.io
5. 使用Hexo创建博客框架
a. Hexo安装
打开Git Shell
启动后一次输入一下命令:
1 | cd / |
1 | npm install hexo-cli -g 或 npm install -g hexo |
提示:cd / 作用是返回根目录,Git Shell 默认装在 C盘,启动时默认路径为 C:\Users\xxx(用户名)\Documents\GitHub,输入 cd / 命令后就返回到了 C盘根目录下。
安装之后可以输入
1 | hexo -v |
检查一下是否安装成功
我装的是3.2.0的
b. Hexo部署
打开Git Shell
启动后输入一下命令
1 | cd / |
1 | hexo init hexo |
第一次报错
升级了node的版本后,再次进行部署,可以正常部署
使用命令,安装依赖文件(注意在hexo目录下安装)
1 | npm install |
经过以上两个方法的任意一种之后,Hexo 会自动在目标文件夹建立博客网站所需要的所有文件。
此时可以通过输入以下命令在本地进行预览:
1 | hexo generate (可以简写成: hexo g) |
如图:
1 | hexo server |
如图:
此时打开浏览器,在浏览器地址栏输入 http://localhost:4000/ (默认端口为4000)便可以看到最原始的博客了
如图:
6. 将本地文件部署到GitHub
修改 Hexo 中的 _config.yml 文件
用编辑器打开
找到其中的 deploy 标签,改成如图所示,并保存:
这里一定要注意格式:
冒号是半角英文,并且顶头空一格,冒号后面空一格,最后不空格
这边格式不对,也会各种报错。
其中 branch 选项可以填写 master 或 gh-pages。
如果你是为一个项目制作网站,那么需要把 branch 设置为 gh-pages 。若要绑定自定义域名也可以参考Hexo 或 Github Page 的帮助文档,制作一个 CNAME 文件。
hexo3.0以上版本需要单独安装Git
1 | npm install hexo-deployer-git --save |
将其deploy到仓储中
hexo clean
hexo generate(简写g)
hexo deploy (简写d)
如果此时依然报错
或者是其他错误
查看环境变量path中是否加入git
方法:cmd-path
如果没有添加,打开hexo中git的位置,复制,粘贴加入环境变量中去
再次执行命令:
hexo clean
hexo generate(简写g)
hexo deploy (简写d)
恭喜,到这一步,个人博客就已经部署到 GitHub 上了,此时通过 your_user_name.github.io(即你那个仓库的名称,形如:”你的 GitHub 用户名”.github.io) 就可以看到你的个人博客了。
使用 hexo new “文章名称” 可以进行新建文章