Git + Hexo Blog 搭建
Hexo blog 官网: https://hexo.io/zh-cn/
相关步骤
1、安装 Node.js 和配置好 Node.js 环境,打开 cmd 命令行,成功界面如下
1 | node -v |
2、安装 Git 和配置好 Git 环境,安装成功的象征就是在电脑上任何位置鼠标右键能够出现如下两个选择
注意:一般出于安全考虑,只有在 Git Bash Here 中才能进行 Git 的相关操作。如果需要在cmd命令行里调用Git,那么就要配置电脑的环境变量 Path,或者在安装的时候选择 use Git from the Windows Command Prompt。这个可有可无,影响不大,成功配置的界面如图
1 | git --version |
3、Github 账户注册和新建项目,项目必须要遵守格式:账户名 .github.io
,不然接下来会有很多麻烦。并且需要勾选 Initialize this repository with a README
在建好的项目右侧有个 settings 按钮,点击它,向下拉到 GitHub Pages ,你会看到那边有个网址,访问它,你将会惊奇的发现该项目已经被部署到网络上,能够通过外网来访问它。
4、安装 Hexo,在自己认为合适的地方创个文件夹,我是在 D盘 建了一个 blog 文件夹。然后通过命令行进入到该文件夹里面
输入 npm install hexo -g
,开始安装 Hexo
1 | npm install hexo -g |
输入 hexo -v
,检查 hexo 是否安装成功
1 | hexo -v |
输入 hexo init
,初始化该文件夹(有点漫长的等待。。。)
1 | hexo init |
看到后面的 “Start blogging with Hexo!”,激动有木有!!!!!
输入 npm install
,安装所需要的组件
1 | npm install |
输入 hexo g
,首次体验 Hexo
1 | hexo g |
输入 hexo s
,开启服务器,访问该网址,正式体验 Hexo
1 | hexo s |
问题:假如页面一直无法跳转,那么可能端口被占用了。此时我们 ctrl+c
停止服务器,接着输入 “hexo server -p 端口号” 来改变端口号
1 | hexo server -p 5000 |
那么出现如下图就成功了
5、将 Hexo 与 Github page 联系起来,设置 Git 的 user name 和 email(如果是第一次的话)
上图是在其文件夹里面鼠标右键,点击 Git Base Here 。这里 “feng” 可以替换成自己的用户名,邮箱可以替换成自己的邮箱
输入 cd ~/.ssh
,检查是否由 .ssh 的文件夹
输入 ls
,列出该文件下的内容。下图说明存在
输入 ssh-keygen -t rsa -C "929762930@qq.com"
,连续三个回车,生成密钥,最后得到了两个文件:id_rsa 和 id_rsa.pub (默认存储路径是:C:\Users\Administrator.ssh)。
1 | ssh-keygen -t rsa -C "929762930@qq.com" |
输入 eval "$(ssh-agent -s)"
,添加密钥到 ssh-agent
1 | eval "$(ssh-agent -s)" |
再输入 ssh-add ~/.ssh/id_rsa
,添加生成的 SSH key 到 ssh-agent
1 | ssh-add ~/.ssh/id_rsa |
登录 Github ,点击头像下的 settings ,添加 ssh
新建一个 new ssh key,将 id_rsa.pub 文件里的内容复制上去
输入 ssh -T git@github.com
,测试添加 ssh 是否成功。如果看到 Hi 后面是你的用户名,就说明成功了
1 | ssh -T git@github.com |
问题:假如 ssh-key 配置失败,那么只要以下步骤就能完全解决
1 | 首先,清除所有的 key-pair |
6、配置 Deployment,在其文件夹中,找到 _config.yml 文件,修改 repo 值(在末尾)
repo 值是你在 github 项目里的 ssh(右下角)
7、新建一篇博客,在 cmd 执行命令:hexo new post "博客名"
1 | hexo new post "你好,Hexo" |
这时候在文件夹 _posts 目录下将会看到已经创建的文件
在生成以及部署文章之前,需要安装一个扩展:npm install hexo-deployer-git --save
1 | npm install hexo-deployer-git --save |
使用编辑器编好文章,那么就可以使用命令: hexo d -g
,生成以及部署了
1 | hexo d -g |
部署成功后访问你的地址:http://用户名.github.io。那么将看到生成的文章
好了,到此为止,最基本的也是最全面的 hexo + github 搭建博客完结。
8、关于 Hexo 更换主题
8.1 如何获取主题呢?
从 Hexo 官方网址,我们可以看到很多主题的预览,以及它的获取方式
8.2 使用 git clone
获取到主题我们放那边呢?
在 Hexo 的项目目录下有一个 themes 文件夹,我们只需要把 主题项目放到该文件夹下面即可
8.3 如何使用主题?
Hexo 项目切换主题
我们需要配置 hexo 项目下的 _config.yml 文件,使我们的项目切换到我们想要的主题
只需修改 theme 参数 为我们 themes 文件夹下对应主题文件夹的名称即可
主题配置文件的修改
只是切换主题,很多主题的一些配置不能使用,所以需要修改主题的配置文件在主题录下面有一个 _config.yml 文件
专门用于配置主题指定的一些静态资源文件,以及图片头像等。