如何使用 hexo + github 搭建属于自己的博客

windows下利用github和hexo搭建博客

环境依赖

在官网中下载node.js和git,并完成安装。

分别执行以下命令,若返回版本号,则表明安装成功。

1
2
git --version
node --version

github仓库

设置ssh

1
ssh-keygen -t rsa -C "xxx@163.com"

将本地id_rsa.pub的内容,拷贝到github设置中的SSH and GPG keys

安装hexo

1
npm install -g hexo-cli

新建一个目录,然后初始化该目录

1
2
3
4
mkdir blog
hexo init blog # 初始化
cd blog
npm install # 安装组件

本地预览:

1
2
3
hexo g    # 生成页面
hexo s # 启动预览
# 若预览端口被占用使用hexo server -p 5000来更改端口号

本地博客测试成功后,将其上传到github部署

1
2
3
4
5
6
7
8
9
# 安装hexo-deployer-git
npm install hexo-deployer-git --save
# 修改_config.yml文件末尾的Deployment部分为
deploy:
type: git
repository: git@github.com:用户名/用户名.github.io.git
branch: master
# 使用如下命令上传到github,就可以使用https://用户名.github.io进行访问
hexo d

新建博文

自动创建

进入博客所在目录,右键打开Git Bash Here,创建博文。在source/_posts目录下能看到一个My-New-Post.md文件。

1
hexo new "My New Post"

将博文上传到github并发布

1
2
hexo g # 生成页面
hexo d # 部署发布

手动创建

在source/_posts目录下新建一个md文件,并在文件开头加入如下格式的front-matter

1
2
3
4
5
6
7
8
9
10
11
12
13
---
title: Hello World # 标题
date: 2019/3/26 hh:mm:ss # 时间
categories: # 分类
- Diary
tags: # 标签
- PS3
- Games
---

摘要
<!--more-->
正文

更换主题

hexo themes

1
cd /f/blog/git clone https://github.com/liuyib/hexo-theme-stun.git themes/stunnpm install --save hexo-renderer-pug    # 安装依赖

然后修改_config.yml

1
theme: stun

参考

hexo+github搭建个人博客

使用 Hexo+GitHub 搭建个人免费博客教程(小白向)