GitHub Pages + Hexo 搭建个人博客网站

文章目录

  • 前言
  • 环境配置
  • 搭建步骤
    • 1. 利用 npm 安装 hexo 框架
    • 2. 利用 hexo 初始化博客
    • 3. 新建 username.github.io 仓库
    • 4. 将站点部署到 GitHub Pages 上
    • 5. 更改博客主题
    • 6. 绑定个人域名
  • 参考资料

前言

无论是不是程序员,拥有一个由自己搭建的个人网站总归是一件值得肯定和尝试的事情。

本站基于 GitHub Pages + Hexo 搭建,并采用了简洁优雅的 Keep 主题。

操作系统环境为Win 10

环境配置

  • 一个可用的GitHub账号,新建仓库以使用免费的 GitHub Pages 服务,将个人网站挂载到上面,这样就可以不用自己租云服务器啦。

  • Git:下载最新版即可。Git 可以将本地代码仓库与 GitHub 远程代码仓库连接起来,便于进行代码提交和版本控制。

  • Node.js:下载LTS稳定最新版。npm 是随同 Node.js 一起安装的包管理工具,安装 hexo 框架需要使用 npm

搭建步骤

1. 利用 npm 安装 hexo 框架

推荐使用 git bash (模拟 Linux 环境)来执行命令。

TIPS

若 npm 下载速度缓慢,可考虑安装淘宝的 cnpm 国内镜像:

npm install -g cnpm --registry=http://registry.npm.taobao.org

cnpm install -g hexo-cli #安装hexo框架

2. 利用 hexo 初始化博客

mkdir blog	#创建blog目录
cd blog	 #进入blog目录
hexo init 	#生成博客 初始化博客
hexo s	#启动本地博客服务

本地博客访问地址一般为:localhost:4000

GitHub Pages + Hexo 搭建个人博客网站_第1张图片

若访问后显示 hexo 博客默认页面,则说明 hexo 已成功初始化博客。

GitHub Pages + Hexo 搭建个人博客网站_第2张图片

3. 新建 username.github.io 仓库

GitHub 新建仓库,如图所示,其它选项保持默认即可:

GitHub Pages + Hexo 搭建个人博客网站_第3张图片

WARNING

图中"xxx"处请填入自己的 GitHub 用户名,比如笔者的用户名为 jamieshui,则仓库名应取名为 jamieshui.github.io,否则 GitHub Pages 服务不生效。

复制自己的仓库链接,推荐使用 HTTPS,因为 SSH 会有连接认证,比较麻烦:

GitHub Pages + Hexo 搭建个人博客网站_第4张图片

4. 将站点部署到 GitHub Pages 上

修改 blog 根目录下的 _config.yml 配置文件,找到 deploy 配置项,按图所示填入相关信息,在 repo 项填入自己的仓库链接:

GitHub Pages + Hexo 搭建个人博客网站_第5张图片

保存后返回 blog 根目录进一步部署:

hexo clean #清理
hexo g #生成
hexo d	#部署到Github仓库里

WARNING

hexo d 有问题,请先设置你的 git 信息:

git config --global user.email "xxx"  #你的GitHub账号注册邮箱
git config --global user.name "xxx"  #你的GitHub用户名

然后通过访问 username.github.io 域名地址即可查看你的博客了。

5. 更改博客主题

在 blog 根目录下克隆 Keep 主题仓库:

git clone https://github.com/XPoet/hexo-theme-keep themes/keep

安装完成后,在 blog 根目录下的 _config.yml配置文件中将 theme设置为keep

theme: keep

Keep 主题文件的具体配置请参考 Keep 主题官方文档:「https://keep-docs.xpoet.cn/usage-tutorial/configuration-guide.html」

配置完成后通过 hexo cleanhexo ghexo d一波三连即可重新部署查看啦。

6. 绑定个人域名

推荐在阿里云购买域名(腾讯云的域名在解析时会跳转DNSPod平台,莫名的卡,操作不顺,不知是我的问题,还是一种普遍现象),实名验证后(需要等待一段时间)即可进行域名解析:

GitHub Pages + Hexo 搭建个人博客网站_第6张图片

域名解析也需要一定时间,打把游戏回来一般基本OK了。

然后进行域名绑定。在 blog 根目录下的 source 文件夹中新建 CNAME 文件,里面写上自己的域名,笔者的是blog.jamieshui.ink,保存后重新部署到 GitHub 上。

在 username.github.io 仓库的 settings 中找到 Custom domain,确保与 CNAME 文件中的域名保持一致。

等待一段时间后即可通过新域名访问自己的博客了。( ̄▽ ̄)/

参考资料

  1. EasyHexo: 「https://easyhexo.com/」
  2. 手把手教你从0开始搭建自己的个人博客 |无坑版视频教程| hexo: 「https://www.bilibili.com/video/BV1Yb411a7ty」
  3. hexo-theme-keep: 「https://keep-docs.xpoet.cn/」

你可能感兴趣的:(hexo,git,github,hexo)