使用Hexo+Github搭建个人博客
使用Hexo+Github搭建个人博客
Zaixuele作为个人博客搭建后的第一篇文章,我会简单分享如何使用 Hexo+Github 来零成本搭建个人博客,以及如何使用主题来美化博客。
前置准备
首先,请确保已经安装了
- nodejs
- npm
- git
我们可以通过运行命令提示符(cmd),输入
1 | node -v |
来查看安装版本以确定成功安装前置。
在前置安装完成之后,在cmd中输入
1 | npm install hexo-cli -g |
来下载Hexo。
本地生成 Hexo 博客内容
在你想要进行存储内容的位置新建文件夹并命名为 Blog ,在文件夹内空白处右击,选择 在终端中打开,输入
1 | hexo init |
以安装Hexo
如果此处显示 Command not found 或 无法将“hexo”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请使用 npx hexo init,后续不在重复。
完成后分别输入
1 | hexo g(等待hexo生成网站静态文件) |
完成后在浏览器输入 http://localhost:4000 就可以看到默认网站了!
确认无误后可以使用 Ctrl+C 来关闭本地预览。
此时网站只是在本地服务器,我们接下来还需要借助 Github 仓库来让其他人可以访问我们的博客。
创建 Github 仓库
完成上述步骤,我们接着来创建用于存储静态页面的仓库。
首先,注册/登陆 Github
点击 Creat A New Repository,进入新建仓库的界面。
仓库名填为
1 | username.github.io (unsername就是你注册时填写的用户名,很重要,不能写错!) |
选择 Public 以及 Add A README file
到下面点击 Creat 完成仓库创建
生成 SSh Keys
在Blog文件夹下,空白处右键点击 Git Bash Here,在Git Bash页面输入
1 | ssh-keygen -t rsa -C "邮箱地址" (邮箱地址请自行填入) |
按 4 下回车
接着,在文件资源管理器中,进入C:\Users\用户名,进入.ssh文件,使用记事本打开 id_rsa.pub ,全选复制所有内容。
打开 Github ,进入用户设置,找到 SSh Keys
新建 SSh Keys,名称随意填写,将复制的代码全部粘贴到 Key 中,点击创建。
让我们测试一下是否成功:
在 Git Bash 中输入
1 | ssh -T git@github.com |
如果成功,会显示
1 | Hi xxx! You've successfully authenticated, but GitHub does not provide shell access. |
上线博客
在 Github 之前创建的仓库,点击右上方 Code ,复制 Https 连接。
在之前创建的 Blog 文件夹中,使用合适的文本编辑器(vscode > 记事本 > word)打开 _config.yml
在最底部的 deploy 后面的部分全部删除,复制粘贴如下部分
1 | type: git |
!!!注意格式!!!
每行最前面有两个空格,每个冒号后有一个空格
确认无误后,保存并退出。
安装自动部署发布工具
回到 Blog 文件夹, 右键在终端中打开,输入
1 | npm install hexo-deployer-git --save |
完成后继续输入
1 | hexo cl (清除本地缓存,推荐每次生成前运行一下) |
第一次使用 git 会需要进行配置
1 | git config --global user.email "邮箱" |
完成后再运行
1 | hexo d |
在跳出的窗口中登陆 Github
如此这般,我们就把本地静态博客上传到 Github 仓库了!
稍等片刻,进入 Username.github.io 就可以看到我们的博客了
Hexo基本操作
1 | hexo cl (清除本地缓存) |
最后一条命令会在Blog/source/_posts创建一个 文章标题.md 文件,使用 markdown 语法来完成写作。
主题美化
本站使用主题为Anzhiyu,此外还推荐Hexo-Theme-Butterfly,Hexo 有大量社区资源,可以自行搜寻喜欢的主题。