利用Github+Hexo打造永久Blog

作者：【教程】利用Github+Hexo打造自己的永久Blog – 开发调优 – LINUX DO

准备工作

GitHub账户（可能需要科学）

软件：Git、VSCode、Node.JS

注册GitHub

访问GitHub官网：(https://github.com/ 😉
点击Sign up 按钮

输入你的邮箱按照页面提示来注册

安装Git

Git 是一个开源的分布式版本控制系统，用于敏捷高效地处理任何或小或大的项目。

1.下载

官网下载页面：Git – Downloads

Win 64位的安装版本地址：https://github.com/git-for-windows/git/releases/download/v2.32.0.windows.2/Git-2.32.0.2-64-bit.exe

2.安装

双击安装包开始安装，一路点击 Next 即可，安装完成后鼠标右键会有 Git Bash Here，这是Git的命令行，说明安装成功

3.设置用户名和邮箱

因为 Git 是分布式版本控制系统，所以需要设置用户名和邮箱作为一个标识，在命令行输入如下：

git config --global user.name "user_name" # user_name 填入 GitHub 用户名
git config --global user.email "user_email" # user_email 填入 GitHub 注册的邮箱

安装 VSCode

VSCode 是一个非常好用的文本编辑器，之后编辑博客的相关配置文件以及后面的写博客都需要用到这个编辑器。

安装过程很简单，直接进入 VSCode 官网，然后安装的时候建议所有步骤都直接点下一步

安装Node.js

进入 Node 官网下载最新稳定版本，

安装直接全点下一步
安装 Node.js 会包含环境变量以及 npm 的安装，安装后，可以在命令行输入如下命令检测 Node.js 是否安装成功：

第一个命令：

node -v

这个命令，在 nodejs 安装成功的情况下会显示 nodejs 的版本号。

第二个命令：

npm -v

这个命令，在 nodejs 安装成功的情况下会显示 npm 的版本号。

换npm源

npm是node.js自带的一个工具，需要更换为国内可用的源

以使用淘宝镜像源为例

1.打开git命令行

2.命令设置

#最新地址 淘宝 NPM 镜像站喊你切换新域名啦!
npm config set registry https://registry.npmmirror.com

3.查看镜像使用状态

npm config get registr

如果返回https://registry.npmmirror.com，说明配置成功

创建仓库

点击这个

新建一个名为 username.github.io （这里的 username 要替换成自己的实际的用户名）的仓库，如下图（我这里爆红是因为我已经创建过了）

填写仓库名，格式必须为<用户名>.github.io ，然后点击Create repository 。

配置 SSH key

为什么要配置这个因为我们首先要本地架构Hexo框架

写好博客编译成html页面上传到GitHub仓库

从本地链接GitHub要使用git这个工具、

而这些操作得有账号的所有权

取得权限的方法如下

打开 Git Bash，输入命令：

ssh-keygen -t rsa -C "user.email" # user.email 为GitHub 上注册的邮箱

然后直接三个回车即可，默认不需要设置密码。查看是否已经有 ssh 密钥。打开用户主目录 C:\Users\username\.ssh ，.ssh文件夹一定存放在C:，至于后面的路径lenovo这个不一定每台电脑都相同。找到.ssh文件夹，打开如下：

然后找到生成的 .ssh 的文件夹中的 id_rsa.pub 密钥，将内容全部复制。其中 id_rsa 是私钥不能泄露，id_rsa.pub 是公钥。

打开 GitHub SSH and GPG keys 页面，新建一个 ssh key：

Title 为标题，任意填即可，将刚刚复制的 id_rsa.pub 内容粘贴进去，最后点击 Add SSH key。在 Git Bash 中检测 GitHub 公钥设置是否成功，输入如下命令：

ssh -T [email protected]

验证是否连接成功，连接成功的话，显示如下：

开始搭建

部署Hexo

Hexo 官方文档：Documentation | Hexo

Hexo 是什么

Hexo 是一个简单、快速、强大的基于 Github Pages 的博客框架，支持 Markdown 格式，有众多优秀插件和主题。

Hexo 原理

由于 Github Pages 存放的都是静态文件，博客存放的不只是文章内容，还有文章列表、分类、标签、翻页等动态内容，所以 Hexo 所做的就是将这些 md 文件都放在本地，每次写完文章后调用写好的命令来批量完成相关页面的生成，然后再将有改动的页面提交到 GitHub 。

安装与初始化

在 Git Bash 中输入以下命令：

npm install -g hexo-cli # 此命令完成对 hexo 的安装

安装完成后，在电脑的某个地方新建一个文件夹（名字可以随便取）专门用于存放博客代码，比如我的是 E:\blog\master-blog ，由于这个文件夹将来存放博客的所有内容和素材，以及所有的博客操作都会在其中完成，所以最好不要随便放。

进入新建的博客目录，点右键鼠标：

打开git命令框

输入如下命令：

hexo init # 该命令完成 hexo 在本地博客目录的初始化

生成静态文件

hexo g

执行以上命令后，Hexo 就会在 public 文件夹中生成相关的 html 文件，这些文件将来都是要提交到 GitHub 上的 username.github.io 的仓库中去的。

本地预览

在 Git Bash 输入以下命令：

hexo s

hexo s 是开启本地预览服务，打开浏览器访问 http://localhost:4000 即可看到内容，Ctrl+C 停止本地预览。本地预览可以实时查看博客的编辑情况，待博客写完后一起部署到 GitHub 上。

第一次初始化的时候 hexo 已经帮我们写了一篇名为 Hello World 的文章，默认的主题比较丑

切换模板

我推荐使用fluid

输入以下命令

 git clone https://gitclone.com/github.com/fluid-dev/hexo-theme-fluid.git themes/fluid

然后在博客目录下创建 _config.fluid.yml

将模板目录中的 _config.yml内容复制进去。

hexo 有 2 种 _config.yml 文件，一个是根目录下的全局的 _config.yml，一个是各个主体 theme 下的 _config.yml。将前者称为站点配置文件，后者称为主题配置文件 （目前新版模板配置都是根目录下的_config.fluid.yml这种文件，如果要修改模板配置，直接修改_config.fluid.yml文件中的内容）

指定模板

如下修改博客目录中的 _config.yml：

theme: fluid # 指定主题

language: zh-CN # 指定语言，会影响主题显示的语言，按需修改

博客上线

推送到GitHub

配置站点配置文件

打开根目录下站点配置文件 _config.yml，配置有关 deploy 的部分：

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: [email protected]:你的用户名/你的用户名.github.io.git
  branch: main

例如：

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: [email protected]:master08s/master08s.github.io.git
  branch: main

安装插件

在 Git Bash 中输入以下命令：

npm install hexo-deployer-git --save # 安装部署插件

如果不进行上述操作，直接使用 hexo d 部署到 GitHub，将会报错

修改配置

git config --global core.safecrlf false

参考：stackoverflow

这个必须执行不然使用推送必报错

部署到 GitHub

在 Git Bash 中输入以下命令：

hexo g && hexo d

意思就是编译并推送

部署成功后，打开对应的网址 https://username.github.io，如果出现了和本地预览一样的效果，那么，表明部署成功。

不需要自己手动开启 GitHub Pages。

其他

创建文章以及分类请看官方文档吧
【hexo文档】文档 | Hexo
【fluid模板文档】hexo.fluid-dev.com/docs/guide/

浏览量 10

发布者：木木，转载请注明出处：https://blog.mmcool.site/5701.html