Hexo搭建教程?看这一篇就够了- How to系列

这篇具有很好参考价值的文章主要介绍了Hexo搭建教程?看这一篇就够了- How to系列。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

目录

读者先看这里​​​​​

Bayi使用的软件版本:

更新记录

2023年7月30日

Hexo是什么

在此之前

Node.js

许可协议

选择安装地址

选择安装组件

安装

检查安装

更改全局模块所在路径和缓存路径地址

Git

下载并打开Git安装包

选择安装路径

选择安装组件

选择开始菜单文件夹名称

选择 Git 默认编辑器

决定初始化新项目(仓库)的主干名字

Path调整

选择HTTPS传输

配置行尾符号转换

配置终端模拟器以与 Git Bash 一起使用

选择默认的 “git pull” 行为

选择一个凭证帮助程序

配置额外的选项

配置实验性选项

GitHub

安装Hexo

初始化项目

创建项目

安装依赖

更改.gitignore文件

创建静态文件

个性化

更改根目录的_config.yml文件

更改主题

配置主题

评论插件

关于页

关于Valine你要知道的事

发送请求中响应内容明文暴露

LeanCloud国际版评论

Admin界面

安装插件

 进入Admin页面

设置Admin账户信息

文章(Post),页面(Page)和草稿(Draft)

文章(Post)

新建文章

Front-matter 

MarkDown

页面(Page)

新建页面

Front-matter

草稿(Draft)

创建草稿

正式发布博文

布局(LayOut)

GitHub Pages

创建GitHub Pages存储库

安装deploy插件

推送项目

查看效果

问题解答

特别感谢

结语

How to

参考,引用文献,书籍

参考,引用文献

参考,引用书籍


读者先看这里​​​​​

这篇文章是给Windows用户的,macOS也可以看哦,我就是三种系统都用滴,基本都没有问题

文章非常长,建议先收藏等到有一整天空隙时间的时候再看,非常非常长,结合实践可能要好几个小时

恭喜你,发现了宝藏,一定要坚持读完这一万多字,可能会有进阶的教程比我讲的更高级,但一定没有一个入门教程可以替代这篇文章


Bayi使用的软件版本:

OS:Windows11 22H2

Node.js:18.13.0 64-bit for windows

Git:2.39.1 for Windows x64

hexo-cli: 4.3.0

Visual Studio Code:1.74.3 for Windows8,10,11 x64


更新记录

2023年7月30日

  1. 更新标题从“Hexo——看着一篇就够了”更改为“Hexo搭建教程?看这一篇就够了- How to系列”
  2. 更新收入How to精选教程专栏系列
  3. 添加“更新记录”板块
  4. 更新对2-3-2,2-3-3,2-3-4,9-1-2图进行文字解释,并对大佬HMM_6指出图片问题表示感谢
  5. 增加“问题解答”板块
  6. 增加“特别感谢”板块
  7. 更新“结语”字数与标题统计部分
  8. 更新目录
  9. 更新并独立“读者先看这里”板块

2023年8月4日

  1. 标题从“Hexo搭建教程?看这一篇就够了- How to系列”更改为“Hexo教程,看这一篇就够了- How to系列”
  2. 更新“2023年7月30日”更新记录,使其更加规范
  3. 更新“特别感谢”模块
  4. 更新“读者先看这里”
  5. 更新“结语”统计字数与标题统计部分,将不规范“大项”更改为更加统一的“父项”
  6. 更新目录

Hexo是什么

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页

——Hexo官网

Hexo可以简单快速的搭建你的个人Blog并部署到你的域名或折到Github Pages当然,也可以是Gitlab Pages

具体可以参照Hexo官网


Gitlab Pages

在此之前

Node.js

Hexo是基于Node.js构建的,所以我们需要下载TA

中文官网:去下载

P.S.:这里建议大家下载长期维护版,相比于最新尝鲜版,长期维护版会更加稳定

在整个项目中,Bayi的Node.js版本使用的是18.13.0,如果你的Node.js版本比Bayi的版本低或高,也许但未必出现不兼容,报错的情况

在你的Windows没有Node.js的情况下打开后缀名为.msi的Windows Installer程序包,你会看到下图的界面

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-1

许可协议

点击Next,将看到2-1-2图的界面

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-2

选择安装地址

按照2-1-2图的提示操作后,点击Next,选择安装地址,默认在“ C:\Program Files\nodejs\ ”建议改到其他盘符,如Bayi的D盘专门用来装软件,所以Bayi的安装地址为“ D:\nodejs\ ”,见2-1-3图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-3

选择安装组件

点击Next,见2-1-4图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-4

 全部选择后点击Next,见2-1-5图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-5

安装

点击Next后,见2-1-6图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-6

 等待安装完成后点击“ Finish ”,见2-1-7图和2-1-8图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-7
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-8

检查安装

安装完成后打开Powershell,见2-1-9图和2-1-10图

P.S.:Win+R打开运行

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-9
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-10

更改全局模块所在路径和缓存路径地址

如果你的运行效果和Bayi一样,请继续往下看

下面,我们把全局模块所在路径缓存路径放在自己的Node.js安装的文件夹中

在安装目录下新建【node_global】【node_cache】文件夹,见2-1-11图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-11

 在刚才的Powershell中输入这两个命令,具体见2-1-12图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-12

搜索系统环境变量并打开“ 编辑系统环境变量 ”,选择“ 环境变量 ”即可见到2-1-13图的窗口

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-13

 新建用户环境变量,变量名命名为“ NODE_PATH ”,变量值为你的Node.js的安装路径,见2-1-14

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-14

之后点击确定,在系统变量中找到“ Path ”,添加Nodejs全局文件夹,也就是刚才新建的 “ node_global ”文件夹的绝对路径,见2-1-15图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-1-15

 之后依次点击确定即可


Git

如果你要将你的项目推送到Github Pages或者Gitlab Pages,你会需要它,本文将以GitHub Pages作为示例,当然,如果你要使用自己的域名,也可能需要Git

Git下载:去下载

这里Bayi用的是2.39.1 64-bit for Windows版本,且之后都会使用这个版本的Git,与Node.js一样,如果你的Git版本比Bayi的版本低或高,也许但未必出现不兼容,报错的情况

下载并打开Git安装包

之后点击Next,见2-2-1图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-1

选择安装路径

点击Next后,请按2-2-2图操作

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-2

选择安装组件

下一步的界面Bayi给大家翻译出来了,见2-2-3图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-3

 下面是Bayi的选择,可供参考,见2-2-4图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-4

 P.S.:最后一个选项打勾的话,需要下载 Windows Terminal 配合 Git Bash使用,Windows11 22H2自带Windows Terminal,效果如2-2-20图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-21

P.S.:这张原本应该是2-2-5,Bayi当时没注意,按最后图号顺延,这张图号应是2-2-21

选择开始菜单文件夹名称

点击Next后进入开始菜单文件夹选择,见2-2-5图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-5

选择 Git 默认编辑器

点击Next后,Git 安装程序里面内置了 10 种编辑器供你挑选,比如 Atom、Notepad、Notepad++、Sublime Text、Visual Studio Code、Vim 等等,默认的是 Vim ,选择 Vim 后可以直接进行到下一步,但是 Vim 是纯命令行,操作有点难度,需要学习。如果选其他编辑器,则还需要去其官网安装后才能进行下一步,这里Bayi使用了默认Vim,见2-2-6图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-6

 点击Next

决定初始化新项目(仓库)的主干名字

注: 第二个选项下面有个 NEW! ,说很多团队已经重命名他们的默认主干名为 main . 这是因为2020 年非裔男子乔治·弗洛伊德因白人警察暴力执法惨死而掀起的 Black Lives Matter(黑人的命也是命)运动,很多人认为 master 不尊重黑人,呼吁改为 main

这里,Bayi选择的是main,见2-2-7图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-7

点击Next

Path调整

见2-2-8图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-8

2-2-8图翻译为:

仅从 Git Bash 使用 Git
这是最谨慎的选择,因为您的 PATH 根本不会被修改。您将只能使用 Git Bash 中的 Git 命令行工具。

从命令行以及第三方软件进行 Git
(推荐)此选项仅将一些最小的 Git 包装器添加到PATH中,以避免使用可选的 Unix 工具使环境混乱。
您将能够使用 Git Bash 中的 Git,命令提示符和 Windov PowerShell 以及在 PATH 中寻找 Git 的任何第三方软件。

使用命令提示符中的 Git 和可选的 Unix 工具
Git 和可选的 Unix 工具都将添加到您的 PATH 中。
警告:这将覆盖 Windows 工具,例如 "find" and "sort". 仅在了解其含义后使用此选项。

在这里,默认即可

选择 SSH 执行文件,见2-2-9图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-9

2-2-9图翻译如下

Use bundled OpenSSH 
This uses ssh. exe that comes with Git.
使用捆绑的 OpenSSH
这使用的 ssh.exe 是 Git 自带的 

使用外部 OpenSSH
新!这使用外部 ssh.exe 文件。 
Git 不会安装自己的 OpenSSH(和相关)二进制文件,而是使用在环境变量 PATH 中找到的它们。

这里默认即可

点击Next

选择HTTPS传输

见2-2-10图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-10

翻译如下:

使用 OpenSSL 库
服务器证书将使用 ca-bundle.crt 文件进行验证。

使用本机 Windows 安全通道库
服务器证书将使用 Windows 证书存储进行验证。
此选项还允许您使用公司内部分发的内部根 CA 证书,例如通过 Active Directory 域服务。

这两种选项有什么区别呢?

如果在具有企业管理证书的组织中使用 Git,则将需要使用安全通道。如果你仅使用 Git 来访问公共存储库(例如 GitHub ),或者你的组织不管理自己的证书,那么使用 SSL 后端(它们只是同一协议的不同实现)就可以了。

——Stack Overflow

也就是说,作为普通用户,只是用 Git 来访问 Github、GitLab 等网站,选择前者即可,点击Next,进入下一步

配置行尾符号转换

见2-2-11图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-11

2-2-11图翻译如下

签出 Windows 样式,提交 Unix 样式的行结尾
Git 签出文本文件时,会将 LF 转换为 CRLF。
提交文本文件时,CRLF 将转换为 LF。
对于跨平台项目,这是 Windows 上的建议设置("core.autocrif" 设置为 "true")。

按原样签出,提交 Unix 样式的行结尾
Git 在签出文本文件时不会执行任何转换。提交文本文件时,CRLF 将转换为 LF。
对于跨平台项目,这是在 Unix 上的建议设置("core.autocrif" 设置为 "input")。

按原样签出,按原样提交
Git 在签出或提交文本文件时不会执行任何转换。
不建议跨平台项目选择此选项("core.autocrif" 设置为 "false")。

他们之间的区别我们引用一下阮一峰老师的Blog,原文:回车和换行 - 阮一峰的网络日志 (ruanyifeng.com)

Unix系统里,每行结尾只有"<换行>",即"\n";Windows系统里面,每行结尾是"<回车><换行>",即"\r\n";Mac系统里,每行结尾是"<回车>"。一个直接后果是,Unix/Mac系统下的文件在Windows里打开的话,所有文字会变成一行;而Windows里的文件在Unix/Mac下打开的话,在每行的结尾可能会多出一个^M符号。 

而Bayi这里的项目是要提交的Github Pages上的,下面是引用 《GitHub入门与实践》 第 50 页内容:

GitHub 中公开的代码大部分都是以 Mac 或 Linux 中的 LF(Line Feed)换行。然而,由于 Windows 中是以 CRLF(Carriage Return+ Line Feed)换行的,所以在非对应的编辑器中将不能正常显示。
 
Git 可以通过设置自动转换这些换行符。使用 Windows 环境的各位,请选择推荐的 “Checkout Windows-style,commit Unix-style line endings” 选项。换行符在签出时会自动转换为 CRLF,在提交时则会自动转换为 LF .

所以这里我们选择第一项,点击Next

配置终端模拟器以与 Git Bash 一起使用

见2-2-12图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-12

 2-2-12图翻译如下

使用 MinTTY(MSYS2的默认终端)
Git Bash 将使用 MinTTY 作为终端仿真器,该仿真器具有可调整大小的窗口非矩形选择和 Unicode 字体。
Windows 控制台程序(例如交互式 Python)必须通过 "winpty" 启动才能在 MinTTY 中运行。

使用 Windows 的默认控制台窗口
Git 将使用 Windows 的默认控制台窗口("cmd.exe"),该窗口可与 Win32 控制台程序(例如交互式Python 或 
node.js)一起使用,但默认回滚非常有限,需要将其配置为使用 Unicode 字体才能正确显示非 ASCII 字符,并且在 
Windows 10 之前,其窗口不可随意调整大小,并且仅允许选择矩形文本。

建议选择第一种,MinTTY 3功能比 cmd 多,cmd 只不过 比 MinTTY 更适合处理 Windows 的一些接口问题,这个对 Git 用处不大,除此之外 Windows 的默认控制台窗口(cmd)有很多劣势,比如 cmd 具有非常有限的默认历史记录回滚堆栈和糟糕的字体编码等等。
相比之下,MinTTY 具有可调整大小的窗口和其他有用的可配置选项,可以通过右键单击的工具栏来打开它们 git-bash 。

选择之后点击Next

选择默认的 “git pull” 行为
 

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-13

2-2-13翻译如下

默认(快进或合并)
这是 "git pull" 的标准行为:在可能的情况下将 当前分支 快进到 获取的分支,否则创建合并提交。

变基将当前分支变基到获取的分支上。如果没有本地提交要变基,则等同于快进。

只能快进快进到获取的分支。如果不可能,则失败。

Git安装程序给了三个 “git pull” 的行为:
第一个是 merge
第二个是 rebase
第三个是 直接获取

第一种 git pull = git fetch + git merge
第二种 git pull = git fetch + git rebase
第三种 git pull = git fetch

一般默认选择第一项," git rebase "绝大部分程序员都用不好或者不懂,而且风险很大,但是很多会用的人也很推崇,Bayi认为“ git rebase ”挺好用,但是用不好就是灾难。

git pull 只是拉取远程分支并与本地分支合并,而 git fetch 只是拉取远程分支,怎么合并,选择 merge 还是 rebase ,可以再做选择。

在这里给大家一张图,见2-2-14图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-14

选择一个凭证帮助程序

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-15

图2-2-15翻译如下

Git 凭证管理
使用跨平台的 Git  凭证管理。
在此处查看有关 Git 凭证管理未来的更多信息。

不使用凭证助手。

一共两个选项:

  • Git凭证管理
  • 不适用使用凭证助手

第一个选项是提供登陆凭证帮助的,Git 有时需要用户的凭据才能执行操作;例如,可能需要输入用户名和密码才能通过 HTTP 访问远程存储库(GitHub,GItLab 等等)

点击Next

配置额外的选项

见图2-2-16

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-16

 2-2-16图翻译如下

启用文件系统缓存
将批量读取文件系统数据并将其缓存在内存中以进行某些操作("core.fscache” 设置为 "true")。
这可以显着提高性能。

启用符号链接
启用符号链接(需要SeCreateSymbolicLink权限)。
请注意,现有存储库不受此设置的影响。

启用文件系统缓存就是将批量读取文件系统数据并将其缓存在内存中以进行某些操作,可以显著提升性能。这个选项默认开启。
启用符号链接 ,符号链接是一类特殊的文件, 其包含有一条以绝对路径或者相对路径的形式指向其它文件或者目录的引用,类似于 Windows 的快捷方式,不完全等同 类Unix(如 Linux) 下的 符号链接。因为该功能的支持需要一些条件,所以默认不开启。

点击Next

配置实验性选项

见2-2-17图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-17

启用对伪控制台的实验性支持。
(新功能!) 这允许在不使用 winpty 的情况下在 Git Bash 窗口中运行诸如 Node 或 Python 之类的本机控制台程序,
但是它仍然存在已知的 bug。

启用实验性内置文件系统监视器
(新!)自动运行内置文件系统监视器,以加快包含许多文件的工作树中的常见操作,例如 'git status'、'git add'、'git commit' 等.

这都是Git的实验性功能,为了稳定性,没必要开启

点击Install开始安装,见2-2-18图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-18

 安装完成,见2-2-19图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-19

打开终端,配置你的名称和邮箱,见2-2-20图

git config --global user.name "你的git用户名"
git config --global user.email "你的git登录邮箱"
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-2-20

GitHub

Github相信大家并不陌生,如果大家没听说过也没注册过,可以见这两篇文章

 Github的注册:❤️github注册教程最新版(✨图文并茂最新版保姆级教程:建议收藏💘) - 墨抒颖 - 博客园 (cnblogs.com)

Github的简介:Github_百度百科 (baidu.com) 

生成和添加SSH,见2-3-1图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-3-1

将你的公钥添加到GitHub中,见2-3-2,2-3-3,2-3-4,2-3-5,2-3-6图

2-3-2

2-3-2和下面几张图不知为啥违规了,文字解释一下(感谢HMM_6大佬的指出):点击头像

2-3-3

选择Settings 

2-3-4

 选择SSH and GPG keys

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-3-5
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
2-3-6

至此,所有的准备工作已经完成了!!!


安装Hexo

前面絮絮叨叨给大家写了五千六百字的准备工作,从这里开始,我们开始讲重点了!

还是原来那个Powershell,输入下面的命令:

npm install -g hexo-cli

如果你是严格按照上面的教程做的,你会看到3-2-1图的输出

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
3-2-1

验证安装,执行下面命令:

hexo -v

可以看到3-2-2图输出:

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
3-2-2

初始化项目

创建项目

cd到你要创建项目文件夹的目录,输入以下命令

hexo init blog

P.S.:“ blog ”是文件夹名,可以更改为你想要的,hexo会在里面创建项目

当然也可以cd到你先创建项目的文件夹,输入:

hexo init

见4-1-1图 

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
4-1-1

上面的命令就新建了文件夹【blog】见4-1-2图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
4-1-2

里面有项目文件,见4-1-3图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
4-1-3

安装依赖

上面执行完后cd到刚才新建的目录安装依赖,命令

npm install

如果无误,即可得到4-1-4图的输出

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
4-1-4

更改.gitignore文件

 P.S.:在这篇Blog中,Bayi用的是文本编译器是Visual Studio Code,已下简称VSCode,记得一定要用管理员权限,不然npm用不了

打开VSCode(管理员),保存工作区,Bayi习惯在项目根目录下保存,记得在.gitignore里加入:

*.code-workspace

 如果你和Bayi一样,安装了Local History插件,在保存工作区的时候应该多了.history文件夹,记得要在.gitignore文件添加下面一行

.history

这是我的.gitignore文件,见4-1-5图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
4-1-5
.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
_multiconfig.yml
*.code-workspace
.history

创建静态文件

在VSCode打开终端,创建静态文件,见4-1-6图

hexo g
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
4-1-6

启动服务器

然后启动服务器,见 4-1-7图

hexo s
hexo server

上面两个都可以

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
4-1-7

 然后打开浏览器,访问localhost:4000,你会看到4-1-8图的界面

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
4-1-8

 CTRL+C停止服务器,让我们给我们的Blog个性化一些


个性化

更改根目录的_config.yml文件

翻译见5-1-1图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-1-1

 我的更改如下,见5-1-2图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-1-2

 然后执行如下命令(记得关闭服务器):

清理静态文件:

hexo clean

重新生成静态文件:

hexo g

启动服务器

hexo s

P.S.:以上简称重启Hexo

见5-1-3图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-1-3

更改主题

配置主题

可这个主题(你见到的用户界面)未免一点丑,在官网上有很多主题,去看看

这里,我们以Fluild主题为例

GitHub仓库        配置指南

官网        图标        文档

在项目根文件夹中的themes打开刚才安装好的Git,克隆主题,见5-1-4图

git clone git@github.com:fluid-dev/hexo-theme-fluid.git
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-1-4

 见5-1-5图,5-1-6图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-1-5
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-1-6

 克隆后将文件夹重命名为fluid并在根目录_config.yml文件更改主题名,见5-1-7图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-1-7

 重启Hexo,见5-1-8图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-1-8

 主题的配置文件(在/thems/fluid/_config.yml)的注释已经写的很清楚了,Bayi在这里简单唠叨一下

评论插件

这里以valine为例

注册LeanCloud国际版账号,中国版也可以,不过要实名,进入官网,见5-2-1图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-1

点击页面上方Console,进入登陆页面,见5-2-2和5-2-3图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-2
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-3

 注册完成后记得验证邮箱,见5-2-4,5-2-5,5-2-6图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-4
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-5
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-6

 验证后创建应用,见5-2-7,5-2-8图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-7
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-8

 点击创建后,进入应用,见5-6-7,5-6-8,5-6-9图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-7
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-8
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-9

 重启Hexo即可,见5-6-10图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-2-10

 搞定!

关于页

创建关于页,见5-3-1和5-3-2图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-3-1
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-3-2

更改about页面的信息

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-3-3

编辑关于页的Front-matter

Front-matter 是文件最上方以 --- 分隔的区域,用于指定个别文件的变量,见5-3-3图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-3-4

 重启Hexo,看看效果,见5-3-5图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
5-3-5

关于Valine你要知道的事

如果你和Bayi一样,使用valine做评论系统,那么你需要认真阅读下面的文段

发送请求中响应内容明文暴露

请求的返回内容包括评论者IP、邮箱等隐私数据,一览无余。

——Github Issues 

​​​​​​链接

鉴于这个,还有LeanCloud国际版需要翻墙发评论,Bayi正在考虑引进Twikoo评论系统,之后如果Bayi研究明白了会更新的

LeanCloud国际版评论

见Bayi自己提的Issues,我在GitHub详细写出了我遇到的问题(那次是Bayi第一次用Hexo搭Blog)

在这里,再次感谢大佬ads38,Bayi的Issues就是这位大佬解答的


Admin界面

为了让我们管理我们的Hexo更方便,让我们为我们的Hexo添加一个管理员界面

安装插件

安装插件hexo-admin,见图7-1-1

npm install --save hexo-admin
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
7-1-1

 进入Admin页面

重启Hexo,打开localhost:4000/admin,见7-1-2图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
7-1-2

设置Admin账户信息

 打开Settings,设置Admin账户信息,见7-1-3,7-1-4,7-1-5图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
7-1-3
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
7-1-4
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
7-1-5

重启Hexo,然后访问改才的管理员界面,就可以看到身份验证了,见7-1-6图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
7-1-6

之后这个管理员界面就可以让你自由管理你的Blog而不被其他人插手了

文章(Post),页面(Page)和草稿(Draft)

文章(Post)

新建文章

hexo new post

post是文章名,可以自由更改,新建后会在/source/_post创建一个【文章名.md】的文件,见8-1-1图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
8-1-1

Front-matter 

Front-matter是保存文章信息的地方,我们在上面“ About界面 ”中提到过它,这里给大家详细讲解

8-1-2图中标记的范围就是Front-matter

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
8-1-2

 里面写明了文章创建的时间,标签,名字,也可以加入,分类,更改日期,评论系统是否开启等,具体见Hexo官方文档和Fluid官方配置指南全文都有

Front-matter | Hexo        配置指南 | Hexo Fluid 用户手册 (fluid-dev.github.io)

MarkDown

MarkDown是一种轻量标记语言,受到很多开发者的青睐,这里Bayi简单讲讲MarkDown的使用

MarkDown中可以插入HTML,有前端基础的童鞋应该学过HTML,下面是来自markdown.cn的描述

Markdown 语法的目标是:成为一种适用于网络的书写语言。

Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来, HTML 已经很容易写了。Markdown 的理念是,能让文档更容易读、写和随意改。HTML 是一种发布的格式,Markdown 是一种书写的格式。就这样,Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。

要制约的只有一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p> 等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown 的生成器有足够智能,不会在 HTML 区块标签外加上不必要的 <p> 标签。

例子如下,在 Markdown 文件里加上一段 HTML 表格:

这是一个普通段落。

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

这是另一个普通段落。

请注意,在 HTML 区块标签间的 Markdown 格式语法将不会被处理。比如,你在 HTML 区块内使用 Markdown 样式的*强调*会没有效果。

HTML 的区段(行内)标签如 <span>、<cite>、<del> 可以在 Markdown 的段落、列表或是标题里随意使用。依照个人习惯,甚至可以不用 Markdown 格式,而直接采用 HTML 标签来格式化。举例说明:如果比较喜欢 HTML 的 <a> 或 <img> 标签,可以直接使用这些标签,而不用 Markdown 提供的链接或是图像标签语法。

和处在 HTML 区块标签间不同,Markdown 语法在 HTML 区段标签间是有效的。

标题可以这样写:

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。

类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),例如:

This is an H1
=============

This is an H2
-------------

任何数量的 = 和 - 都可以有效果。

类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:

# 这是 H1

## 这是 H2

###### 这是 H6

当然,你可以选择性地「闭合」类 atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的 # 数量也不用和开头一样

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

引用这么写:

> 引用引用引用引用引用引用引用引用引用引用引用
> 引用引用引用引用引用引用引用引用引用引用引用
> 引用引用引用引用引用引用引用引用引用引用引用

 也可以这样:

> 引用引用引用引用引用引用引用引用引用
引用引用引用引用引用引用引用引用引用引引用
引用引用引用引用引用引用引用引用引用引用

更多具体的内容见教程-MarkDown​​​​​​

页面(Page)

新建页面

hexo new page aaa

这里,【aaa】就是页面(page)的名称

页面新建在这里,见8-2-1图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
8-2-1

重启Hexo,就可以在loucalhost:4000/aaa 访问到这个页面,见8-2-2图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
8-2-2

Front-matter

 一样,页面也有Front-matter,写法和文章的Front-matter差不太多,这里就不过多赘述

草稿(Draft)

草稿也是Bayi写这篇Blog才注意到的东西,引用一下普通程序员:

draft 顾名思义就是草稿的意思,使用 draft 布局建立的文章,其博客文章 md 源码位于 source/_drafts 路径下, hexo generate 不会将其编译到 public 目录下,所以 hexo deploy 也不会将其部署发布到博客网站上。

当我们写完整篇博客文章时,可以将草稿发布为正式文章,hexo 会将发布为正式文章的草稿文章源码从 source/_drafts 路径下,移到 source/_posts 下,这样就转成了正式文章,简单明了效果好。

创建草稿

hexo new draft aaa

其中【aaa】就是草稿名,虽然Hexo不会编译/source/_drafts下的文件,但是Hexo提供了一个预览的方法,就是:

hexo s --draft

正式发布博文

使用命令:

hexo p aaa

其中aaa是文章名,不包含.md后缀,该命令的原理也不过是将文章从/source/_drafts移动到/source/_posts而已,若日后想将正式文章转为为草稿,只需手动将文章从/source/_posts目录移动到/source/_drafts目录即可

布局(LayOut)

见8-4-1图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
8-4-1

GitHub Pages

到这里,Hexo的所有配置就全部完成了,让我们把它推送到GitHub Pages上,让它可以在输入一段域名后呈现在我们面前

创建GitHub Pages存储库

打开你的个人页面,创建一个存储库,见9-1-1,9-1-2,9-1-3图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
9-1-1
9-1-2

9-1-2不知为啥违规了,文字解释一下(感谢HMM_6大佬的指出):点击右上角绿色“New”按钮

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
9-1-3

安装deploy插件

npm install hexo-deployer-git --save

见9-1-4图

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
9-2-1

推送项目

更改项目根目录的配置文件,见9-3-1,9-3-2图

deploy:
  type: git
  repo: (你的项目HTTPS地址)     
  branch: main(你的默认分支)
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
9-3-1
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
9-3-2

 推送它到GitHub存储库,见9-3-3图

hexo d
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
9-3-3

查看效果

打开网站(<你的GitHub ID>.github.io),比如我的是Bayi-Cat.github.io,你应该就可以看到你的Blog了见9-4-1图,如果没有,看看有没有这个项目有没有被纳入GitHub Pages,见9-4-2图,如果符合,请等待5分钟后重试

Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
9-4-1
Hexo搭建教程?看这一篇就够了- How to系列,How to,node.js,windows,github,git
9-4-2

 搞定!

之后对你的Hexo有更改就重新生成静态文件如何提交即可


问题解答

来自大佬md_606的提醒

有个小bug,执行 npm install -g hexo-cli 时,需要管理员powershell,不然会报ERROR

来自大佬HMM_6的问题

作者你好,Node和Git必须和你设置一样的吗?

我的回答

如果是安装的话,可以自己设置,但需要明白每个选项的意思,如果想省事一些,可以和我一样;

如果指的是版本,建议一样,也可以更高或低版本,但需要了解到我们用到的功能并对比你用到的版本

来自大佬羊村的小羊的问题

大佬,安装admin插件后,打开localhost:4000/admin出现错误,怎么办

报错信息:Cannot GET/admin

我的回答

首先确认 admin 插件是否已经正确地安装到你的 Hexo 项目中。可以通过执行 npm ls --depth 0 命令查看已安装的插件列表中是否包含了 hexo-admin

重新安装插件:如果 admin 插件未正确安装,可以尝试重新安装。执行以下命令:

npm uninstall hexo-admin
npm install hexo-admin

清除缓存:在重新安装插件后,执行 Hexo 的清除缓存命令,以确保清除之前生成的缓存文件。执行以下命令:
 

hexo clean


启动 Hexo 服务器:重新启动 Hexo 的本地服务器,以确保加载最新的插件设置和配置文件。执行以下命令:
 

hexo server

来自大佬一分耕耘一分收获.的问题

大佬你好,我装了nvm,node_cache这几个文件是放在nvm目录下,还是放在对应版本目录下呢?

我的回答

放在 Nodejs 的安装目录下

来自大佬Zonless的问题

作者你好,为什么本地部署的时候Fluid的主题存在,部署到GitHub上就回到landscape主题了

我的回答

在提交之前可以先试试

hexo clean

然后

hexo g

hexo d

如果这样也不行的话检查一下本地编译出来的.html文件是不是Fluid的主题


特别感谢

特别感谢大佬      Just right的鼓励

特别感谢大佬HMM_6的提醒

特别感谢大佬小王学代码的鼓励

特别感谢大佬颜淡慕潇的鼓励

特别感谢大佬tp02的鼓励

特别感谢大佬​​​​​​​木木em哈哈的鼓励

特别感谢大佬​​​​​​​春人.的鼓励

特别感谢大佬​​​​​​​zoro-1的鼓励

也特别感谢在读文章的你们,在收藏的你们,点赞的你们,评论的你们,关注的你们,你们的支持就是我的动力


结语

作者回复反馈很及时,会帮助有问题的同学答疑解惑,会经常更新,收入How to精选教程专栏,想要了解的可以点进去

如果本文有任何问题欢迎在评论去指出,如果喜欢这篇文章,希望能点赞评论关注

读完了,如果你们身边有像你提起过这个领域的,或者希望搭建博客的,复制http://t.csdn.cn/atQAf到剪贴板分享给别人吧

本文共97张图片,14855字,17个父项,25个子项,31个孙子项

How to

我的创作纪念日_Cat_Bayi的博客-CSDN博客

Apple WWDC23开发者大会——Apple的野心_Cat_Bayi的博客-CSDN博客

如何在CSDN写高质量博客-How to系列_Cat_Bayi的博客-CSDN博客

裁剪一个简单的Linux_Cat_Bayi的博客-CSDN博客

参考,引用文献,书籍

参考,引用文献

Themes | Hexo

Plugins | Hexo

在 GitHub Pages 上部署 Hexo | Hexo

配置指南 | Hexo Fluid 用户手册 (fluid-dev.github.io)

Front-matter | Hexo

Github_百度百科 (baidu.com)

❤️github注册教程最新版(✨图文并茂最新版保姆级教程:建议收藏💘) - 墨抒颖 - 博客园 (cnblogs.com)

hexo安装、生成blog并deploy到github - 简书 (jianshu.com)

2022最新hexo最新搭建教程_hexo搭建教程_故人随笔的博客-CSDN博客

 hexo d 无反应解决方案_Vista、的博客-CSDN博客_hexo d

Github 生成SSH秘钥(详细教程)_孙文旭的博客-CSDN博客

SSH公钥原理(密钥,秘钥,私钥)(看了还是懵逼啊!)_Dontla的博客-CSDN博客_ssh公钥和私钥 Hexo草稿布局(draft)的使用 | 普通程序员 (programmerauthor.github.io)

初步了解Hexo站点的布局 - 简书 (jianshu.com)

关于hexo的草稿功能 | 薛定谔的第四旋臂 (direct5dom.github.io)

Git 详细安装教程(详解 Git 安装过程的每一个步骤)_mukes的博客-CSDN博客_git安装

 Node.js详细安装教程(2021)_cheerileeyoki的博客-CSDN博客_node.js 安装

教程-MarkDown

Hexo草稿布局(draft)的使用 | 普通程序员 (programmerauthor.github.io)

Stack Overflow中文网

回车和换行 - 阮一峰的网络日志 (ruanyifeng.com)

参考,引用书籍

GitHub入门与实践 (豆瓣) (douban.com)文章来源地址https://www.toymoban.com/news/detail-619293.html

到了这里,关于Hexo搭建教程?看这一篇就够了- How to系列的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • Git 教程--分支管理,全网最全,看这一篇就够了

    1、创建与合并分支 创建和合并分支是Git中重要的工作流程之一。下面是关于如何创建和合并分支的详细教程: 创建分支: 在命令行或终端中,导航到你的Git项目目录。 使用以下命令创建一个新的分支,其中 分支名 是你希望创建的新分支的名称: 例如,可以使用命令 git

    2024年02月03日
    浏览(59)
  • RabbitMQ教程大全看这一篇就够了-java版本

    目录 什么是RabbitMQ? RabbitMQ 核心概念 Docker 安装 RabbitMQ  RabbitMQ 控制台页面介绍 RabbitMQ 交换机 Exchange 介绍 Direct Exchange 定向、直连交换机 Fanout Exchange 发布/订阅、广播、扇形交换机 Topic Exchange 主题、通配符交换机 Headers Exchanges(少用) RabbitMQ 代码 Java版 1:简单队列 2:工作

    2023年04月08日
    浏览(40)
  • 史上最详细的KMP算法教程,看这一篇就够了

    🧑‍💻 文章作者:Iareges 🔗 博客主页:https://blog.csdn.net/raelum ⚠️ 转载请注明出处 ⚠️ 本文讨论的下标均从 0 0 0 开始。 字符串匹配又称模式匹配(pattern matching)。该问题可以概括为「给定字符串 s s s 和 t t t ,在主串 s s s 中寻找子串 t t t 」。字符串 t t t 称为 模式串

    2024年03月27日
    浏览(58)
  • IDEA中搭建flink开发环境,看这一篇就够了,亲测有效

    在使用flink进行应用开发的时候,通常都是将开发的应用程序,提交到flink集群中,但是这样对应用程序开发调试很不方便,所谓磨刀不误砍柴工,下面我整理一个在mac上使用idea开发flink程序的配置教程,具体如下。 添加flink应用程序开发必要的依赖: 此时启动开发的应用程

    2023年04月10日
    浏览(52)
  • 【Golang入门教程】Goland常用快捷键,看这一篇就够了

    强烈推荐 前些天发现了一个巨牛的人工智能学习网站,通俗易懂,风趣幽默,忍不住分享一下给大家。点击跳转到网站: 人工智能 前言 在进行Go语言开发时,熟练使用快捷键是提高效率、加快编码速度的关键。 Goland作为一款强大的集成开发环境(IDE),提供了丰富的快捷键

    2024年02月20日
    浏览(53)
  • Verilog:【7】超详细WaveDrom教程,时序图绘制利器,看这一篇就够了。

    碎碎念: 没想到上一篇发出去,前几个小时竟然基本没人看,是我写得太晦涩了吗,这篇介绍个简单但是相当好用的软件WaveDrom,可以非常方便的绘制时序图,简直是数字人的福音啦! 本文将从安装开始,详细介绍涉及到的语法等内容,读者可以收藏起来随时查阅。 P.S. 照这

    2024年02月03日
    浏览(53)
  • AI绘画Stable diffusion保姆级教程,看这一篇就够了「安装-配置-画图」

    随着chat gpt爆火之后,越来越多的人开始关注人工智能,人工智能相关的其他应用如AI绘画,也再次得到人们的关注。AI绘画的确很上头,最近几天小编也研究一下,这里把研究的过程以及中间遇到的问题整理一下,我这里遇到的问题,相信新入门的小白也会遇到,希望本文对

    2024年02月10日
    浏览(57)
  • CSS基础——看这一篇就够了

    目录 一、CSS简介 1.CSS是什么? 2.CSS的作用 3.CSS的构成 二、CSS选择器 1.基础选择器 (1).标签选择器 (2)类选择器 (3)标签选择器 (4) 通配符选择器 2.复合选择器 (1)后代选择器(包含选择器) (2)子选择器 (3)并集选择器 (4)伪类选择器  三、基本属性 1.字体属性

    2024年02月09日
    浏览(71)
  • 精通线程池,看这一篇就够了

    当我们运用多线程技术处理任务时,需要不断通过new的方式创建线程,这样频繁创建和销毁线程,会造成cpu消耗过多。那么有没有什么办法 避免频繁创建线程 呢? 当然有,和我们以前学习过多连接池技术类似,线程池通过提前创建好线程保存在线程池中, 在任务要执行时取

    2023年04月17日
    浏览(96)
  • 还不会拓扑排序?看这一篇就够了

    拓扑排序是一种有向无环图(DAG)的顶点排序方法,它将一个有向无环图中的所有顶点排成一个线性序列,使得图中 任意一条有向边上的起点排在终点的前面 。 这样说还不够具体,我们先来看一个例子。假设某大学的课程安排如下: 课程编号 课程名称 先修课程 1 1 1 高等数

    2023年04月08日
    浏览(110)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包