0.前言

Hexo 是一个快速、简洁且高效的博客框架。 Hexo 使用 Markdown（或其他标记语言）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

1.安装Git和Node.js

Git:https://git-scm.com/downloads

Node.js:https://nodejs.org

温馨提示，安装路径最好不要有中文，以防出现什么莫名其妙的问题

2.安装hexo

新建一个文件夹，作为博客目录，在该目录中以 Git bash 打开

在开始安装之前，我推荐npm换源一下，官方源下载有些依赖包异常的慢

在 Git bash 中输入 npm config get registry 显示的应该是官方源 https://registry.npmjs.org/

这里改用淘宝源 npm config set registry=https://registry.npmmirror.com 再次输入npm config get registry查看是否更换成功

安装hexo 在Git bash 中接着输入 npm install -g hexo-cli 等待安装完成

接着输入 git init blog 在出现的blog文件夹中重新打开 git bash

3.挑选喜欢的主题

在hexo挑选一个你喜欢的主题

上分的图片是预览，标题蓝色链接是Github项目页

最好选择作者还在维护的主题，以防又会出现什么莫名奇妙的问题

选择好主题之后，复制主题Github项目链接

在Git Bash 中继续输入

1
2
cd themes    
git clone "link".git "theme"

我这里拿东方的一个主题举例，那我就应该输入

1
2
cd themes
git clone https://github.com/D-Sketon/hexo-theme-reimu.git reimu

如果提示

fatal:unable to access ’https://… 请打开你的梯子

4.配置文件

打开blog根目录下的**_config.yml **文件

按 ctrl+F 查找theme

在 **theme ** 后改为你主题的名字

让后输入

1
2
3
hexo cl
hexo g
hexo s

在输出的 http://localhost:4000/ 复制，在浏览器中打开，查看是否成功替换主题

具体主题设置在对应Github项目页下方都会有介绍和说明，根据作者的说明进行自定义配置（当然不防有懒的作者不写清除就需要你自行摸索了）

一些通用配置说明

1
2
3
4
5
6
7
8
# Site
title: Hexo
subtitle: ''
description: ''
keywords:
author: John Doe
language: en
timezone: ''
配置名 说明
title 你的网页标签页标题
subtitle 网页内标题
description 下方的小标题
keywords 搜索你网站的关键词
author 作者…
language 语言 建议改成 zh-CN
timezone 时区 建议改成 Aisa/shanghai

剩余主题内的_config.yml配置请参考你主题作者的说明

5.本地部署查看

参考我hexo常用命令一期，本地部署，查看配置情况，检查无误可考虑部署到远端

6.配置SSH密钥

你需要有一个Github账号

注册完成后，在个人主页Repositories中，点击New新建仓库

Repository name为<user>.github.io

user为你注册Github的账户名

让后点击Create repositpory完成创建

让后回到Git bash输入（自行改成你注册的邮箱

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

让后它会让你输入一些东西，不用管，一路回车即可

让后将 SSH 密钥添加到 ssh-agent，输入

1
2
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

让后输入

1
2
cd ~/.shh
cat id_ed25519.pub

将密钥复制下来备用

接着打开你 GitHub 右上角的头像中的 Settings 设置，点击左边的 SSH and GPG keys，点击右上角的 New SSH key，将 SSH 密钥复制到 Key 中，Title 不用写，点击 Add SSH key 添加密钥。

让后重新打开Git bash 输入

1
ssh -T git@github.com

如果出现 You've successfully authenticated 则配置成功。

7.部署到Github Pages

打开Git Bash

设置Git用户名和邮箱

1
2
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

检查你是否输入正确的用户名和邮箱

1
2
git config --global user.name
git config --global user.email

打开你博客根目录的 _config.yml，设置参数。

1
url:http://.github.io

和

1
2
3
4
deploy:
  type: 'git'
  repo: https://github.com/<user>/<user>.github.io
  branch:main

两处，找不到就Ctrl+F寻找

设置好参数，使用下面的命令安装部署插件，安装了才能部署到 GitHub Pages。

1
npm add hexo-deployer-git

让后输入hexo cl && hexo g && hexo d部署到Github Pages

如果提示

fatal:unable to access ’https://… 请打开你的梯子

8.欣赏你的blog

输入网址https://<user>.github.io/即可访问你的blog

如若中途出现问题，随时可issues或在下方disscussions中留言

backtop