搭建Hexo并部署到Github

写文章的目的

鉴于网络上的教程鱼龙混杂、思维混乱,甚至因为时效性的问题有些教程已经不具有参考价值,所以我觉得有必要总结一下搭建hexo并部署到GitHub的经过,以便后来人参考。

我用的平台

我使用的是Windows10,所以此教程基本在Windows系统通用。

要准备的东西

系统安装Node.jsGit、注册一个GitHub账户

一、本地安装hexo

打开Git Bash,输入命令:

npm install hexo-cli -g

安装完成之后,使用命令 hexo init /c/blog 部署hexo,其中 /c/blog 意为指定C盘blog目录,可自行修改。

如果执行之后提示:未找到命令

把hexo加到系统环境变量中即可。

命令执行完成之后,hexo就已经在本地部署完成,使用命令 hexo server 即可在本地启动hexo,启动之后访问 http://localhost:4000 即可查看效果,如果没出问题的话,应该会出现下图界面:

local

二、配置及部署

至此我们已经在本地搭建好了hexo,为了将hexo部署到GitHub pages,我们需要进行一系列的配置。

1、配置Git

git config --global user.email “你的GitHub注册邮箱”

git config --global user.name “你的GitHub用户名”

然后生成你的密钥

ssh-keygen -t rsa -C “你的GitHub邮箱”

执行之后直接三次回车即可

然后在你的用户目录会出现一个 .ssh 文件夹,具体路径为C:\Users\用户名\.ssh,打开该目录下的 id_rsa.pub 文件,该文件为公钥,将其内容复制到GitHub,如下图操作:

setting

keys

add

保存之后测试是否成功:

ssh -T git@github.com

执行命令之后如果终端出现 Hi!You’ve successfully authenticated 则证明环境配置成功。

2、建立仓库

我们需要在GitHub上建立一个仓库用来存放hexo的文件,具体步骤如下图:

new

repo

这里要注意的是,仓库的名称必须为 你的用户名.github.io ,其他的仓库名均无法使用。

3、在GitHub上部署hexo

经过前两步的操作,我们已经完成了准备工作,已经可以准备在GitHub上部署hexo了,在这之前我们需要将本地hexo和GitHub仓库建立联系。

修改blog文件夹下的 _config.yml 文件,直接拉动最底部,修改deploy的内容

conect

修改完成之后我们需要安装一个插件,有了这个插件我们才能将hexo部署到GitHub pages。

执行以下命令:

npm install –save hexo-deployer-git

安装完成之后即可开始部署到GitHub

执行以下命令

hexo clean # 清除缓存文件

hexo d -g #生成静态文件并部署到GitHub

执行完成之后,静等缓存同步,不出意外的话你已经可以通过 https://你的用户名.github.io 访问到你的博客了。

三:绑定域名与开启https

为了美观以及方便访问,我们可以给GitHub pages绑定个人域名,在经过几次更新之后,绑定域名的操作已经很人性化了。

1、创建CNAME文件

在source文件夹下创建CNAME文件,文件内容为你要绑定的域名。

cname

然后执行命令

hexo d -g

2、设置域名解析

在你的域名服务商处设置两个CNAME解析,分别为www和@,如下图:

www

@

保存之后静等解析生效,大概需要10分钟左右。

3、开启https

当你解析域名生效之后,即可通过域名访问GitHub pages,但是你会发现访问并不是https,这是因为你的域名没有与之对应的证书,不过不用担心,GitHub已经准备了免费的证书供你使用,按照下图演示开启即可。

setting

enforce

注意:有些情况下 强制https 开关会显示不可用,这是因为你的证书还未准备好,稍等片刻即可。

如果您发现本文有错误或者您在某些步骤遇到了问题,欢迎您发邮件到 amdin@cyblogs.cn ,我会尽可能解答您的疑问。

文章标题:搭建Hexo并部署到Github

文章字数:1k

本文作者:Chaos

发布时间:2019-07-15, 17:04:59

最后更新:2019-11-19, 20:48:48

原始链接:https://www.cyblogs.cn/build-hexo-on-github.html

版权声明: "署名-非商用-相同方式共享 4.0" 转载请保留原文链接及作者。

目录