全部频道

首页 热点专区 小学知识 中学知识 出国留学 考研考公
您的当前位置：首页正文

使用GitHub和Hexo搭建免费静态Blog

2024-12-13 来源：要发发知识网

前言

习惯自己写Blog的朋友一定不会陌生Wordpress，或许也曾在新浪博客和QQ空间留过脚印，但静心认真思考一下，似乎我们又总是向往更加简单自由的写作方式。GitHub给我们提供了一个无限的空间，我们需要珍惜使用，而Hexo的出现从某种意义上来说代替了Jekyll，让我们可以更专注于写作本身。本文主要介绍自己的实践心得并不断完善内容，衍生知识和原理推荐大家认真阅读官网的手册，其它推荐参考内容链接在文中也会标注出来。

第一阶段，刚接触Blog，觉得很新鲜，试着选择一个免费空间来写。
第二阶段，发现免费空间限制太多，就自己购买域名和空间，搭建独立博客。
第三阶段，觉得独立博客的管理太麻烦，最好在保留控制权的前提下，让别人来管，自己只负责写文章。

更新历史

扩展阅读

  • Hexo Docs -
  • HelloDog Index -

准备工作

注意 本文主要针对Windows平台和Hexo 3.x

了解Hexo

A fast, simple & powerful blog framework

安装GIT

简单可依赖，安装完成后依据提示操作即可，So Easy

安装Node.JS

注意 安装完成后添加Path环境变量，使npm命令生效

;C:\Program Files\nodejs\node_modules\npm

安装Hexo

配置好GitHub家目录后，双击桌面上的Git Shell，输入npm命令即可安装

npm install -g hexo-cli
npm install hexo --save

Hexo初始化配置

创建Hexo文件夹

安装完成后，根据自己喜好建立目录（如E:\kuaipan\GitHub\hexo），进入Git Shell切换到该路径下E:\kuaipan\GitHub\hexo执行以下指令

hexo init

安装Hexo插件

npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-git --save
npm install hexo-deployer-heroku --save
npm install hexo-deployer-rsync --save
npm install hexo-deployer-openshift --save
npm install hexo-renderer-marked@0.2 --save
npm install hexo-renderer-stylus@0.2 --save
npm install hexo-generator-feed@1 --save
npm install hexo-generator-sitemap@1 --save

本地查看效果

继续执行以下命令，成功后可登录localhost:4000查看效果

hexo server

Hexo简写命令

hexo n #new
hexo g #generate
hexo s #server

部署静态网页到GitHub

注册设置GitHub

  1. 登录，注册自定义用户名如wsgzao
  2. 在主页右下角创建New repository，name必须和用户名一致如wsgzao.github.io
  3. 首次创建耐心等待10分钟左右审核，之后即可访问静态主页如

同步内容至GitHub

  1. 下载
  2. 设置Local path如E:\快盘\GitHub\
  3. 运行Git Shell切换到如E:\快盘\GitHub\hexo路径下
  4. 执行hexo g命令生成public文件夹
  5. 把生成的内容全部拷贝到Local path或其子目录
  6. 运行GitHub确认修改信息后执行右上角的Sync同步
  7. 最后访问主页观察效果

域名和DNS

域名推荐

GoDaddy makes registering Domain Names fast, simple, and affordable.

【推荐理由】两个字“靠谱”，支持支付宝，附优惠码链接

DNS推荐

致力于为您提供最稳定、最安全的域名解析服务
【推荐理由】依然是两个字“靠谱”，感谢他们一直以来对于公益的坚持

设置CNAME

  1. 在Github的网站目录下创建CNAME文件
  2. 填写自己的域名如，保存结束
  3. 登录DNSPod，先添加域名，然后添加记录，设置如下
主机记录 记录类型 线路类型 记录值 MX优先级 TTL
@ CNAME 默认 wsgzao.github.io. - 10
CNAME 默认 wsgzao.github.io. - 10

Hexo配置修改

告诉自己为什么要选择Hexo

知识储备

1.勤学勤练Markdown

本地+云端备份数据是一种习惯

  • Markdown学习路径 -

2.使用性感的文本编辑器

工欲善其事必先利其器

  • Notepad2
  • Sublime Text

Hexo主题

选择主题建议遵循KISS原则

  • Hexo Themes -
  • Pacman -
  • Jacman -

常见问题

1.修改配置文件时注意YAML语法，参数冒号:后一定要留空格
2.中文乱码请修改文件编码格式为UTF-8

如何迁移至Hexo

Hexo 2.X 升级 3.0

1.做好相关配置文件和文章的备份
2.做任何修改前不要忘记第一件事备份

Hexo 3.0 降级 2.X

推荐阅读
显示全文