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

前言

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

本站基于 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

image

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

image

3. 新建 username.github.io 仓库

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

image

WARNING

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

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

image

4. 将站点部署到 GitHub Pages 上

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

image

保存后返回 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平台,莫名的卡,操作不顺,不知是我的问题,还是一种普遍现象),实名验证后(需要等待一段时间)即可进行域名解析:

image

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

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

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

image

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

参考资料

  1. EasyHexo: 「https://easyhexo.com/
  2. 手把手教你从0开始搭建自己的个人博客 |无坑版视频教程| hexo: 「https://www.bilibili.com/video/BV1Yb411a7ty
  3. hexo-theme-keep: 「https://keep-docs.xpoet.cn/
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,029评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,238评论 3 388
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,576评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,214评论 1 287
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,324评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,392评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,416评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,196评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,631评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,919评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,090评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,767评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,410评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,090评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,328评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,952评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,979评论 2 351

推荐阅读更多精彩内容