github + hexo 搭建个人博客


Hexo是一款基于Node.js的静态博客框架,依赖少易于安装使用,可以方便的生成静态网页托管在GitHub和Coding上,是搭建博客的首选框架。
使用github pages服务搭建博客的好处有:

  • 全是静态文件,访问速度快;
  • 免费方便,不需要服务器不需要后台;
  • 可以随意绑定自己的域名,不仔细看的话根本看不出来你的网站是基于github的;
  • 数据绝对安全,基于github的版本管理,想恢复到哪个历史版本都行;
  • 博客内容可以轻松打包、转移、发布到其它平台;

准备工作

1、安装Git
2、安装Node.js
3、github账号

安装Git

Git是目前世界上最先进的分布式版本控制系统,可以有效、高速的处理从很小到非常大的项目版本管理。也就是用来管理你的hexo博客文章,上传到GitHub的工具。
windows:到git官网上下载。
linux:sudo apt-get install git
查看git版本

git --version

安装Node.js

Hexo是基于nodeJS编写的,所以需要安装一下nodeJs和里面的npm工具。
windows:nodejs官网下载安装(选择LTS版本就行了)。
linux:

sudo apt-get install nodejs
sudo apt-get install npm

查看版本

node -v
npm -v

安装Hexo

官网: http://hexo.io
github: https://github.com/hexojs/hexo
安装hexo

// 安装hexo
npm install -g hexo-cli
//查看版本
hexo -v

初始化hexo

//在文件需要存放的目录下,执行初始化
hexo init myblog
//进入这个myblog文件夹
cd myblog 
// 安装所需依赖
npm install

hexo 常用命令行

hexo  g  //生成静态文件,文件生成public 目录中
hexo  s  //开启本地预览服务,打开浏览器访问 http://localhost:4000
hexo  d  //发布代码
hexo new  文章名称  //创建文章
hexo clean //清理

修改主题

默认主题很丑,现在hexo官网上找个自己喜欢的主题进行替换。官方主题,本文已Matery主题为例
把下载的主题解压的整个文件夹放到根目录themes文件夹下


修改根目录下的_config.yml 中的theme: landscape改为theme: hexo-theme-matery-master(themes目录下主题的文件夹的文件夹名称),然后重新执行hexo g来重新生成。

主题中的标签、分类、关于显示404,需要我们自己进行添加

添加标签页面

hexo new page tags //根目录下执行

这个时候source 下面生成了一个tags文件夹,打开tags文件下的index.md 文件,设置文件的type,layout

title: yinol博客标签
date: 2021-02-09 14:53:41
type: "tags"
layout: "tags"

添加分类页面

hexo new page categories //根目录下执行

这个时候source 下面生成了一个categories文件夹,打开categories文件下的index.md 文件,设置文件的type,layout

title: yinol博客标签
date: 2021-02-09 14:53:41
type: "categories"
layout: "categories"

添加关于页面

以上述一样,
hexo new page about
修改about文件下的index.md的type 和 layout
type: “about”
layout: “about”

GitHub创建个人仓库

先要有一个GitHub账户,如果没有就注册一个,github官网
创建一个仓库,推荐一篇写得很完善的博客,前往

生成SSH添加到GitHub

本机生成SSH

回到git bash中, 也可以在cmd 中执行

git config --global user.name "yourname"
git config --global user.email "youremail"

这里的yourname输入你的GitHub用户名,youremail输入你GitHub的邮箱。这样GitHub才能知道你是不是对应它的账户。
检查一下用户名和邮箱

git config user.name
git config user.email

创建SSH

ssh-keygen -t rsa -C "youremail"

查看SSH 公钥
方法一:

cat ~/.ssh/id_rsa.pub

方法二:
打开id_rsa.pub直接查看

将SSH添加到github

回到github中

将hexo部署到GitHub

将hexo和GitHub关联起来,也就是将hexo生成的文章部署到GitHub上,打开站点配置文件 _config.yml
注意 ‘ : ‘ 后面是两个空格

deploy:
  type: git
  repo: git@github.com:XXXXX.git
  branch: master

branch 为分支,repo为git地址,如图:

安装发布插件

npm install hexo-deployer-git --save

发布代码

hexo g //生成静态文件
hexo d //发布代码,是把puclic 里面生成好的文件拷贝到.deploy_git 文件夹发布, 所以要先生成静态文件

设置个人域名

在windows的CMD窗口ping ‘github pages 的地址domain’ ,你就知道你的github pages的IP了

在DNS server中添加你的github pages的ip解析。不会的话直接点新手指导

在github 上配置域名指向,仓库setting,一直往下拉找到GitHub Pages ,进行配置

写文章

创建文件

打开命令行,创建文件,创建的文件在source/_posts 下

hexo new "标题名称"

配置文章所属标签和分类

打开创建的文章,配置文章标签和分类,关键字之类的

---
title: '标题名称'
date: 2021-02-19 13:46:23
categories: '分类'
top: true // 为true,是推荐文章,在文章推荐模块可以看到
password: SEO关键字(利于百度收录)
tags:
  - 标签1
  - 标签2
---


发布过程中容易出现的错误,请参考下一篇文章


文章作者: yinol
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 yinol !
  目录