白乐天

道阻且长,行则将至。

hexo+github从0到1博客环境搭建

环境准备

  • 操作系统:Windows
  • VSCode(进行文本编辑)
  • Node.js
  • Git
  • Github账号和github仓库(部署到github)
  • Hexo(博客框架)

安装VSCode

无脑下载安装

安装Node.js

Node.js
无脑下载安装
打开终端,输入node -v,可以看到版本信息,则安装成功。

安装Git

Git
无脑下载安装

Git配置

常用命令

1
2
3
4
5
git config -l  //查看所有配置

git config --system --list //查看系统配置

git config --global --list //查看用户(全局)配置

配置用户名和邮箱

1
2
3
4
5
git config --global user.name "你的用户名"

git config --global user.email "你的邮箱"

输入后没有报错代表设置成功

通过git config -l检查配置是否成功

git配置完成。

创建Github仓库

先创建一个自己的Github账号。
然后去创建仓库
仓库名的格式必须为:<用户名>.github.io
Destricption:为仓库描述
勾选:Initialize this respository with:Add a README file初始化一个README.md文件
点击Creat repository 进行创建

连接Github

生成ssh公钥
打开终端,执行如下命令,如果提示输入一直回车就好

1
ssh-keygen -t rsa -C "你的邮箱"

然后找到在c盘用户文件夹下的.ssh文件夹,会看到id_rsa.pub,这是公钥

用记事本打开id_rsa.pub,复制里面的内容,然后在GitHub中配置ssh密钥

进入GitHub,右上角点击头像选择settings
进入设置页选择SSH and GPG keys
然后点 New SSH key
title可以随便可以取,把key粘过去

然后点Add SSH KEY

测试连接

1
ssh -T git@github.com


可以正常连接!

安装Hexo

自己选定一个目录,新建一个文件夹,可以命名MyBlog(自己起个名字,后面的博客项目都在这个文件夹里了)
从MyBlog目录下打开终端,执行如下命令,安装hexo

npm换源
npm 官方注册表在国内访问可能受限,会导致下载速度很慢。
如果接下来的npm命令报错,可以改为国内镜像源,也可以使用cnmp来代替nmp
cnpm 是淘宝镜像的命令行工具,速度比默认的 npm 快
npm install -g cnpm –registry=https://registry.npmmirror.com

安装hexo

1
npm install -g hexo-cli

安装完成,输入hexo -v验证是否安装成功。

初始化Hexo项目

从MyBlog目录下打开终端,执行hexo init命令初始化项目

1
hexo init


在文件夹中可以看到有了这些文件

继续执行npm i ,安装依赖

1
npm i

打开终端,在终端输入hexo sever或者hexo s

Ctrl键+鼠标左键单击网址,打开链接

这就成功在本地部署了

将静态博客部署到GitHub Pages

安装npm install hexo-deployer-git --save

修改_config.yml文件
将博客目录下的_config.yml,也就是整个Hexo框架的配置文件了,可以在里面修改大部分配置。
修改最后一行的配置,将repository修改为自己的github项目地址。
项目地址可以到github仓库复制过来。

设置分支为:main

1
2
3
4
deploy:
type: git
repository: git@github.com:Bileton/Bileton.github.io.git
branch: main

使用指南

新建文章

执行命令

1
hexo new "文章标题"

就会创建一个md文件,就可以在vscode里面写文章了。
Ctrl+k + (大写锁定下的)V,可以打开侧边预览实时看到预览效果。

本地预览

在终端输入hexo sever或者hexo s
输出信息会包含一个链接,打开链接即可在浏览器预览效果。

部署项目到github

在终端执行如下命令

1
2
3
hexo cl
hexo g
hexo d

hexo clean:删除之前生成的文件,若未生成过静态文件,可忽略此命令,可用hexo cl。
hexo generate:生成静态文章,可以用hexo g缩写
hexo deploy:部署文章,可以用hexo d缩写
出现 Deploy done,则说明部署成功。
打开浏览器访问:https://Bileton.github.io,就可以看到博客内容了。

部署命令简洁版

1
hexo cl && hexo g -d

配置文件修改

在博客目录下的_config.yml文件里,可以进行修改

站点信息

1
2
3
4
5
6
7
8
# Site
title: '' # 标题
subtitle: '' # 副标题
description: '' # 描述
keywords:
author: '' # 作者
language: zh-CN # 语言
timezone: ''

托管Cloudflare加速访问

进入Cloudflare官网注册账号

进入Workers 和 Pages新建一个Pages

点击Connect to Git

点击Begin setup

点击Save and Deploy进行部署

部署成功可查看子域名

可通过bileton-github-io.pages.dev进行访问。