本文曾遗人以谬误,在此向因阅读本文而对hexo恐惧的来访者,特别是Z君道歉。

如果想搭建hexo博客的初学者,请直接参考相关视频教程。

不要阅读文本!不要阅读文本!不要阅读文本!

本文目的:

  1. 在windows平台上搭建hexo【hei so】静态博客。
  2. 通过git在各大代码平台进行管理部署。

第一部分:安装

安装hexo框架需要两个软件:Node.jsGit,前者是hexo的依赖项,后者是为了在各个平台进行部署管理。

Git

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

Git 是 Linus Torvalds 为了帮助管理 Linux 内核开发而开发的一个开放源码的版本控制软件。

安装步骤

与平常的windows软件安装类似,不过其中有些细节要注意。
  1. 阅读说明,点击Next

阅读说明

  1. 选择安装路径,建议把一类软件装到一个路径下,这样便于管理,发现问题也很寻找。这里我装到了F:\blog目录下,

安装路径

  1. 选择安装组件(Components)。

    对于git软件而言,基本上都是在命令行里使用,不需要快捷方式,这里勾选了右键菜单、大文件支持、将.git文件与默认编辑器(后面会指定,这里只是建立了关系),.sh与命令行关联运行,在命令行里添加一个git文档。

安装组件

在类Unix系统(linux、macOS、unix)中命令行称之为bash/sh/zsh,而在Windows系统下称为cmd,或者Powershell(微软用.NET构建的跨平台开源组件)

  1. 选择开始菜单文件夹

开始菜单

  1. 选择Git的默认编辑器

    linux用的比较多了,这里我选择了简单的Vim编辑器,大家可以根据自己喜好来选,这一步也是指定了文件关联,仍然要去自己安装你喜欢的编辑器。

    对于建hexo站写博客的用户而言,.git文件一般不需要怎么编辑,这一步忽略就OK。

默认编辑器

  1. 选择默认分支

    默认的master分支就可以,不需要更改,后面配置pages时可以添加一个page的分支

默认分支

分支是git软件的一大特色,说白了就跟windows出的家庭版、教育版、企业版一样,是主线的派生,详细请见git的分支介绍文档

  1. 添加环境变量

    这一步很关键,所以配置很简单,直接Next

环境变量

  1. 选择ssh && 选择ssh库

    使用git内部自带的Openssh,还是用你自己的Openssh,如果你之前没有在设备上用过ssh,就选择默认的吧。

选择ssh && 选择ssh库

使用本地ssh库,没有的话就直接用ssh的库(开源万岁!)

ssh库

  1. git文件结束的方式(Windows风格与Unix风格)

    默认即可

结束方式

  1. git 命令行的默认打开的终端

    选第一个,因为第二个全都是在说cmd的坏话。

    默认打开的终端

  2. git 拉取[^3]的默认行为

    嗯~,二短一长选最长,就第一个了😎。

    这里是选择pull的默认行为,给了三个选项:1. 快速拉取到本地,否则决定是否合并。2.只拉取远端,覆盖本地。3. 拉去远端,有差异则不合并。

pull的默认行为

  1. 选择证书(Credential)管理器

    选择默认的开源证书管理器即可

选择证书(Credential)管理器

  1. 额外选项

    文件缓冲,符号链接,都打勾即可。

额外选项

  1. 实验特性 && 点击INSTALL

    1. 用一个不用winpty的命令行去运行python。
    2. 取代老命的新命。

    建议:稳定与易用性起见,全不选。

实验特性

安装中

完成🎉

git基本操作[1]

  1. 创建新仓库
1
2
3
# 创建新文件夹,打开,然后执行
git init
# 以创建新的 git 仓库。
  1. 克隆远程仓库
1
git clone username@host:/path/to/repository
  1. 工作流

你的本地仓库由 git 维护的三棵“树”组成。第一个是你的 工作目录,它持有实际文件;第二个是 暂存区(Index),它像个缓存区域,临时保存你的改动;最后是 HEAD,它指向你最后一次提交的结果。

git-process

  1. 添加、提交与推送
1
2
3
# 这是 git 基本工作流程的第一步:提出更改(把它们添加到暂存区),另外add . 是添加所有更改
git add <filename>
git add *
1
2
# 使用如下命令以实际提交改动:
git commit -m "代码提交信息"

经过上面两步,你的改动已经提交到了 HEAD,但是还没到你的远端仓库。执行如下命令以将这些改动提交到远端仓库:

1
git push origin master
  1. 分支

一般的git默认分支都是master,当我们想要从master上创建一个新的分支时,可以这样做:

1
2
3
4
5
6
7
8
# 创建一个名为pages的分支,并切换到这个分支
git checkout -b pages
# 切换回主分支:
git checkout master
# 删除一个名为pages的分支
git branch -d pages
# 将分支推送到远端,不推送的话就只在本地可见
git push origin pages
  1. 更新与合并

要更新你的本地仓库至最新改动,执行:

1
git pull

以在你的工作目录中 获取(fetch)合并(merge) 远端的改动。要合并其他分支到你的当前分支(例如把source分支合并到 master),执行:

1
git merge source

在这两种情况下,git 都会尝试去自动合并改动。遗憾的是,这可能并非每次都成功,并可能出现*冲突(conflicts)。 这时候就需要你修改这些文件来手动合并这些冲突(conflicts)*。改完之后,你需要执行如下命令以将它们标记为合并成功:

1
git add <filename>

在合并改动之前,你可以使用如下命令预览差异:

1
git diff <source_branch> <target_branch>

Node.js

npm 是Node.js的默认包管理器,node.js安装后自带,就跟pip之于python,apt之于debian,pacman之于arch一样。

安装步骤

  1. 下载安装文件

    进入官网,选择长期支持的稳定版本,并下载安装。

下载安装文件

可以省去这一步,下载地址:点这里

  1. 开始安装 && 阅读并同意协议

开始安装 && 阅读并同意协议

  1. 选择安装路径

    这里我在F:\blog\下创建了一个npm文件夹。

安装路径

  1. 自定义安装

默认即可,安装下来大概六十兆。

自定义安装

  1. 安装必须的库,千万别点,会装上3G的库,而且下载速度贼慢。

千万别点

预备

起飞✈

基本操作

在安装完成之后,我们先来熟悉一下nodejs的基本命令。

如果你在执行npm相关的命令时,出现提示npm命令找不到的情况,大概齐是环境变量没有设置好,这种情况会在重装Node.js到不同目录时出现。

解决方法:添加..\npm\node_modules\npm\bin到PATH变量。

首先解决下连接问题

众所周知,国内访问各种开源库速度都不快,这里提供npm的解决方法:更换淘宝源,执行命令:

1
npm config set registry https://registry.npm.taobao.org
  1. 查看版本
1
2
node -v  
npm -v
  1. npm更新、清除缓存
1
2
3
npm install -g npm
# 删除所有模块
npm cache clean
  1. npm安装、卸载、更新、搜索模块
1
2
3
4
5
6
7
8
# 安装 (加上`-g`后缀可以全局安装)
npm install <Module Name>
# 更新
npm update <Module Name>
# 卸载
npm uninstall <Module Name>
# 搜索
npm search <Module Name>

安装好一个包,会在该工程目录下生成 package.json 它用于定义包的属性,

而这个包就放在了工程目录下的 node_modules 目录下。

  1. 查看所有全局安装的模块:
1
npm list -g

hexo安装

windows命令行基础,大佬略过

  1. 进入指定目录:cd 盘符:/dir/dir
1
2
3
4
5
6
#进入F盘blog目录
cd F:\blog
#进入上级目录
cd ..
#进入初始目录
cd (直接回车)
  1. 创建文件夹:md 文件夹名
1
2
3
4
#创建一个名为sion的文件夹
md sion
# 显示文件列表
ls
  1. 删除文件:del 文件名
  2. 删除文件夹: rd 文件夹

安装hexo

打开cmd,进入博客文件目录,创建博客目录:
1
cd F:\blog && md sion && cd s

安装hexo包:

1
npm install -g hexo-cli

在博客文件夹部署hexo:

1
npx hexo init

当你看到这句提示时,恭喜你,前期的工作完成了。

1
2
3
INFO  Cloning hexo-starter https://github.com/hexojs/hexo-starter.git
INFO Install dependencies
INFO Start blogging with Hexo!

下面可以通过执行下面这个命令来预览站点

1
npx hexo s -g

一切正常的话,点击这里应该就能看到你的第一个博客页面了🎉。

1
2
3
INFO  Validating config
INFO Start processing
INFO Hexo is running at http://localhost:4000/ . Press Ctrl+C to stop.

HelloWorld

hexo博客维护基本命令

hexo new post_title=hexo n post_title:创建文章

hexo new “有空格 的 文章标题”

hexo new 没空格的文章标题

hexo deploy=hexo d:将博客部署到托管网站

适用于github等平台,国内gitee部署需要手动更新

hexo clean= hexo c :清除hexo生成的文件,亦即删除public文件夹。

有些时候这条命令并不能起作用,就会导致网上托管生成的页面与本地不一致,这时候手动删除pubic文件,再deploy即可。

hexo generate=hexo g:渲染生成网页文件。

hexo server=hexo s:开启本地服务器预览。

如果你有一台服务器,这就直接可以通过端口4000访问了。

  1. 清除、生成并部署。
1
hexo c && hexo g && hexo d
  1. 清除、生成并本地预览。
1
hexo c && hexo s -g 

配置

注:下文内容系引用内容[2]强烈建议去阅读hexo官方文档!!!

按照上面步骤,在你的博客目录下会生成如下文件:

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

_config.yml

网站的配置信息,您可以在此配置大部分的参数,比如插件配置、部署配置、站点的基本信息。

参数 描述
title 网站标题
subtitle 网站副标题
description 网站描述
keywords 网站的关键词。支持多个关键词。
author 您的名字
language 网站使用的语言。对于简体中文用户来说,使用不同的主题可能需要设置成不同的值,请参考你的主题的文档自行设置,常见的有 zh-Hanszh-CN
timezone 网站时区。Hexo 默认使用您电脑的时区。请参考 时区列表 进行设置,如 America/New_York, Japan, 和 UTC 。一般的,对于中国大陆地区可以使用 Asia/Shanghai
url 网址, 必须以 http://https:// 开头
root 网站根目录
permalink 文章的 永久链接 格式
permalink_defaults 永久链接中各部分的默认值
pretty_urls 改写 permalink 的值来美化 URL
pretty_urls.trailing_index 是否在永久链接中保留尾部的 index.html,设置为 false 时去除
pretty_urls.trailing_html 是否在永久链接中保留尾部的 .html, 设置为 false 时去除 (对尾部的 index.html无效)

其中,description主要用于SEO,告诉搜索引擎一个关于您站点的简单描述,通常建议在其中包含您网站的关键词。author参数用于主题显示文章的作者。

_config.[theme].yml

独立的主题配置文件应放置于站点根目录下,支持 ymljson 格式。需要配置站点 _config.yml 文件中的 theme 以供 Hexo 寻找 _config.[theme].yml 文件。

我们强烈建议你将所有的主题配置集中在一处。如果你不得不在多处配置你的主题,那么这些信息对你将会非常有用:Hexo 在合并主题配置时,Hexo 配置文件中的 theme_config 的优先级最高,其次是 _config.[theme].yml 文件,最后是位于主题目录下的 _config.yml 文件。

主题

无需多讲,本人感觉好看的两个主题:Next, Butterfly🦋

这里主要提几点本人在使用时的一点经验

自定义全局字体

在主题的theme\[your themes]\source\css目录下新建一个.css文件,并按照下列css规范填写字体的定义:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
@font-face {
font-family: 'XiaWuWenKai';
src: local('Source Han Serif CN'), local('Source Han Serif SC'),
url('../../../../images/aornus.github.io@1.2/css/fonts/Noto_Serif_SC/NotoSerifSC-Black.otf') format('opentype');
url('../../../../images/aornus.github.io@1.2/css/fonts/Noto_Serif_SC/NotoSerifSC-Black.woff2') format('woff2');
url('../../../../images/aornus.github.io@1.2/css/fonts/Noto_Serif_SC/NotoSerifSC-Black.woff') format('woff');
font-weight: 700;
font-style: normal;
font-display: swap;
}

body{
font-family: 'SiYuanSong', serif;
}

再将这个css文件引入主题的配置文件:

1
- <link href="/css/custom.css" type="text/css" rel="stylesheet"/>

这样以后就可以直接调用了

1
font-family: SiYuanSong

不过这样字体文件大的时候加载会有些慢,还是建议使用谷歌字体api。

第二部分:部署

这一步是静态博客的精髓,利用各大代码托管平台的pages服务,来免费部署博客,所以说,现在建站基本上就是零成本。

SSH连接

使用https虽然简单,但每次都要输密码,使用ssh可以免除git每次push时输密码的烦恼,而且更为安全。这里以gitee,github为例
  1. 先配置好git
1
2
3
git config --global user.name "aornus"
git config --global user.email 6666666@qq.com
git config --list
  1. 公私钥生成

这里生成了标识为windows@laptop(随便写也行,写你的邮箱也行)名为windows的密钥,其中后缀为pub的是公钥的内容,这一步的目的就是把公钥放到远端,然后用私钥连接。

1
2
3
cd ~/.ssh
ssh-keygen -t rsa -b 4200 -C "windows@laptop" -f windows
cat windows.pub
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# passphrase是口令,直接回车就是置空。
C:\Users\agape\.ssh> ssh-keygen -t rsa -b 4200 -C "windows@laptop" -f windows
Generating public/private rsa key pair.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in windows.
Your public key has been saved in windows.pub.
The key fingerprint is:
SHA256:Y0sC15T8Z0kPs9IP7cQQ94r8HeMhgSAcPEhUqc7HvBg windows@laptop
The key's randomart image is:
+---[RSA 4200]----+
| oo==+o ... |
| . B+ . *. . |
| . o o. + @ .|
| + o.B.*. |
| o + S +o*.+ |
| E B o .=.+|
| + o ...|
| . . |
| |
+----[SHA256]-----+

image-20220330165318787

  1. 连接代码托管平台

    1. 在头像下面点击设置,进入设置界面,再点击ssh公钥

      gitee设置 github设置

    2. 添加ssh公钥,随便起个名字,再把公钥的内容复制进去。

      gitee 添加公钥

      github 添加公钥

    3. 使用私钥连接平台

1
2
# 连接gitee
ssh -i ~/.ssh/windows -T git@gitee.com
1
2
3
C:\Users\agape\.ssh> ssh -i ~/.ssh/windows -T git@gitee.com
Warning: Permanently added the ECDSA host key for IP address '2**.*4.**.**3' to the list of known hosts.
Hi aornus! You've successfully authenticated, but GITEE.COM does not provide shell access.
1
2
# 连接 github
ssh -i ~/.ssh/windows -T git@github.com
1
2
3
C:\Users\agape\.ssh> ssh -i ~/.ssh/windows -T git@github.com
Warning: Permanently added the ECDSA host key for IP address '2**.*4.**.**3' to the list of known hosts.
Hi aornus! You've successfully authenticated, but GitHub does not provide shell access.
  1. ssh连接成功后,在.ssh 下创建config,内容如下:
1
2
3
4
5
6
7
8
9
10
11
Host github.com
HostName github.com
User aornus(填你的github用户名)
IdentityFile ~/.ssh/windows
IdentitiesOnly yes

Host gitee.com
HostName gitee.com
User aornus(填你的gite用户名)
IdentityFile ~/.ssh/windows
IdentitiesOnly yes

同步·gitee

gitee国内速度很快,但内容会被审核,更新不方便

建立仓库

gitee建立仓库

gitee仓库设置

建站的话这里要填写你的用户名字,我已经有了一个了,所以会提示错误,因为gitee现在不支持自定义域名,填别的不能部署。

克隆到本地

复制仓库的ssh地址

1
git clone git@gitee.com:aornus/aornus.git

然后把刚才的hexo博客文件,全部复制到这个目录下。以后就在这个目录里进行修改,编辑了。推荐用VScode作为编辑器,直接可以打开终端。

VScode

推送到远端并部署

在你已经写作、修改完成所有文件后,就可以准备发布了

1
git add . ; git commit -m "hello" ; git push

推送到仓库里面后,开启paes服务

要实名认证,审核一般一个星期左右,文章内容会被审查,

gitee pages

开启之后,每次修改完要到网页上进行手动更新(gitee自动部署的方法自行谷歌,利用github action的方法比较可行)

gitee部署

同步·github

github国内速度比较慢,但内容会不会被审核,更新方便。

建立仓库

仓库名要写成用户名.github.io

gitub建立仓库

克隆到本地

github clone

然后把刚才的hexo博客文件,全部复制到这个目录下

1
git add . ; git commit -m "hello" ; git push

然后再新建一个pages分支(用master分支放源文件,pages分支部署)

1
2
3
4
5
6
# 创建一个名为pages的分支,并切换到这个分支
git checkout -b pages
# 将分支推送到远端,里面的文件是master的复制
git push origin pages
# 切换回主分支:
git checkout master

hexo一键部署

  1. 安装 hexo-deployer-git
1
$ npm install hexo-deployer-git --save
  1. 修改配置。
1
2
3
4
5
deploy:
type: git
repo: https://github.io/aornus/aornus.github.io
branch: pages
message: from hexo deploy(随便写)
参数 描述 默认
repo 库(Repository)地址
branch 分支名称 gh-pages (GitHub) coding-pages (Coding.net) master (others)
message 自定义提交信息 Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }})
token Optional token value to authenticate with the repo. Prefix with $ to read token from environment variable

生成站点文件并推送至远程库:

1
hexo clean && hexo deploy

githubpages部署

上面步骤作为完后,再仓库设置中将默认分支设置为_config.yml配置中的分支名称。稍等片刻,然后站点就会显示在您的Github Pages中。

image-20220330174355441

因为我之前不会弄双分支,所有这里是用的master分支,另外github可以自定义域名,这个域名是我买的。

如果你按部就班的做,这里应该这样填:部署到pages分支,域名是:用户名.github.io

.nojekyll问题

可能你不会遇到这个问题,但我在后来换到windows上后,恢复时死活不能部署。看了action的记录才发现:这个问题是因为github的pages服务默认是选用jekyll作为框架的,用jekyll肯定不能编译hexo博客了,官方提供了一种方法来解决:在博客目录里添加一个.nojekyll文件。

先在source下创建这个空文件(没有内容),然后在_config.yml里的Include / Exclude file(s)选项下添加这个文件:

1
2
3
4
5
6
7
# Include / Exclude file(s)
# include:/exclude: options only apply to the 'source/' folder
include:
- .nojekyll
exclude:
ignore:

然后再在deploy的设置里添加一个识别隐蔽文件的选项: ignore_hidden: false

1
2
3
4
5
deploy:
type: git
repo: https://github.com/aornus/aornus.github.io.git
branch: master
ignore_hidden: false

最后hexo三连,就可以愉快的部署了😊。

快速恢复部署

如果你转移了设备,或者不小心删除了文件。恢复部署似乎很麻烦,这篇文章🌪️将主要的命令与步骤总结,可以大大节省你的时间。

小技巧

全局图片尺寸修改

在写博客的时候,图片有时大有时小,很不统一,特别是图片比较大的时候,放在文章里,排版很难看。经过咱家一番试验,发现图片大小设置为宽度的一半是很合适的,看起来也很舒服(只要图片不是太长),那么如何修改呢,有以下几个步骤:

  1. 用开发者模式找到图片的html标签,新建一个mod.css文件来修改之。比如这博客主题中图片所在的标签是#article-container img ,那么就可以这样修改:
1
2
3
#article-container img {
width: 50%;
}
  1. 修改后,文章中的图片大概就都可以了,但可能会出现部分插件中的css受其影响变得很难看,于是我们可以再把插件中图片的html标签找出来进行修补。然而上一个对img修改是全局性的,优先级最高,二次修补可能不起作用,这时我们便可利用css中的!important语法来提高二次修改的优先级。比如咱家嘟文页面中的头像在修改后窄了一半,二次修补也无济于事,便可用这个方法来强制提高其优先级:
1
2
3
.mt-toot-avatar-image-big img {
width: 100% !important;
}

windows开机自启动

每次写个博客都要输一次命令,不胜其扰,最近摸索出来了一个简单的开机启动脚本,可以在windows11下自动运行,并最小化。

  1. 创建一个hexo.ps1文件,编码为ANSI内容为:
1
cd "F:\博客\source"; hexo s -g
  1. 创建一个名为hexoboot.bat的脚本文件,编码为UTF-8内容为:
1
PowerShell "C:\hexo.ps1"
  1. 生成hexoboot.bat的快捷方式,放到启动文件夹里面

推送服务

简单浏览器更新推送的实现 | CC的部落格 (ccknbc.cc)

出现unknow tag怎末办?

unknown block tag: ... 这个问题出现几率极低,原因是hexo找不到主题,进而找不到主题的内置标签,可能的原因就是配置文件中的主题名称写错了,或者主题目录名写错,或者主题就不存在。有了主题,内置标签一般是不会出现找不到的情况的。


  1. Git-简明教程 ↩︎

  2. hexo官方建站指南 ↩︎