Hexo 是一个静态博客框架，基于 Node.js，将 Markdown 文章通过渲染引擎，生成一个静态网页，再结合 Git 命令（ssh），Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。话不多说，直接开始 !
1.1 Node.js 的安装
Node.js 官网 下载Nodejs安装程序，使用命令 node -v 查看是否安装成功。
首先就是去 Git 官网下载 Git安装程序
点击Downloads -> 根据你的系统选择Mac os / Windows / Linux -> 开始下载
回到桌面，点击鼠标右键，会出现两个选项 Git GUI Here 和 Git Bash Here，在打开 Cmd (Win+R)，分别输入 git 和 git --version，如果出现如下图的情况，即安装成功！
配置Git 用户名和邮箱
在桌面点击鼠标右键，点击 Git Bash Here，会出现一个界面如下图所示：
然后分别输入下面的两个命令，并回车：
git config --global user.name "此处填写你注册时的用户名"
git config --global user.email "此处填写你注册时的邮箱"
# 一般只要不报错，可以跳过下面寻找.gitconfig文件 然后找到.gitconfig 文件，文件存放位置在 C:/Users/[username]/.gitconfig（未找到的话，请开启显示隐藏文件的功能），用编辑器打开，看到如下图所示的内容，即配置成功！
配置GitHub
创建：
新建一个名为你的用户名.github.io的仓库
若你的用户名为a，则新建仓库名为a.github.io
注意：
注册的邮箱一定要验证，否则不会成功；
仓库名字必须是：用户名.github.io；
在github上创建仓库
配置SSH 免密登录
为什么要配置这个呢？因为你提交代码肯定要拥有你的github权限才可以，但是直接使用用户名和密码太不安全了，所以我们使用ssh key来解决本地和服务器的连接问题。
简单的来说就是给予你当前电脑访问你GitHub 仓库的权限 ~
操作步骤
在 git bash here 中创建一个ssh密钥
指令：cd ~/.ssh
如果本地有的话，它会自动进入到了ssh目录下；
若没有则创建： ssh-keygen -t rsa -C "邮箱" 此处邮箱填写自己的邮箱
然后enter三连
生成两个文件： id_rsa id_rsa.pub 存放在 C:\Users\admin.ssh 文件夹下
注意：pub文件放置的，就是我们的公开的ssh码，也是给管理员这个ssh，让他来添加
在GitHub 或者 Gitee 上添加 SSH key
Title：随意填写
Key：将本地的id_rsa.pub文件用记事本打开，复制全部内容粘贴到GitHub 仓库的SSH Keys 位置
如下图所示：
添加密钥到github
至此，你的全部环境均以搭建好，接下来让我们快速开始搭建博客吧 ~
命令行安装cnpm （加速以后的插件下载，建议git bash here 处安装）
命令：npm install -g cnpm --registry==https://registry.npm.taobao.org
安装后验证：cnpm -v 出现版本号说明安装成功
命令行安装hexo （安装博客框架）
命令：cnpm install -g hexo-cli
安装后验证：hexo -v 出现版本号说明安装成功
在电脑的某个地方新建一个名为HexoData的文件夹（名字可以随便取），比如我的是D:\JAVA项目\HexoData
这个文件夹将来就作为你存放代码的地方，所以最好不要随便放
在D:\JAVA项目\HexoData 文件夹下右键打开 Git Bash
并依次执行以下命令
hexo init 初始化命令，hexo会自动下载一些文件到这个目录，包括node_modules等
hexo g 生成命令
hexo s 启动服务
说明：hexo s 是开启本地预览服务，打开浏览器访问 http://localhost:4000 即可看到内容，说明博客初始化以及成功！
很多人会碰到浏览器一直在转圈但是就是加载不出来的问题，一般情况下是因为端口占用的缘故，
因为4000这个端口太常见了， 只需要关闭4000端口并重新启动即可
到此博客的初始化便完成了，此时你可以本地开启服务并访问，下一步便是推送到GitHub 上！
第一步：在D:\JAVA项目\HexoData目录下安装 hexo-deployer-git 插件 （git bash here 处安装）
命令：npm install hexo-deployer-git --save
说明：必须安装，否则执行hexo d 的话会报错
第二步：编辑D:\JAVA项目\HexoData目录下的 _config.yml 文件, 在文件末尾修改配置文件：
deploy:
type: git
repo: github上对应仓库的ssh 链接
//也可使用https地址，如：https://github.com/Github用户名/Github用户名.github.io.git
branch: main说明：仓库的ssh链接如下
SSH链接
切记：分支branch切记修改为 main，之前github的默认主分支为master，现已经改为main ！！！
第三步：在D:\JAVA项目\HexoData目录下, 将本地 blog 推送到 github仓库
输入命令：hexo d
也可能需要输入 username & pwd
推送成功后, 在浏览器中输入对应域名, 即可访问 LaughingCat
至此，你便初步搭建好了一个属于自己的博客！（本地服务不用启动依然可以访问）
下一步便是进行博客的美化 ~
此处附加上 hexo 框架常用的指令：
| 指令 | 说明 |
|---|---|
hexo clean && hexo g |
清除本地项目并重新生成 （重新部署时使用） |
hexo g |
重新生成 |
Hexo s |
开启本地预览 |
Hexo d |
推送到github |
点击 传送门 下载 master 分支的最新稳定版的代码，解压缩后，将 hexo-theme-matery 的文件夹复制到你 Hexo 的 themes 文件夹中即可。
当然你也可以在你的站点目录文件夹下使用 git clone 命令来下载（推荐）：
直接在D:\JAVA项目\HexoData\themes目录下执行下面的命令（git bash here 处）：
git clone git@github.com:blinkfox/hexo-theme-matery.git 下载完成后便可看到对应的主题文件
注意：首先需要明白什么是站点配置文件，什么是主题配置文件。
站点配置文件就是根目录下的配置文件，比如我的博客文件在 D:\JAVA项目\HexoData 下，那么站点配置文件就是 D:\JAVA项目\HexoData_config.yml，
主题配置文件就是 D:\JAVA项目\HexoData\hexo-theme-matery\_config.yml。
另外注意，配置文件中的标点符号不要出现中文格式的标点符号，不然运行会出错。
主题下载完成后，将站点配置文件中的 theme 值修改为你下载主题的文件名，此处为 hexo-theme-matery，那么值就修改为 theme: hexo-theme-matery
一些站点配置文件的其他地方的修改：
language: 后添加值 zh-CN，如果不修改，默认为英语；url: 的值为你的网址名，如 http://xxxx.github.io，如果有域名，则修改为你的域名即可;per_page属性，建议修改为 6 的倍数，这样网站在适应设备时，有较好的显示效果。tags 页是用来展示所有标签的页面，如果在你的博客 source 目录下还没有 tags/index.md 文件，那么你就需要新建一个，命令如下（source目录下 右键 git bash here）：
hexo new page "tags"编辑你刚刚新建的页面文件 /source/tags/index.md，至少需要以下内容：
---
title: tags
date: 2018-09-30 18:23:38
type: "tags"
layout: "tags"
---categories 页是用来展示所有分类的页面，如果在你的博客 source 目录下还没有 categories/index.md 文件，那么你就需要新建一个，命令如下：
hexo new page "categories"编辑你刚刚新建的页面文件 /source/categories/index.md，至少需要以下内容：
---
title: categories
date: 2018-09-30 17:25:30
type: "categories"
layout: "categories"
---about 页是用来展示关于我和我的博客信息的页面，如果在你的博客 source 目录下还没有 about/index.md 文件，那么你就需要新建一个，命令如下：hexo new page "about"编辑你刚刚新建的页面文件 /source/about/index.md，至少需要以下内容：
---
title: about
date: 2018-09-30 17:25:30
type: "about"
layout: "about"
---contact 页是用来展示留言板信息的页面，如果在你的博客 source 目录下还没有 contact/index.md 文件，那么你就需要新建一个，命令如下：hexo new page "contact"编辑你刚刚新建的页面文件 /source/contact/index.md，至少需要以下内容：
---
title: contact
date: 2018-09-30 17:25:30
type: "contact"
layout: "contact"
---注：本留言板功能依赖于第三方评论系统，请激活你的评论系统才有效果。并且在主题的 _config.yml 文件中，第 19 至 21 行的 “菜单” 配置，取消关于留言板的注释即可。
安装命令如下：
npm install hexo-filter-github-emojis --save在 Hexo 根目录下的 _config.yml 文件中，新增以下的配置项：
ithubEmojis:
enable: true
className: github-emoji
inject: true
styles:
customEmojis:执行 hexo clean && hexo g 重新生成博客文件，然后就可以在文章中对应位置看到你用 emoji 语法写的表情了。
由于 Hexo 自带的代码高亮主题显示不好看，所以主题中使用到了 hexo-prism-plugin 的 Hexo 插件来做代码高亮，安装命令如下：
npm i -S hexo-prism-plugin然后，修改 Hexo 根目录下 _config.yml 文件中 highlight.enable 的值为 false，并新增 prism 插件相关的配置，主要配置如下：
prism_plugin:
mode: 'preprocess' # realtime/preprocess
theme: 'tomorrow'
line_number: false # default false
custom_css:本主题中还使用到了 hexo-generator-search 的 Hexo 插件来做内容搜索，安装命令如下：
npm install hexo-generator-search --save在 Hexo 根目录下的 _config.yml 文件中，新增以下的配置项：
search:
path: search.xml
field: post如果你的文章名称是中文的，那么 Hexo 默认生成的永久链接也会有中文，这样不利于 SEO，且 gitment 评论对中文链接也不支持。我们可以用 hexo-permalink-pinyin Hexo 插件使在生成文章时生成中文拼音的永久链接。
安装命令如下：
npm i hexo-permalink-pinyin --save在 Hexo 根目录下的 _config.yml 文件中，新增以下的配置项：
permalink_pinyin:
enable: true
separator: '-' # default: '-'注：除了此插件外，hexo-abbrlink 插件也可以生成非中文的链接。
如果你想要在文章中显示文章字数、阅读时长信息，可以安装 hexo-wordcount 插件。
安装命令如下：
npm i --save hexo-wordcount然后只需在本主题下的 _config.yml 文件中，激活以下配置项即可：
wordCount:
enable: false # 将这个值设置为 true 即可.
postWordCount: true
min2read: true
totalCount: true页脚信息可能需要做定制化修改，而且它不便于做成配置信息，所以可能需要你自己去再修改和加工。修改的地方在主题文件的 /layout/_partial/footer.ejs 文件中，包括站点、使用的主题、访问量等。
在主题的 _config.yml 文件中，默认支持 QQ、GitHub 和邮箱等的配置，你可以在主题文件的 /layout/_partial/social-link.ejs 文件中，新增、修改你需要的社交链接地址，增加链接可参考如下代码：
新增我的CSDN链接
<% if (theme.socialLink.csdn) { %>
<a href="<%= theme.socialLink.csdn %>" class="tooltipped" target="_blank" data-tooltip="关注我的CSDN: <%= theme.socialLink.csdn %>" data-position="top" data-delay="50">
<i class="fab fa-csdn">CSDN</i>
</a>
<% } %>接着你需要在主题配置文件下新增CSDN链接
socialLink:
qq: 624597867
weixin: https://cdn.jsdelivr.net/gh/Yafine/Yafine-imgs/images/wechat.png
github:
email:
facebook: # https://www.facebook.com/xxx
twitter: # https://twitter.com/xxx
weibo: # https://weibo.com/xxx
csdn: https://blog.csdn.net/victoryxa # 新增CSDN链接
在本主题的 _config.yml 中可以修改部分自定义信息，有以下几个部分：
favicon 和 Logo
Gitalk、Gitment、Valine 和 disqus 评论配置Google Analytics）hashcode 值取余，来选择展示对应的特色图我认为个人博客应该都有自己的风格和特色。如果本主题中的诸多功能和主题色彩你不满意，可以在主题中自定义修改，很多更自由的功能和细节点的修改难以在主题的 _config.yml 中完成，需要修改源代码才来完成。以下列出了可能对你有用的地方：
在主题文件的 /source/css/matery.css 文件中，搜索 .bg-color 来修改背景颜色：
/* 整体背景颜色，包括导航、移动端的导航、页尾、标签页等的背景颜色. */
.bg-color {
background-image: linear-gradient(to right, #4cbf30 0%, #0f9d58 100%);
}
/*如果想去掉banner图的颜色渐变效果，请将以下的css属性注释掉或者删除掉即可*/
@-webkit-keyframes rainbow {
/* 动态切换背景颜色. */
}
@keyframes rainbow {
/* 动态切换背景颜色. */
}Tips：建议使用第三方工具（如IDE）打开css文件，使用查找功能（ctrl + f）来快速定位
你可以直接在 /source/medias/banner 文件夹中更换你喜欢的 banner 图片，主题代码中是每天动态切换一张，只需 7 张即可。如果你会 JavaScript 代码，可以修改成你自己喜欢切换逻辑，如：随机切换等，banner 切换的代码位置在 /layout/_partial/bg-cover-content.ejs 文件的 `` 代码中：
$('.bg-cover').css('background-image', 'url(/medias/banner/' + new Date().getDay() + '.jpg)');说明： banner图即为你博客主页所显示的图片 （默认为 0.jpg ）
相关配置信息如下：
#这是根目录下的配置文件信息
title: 过客~励む #这是网站标题
subtitle: 励む #这是网站副标题subtitler
# 下面两个description,keywords，需要填上，如果想让搜索引擎收录，这个做SEO优化必不可忽视的两个属性
description: 专注于Web,分享生活,分享知识 #网站描述
keywords: [HTML, CSS, JavaScript, JQuery, React, Vue.js等] #网站的关键词
author: YangAir #作者，文章版权所显示的
language: zh-CN #网站语言，不填写，默认为英文
timezone: #时区，可以不填写
# 这是主题配置文件的相关信息
# 配置网站favicon和网站LOGO
# 此处我用的CDN，也可以使用本地文件
favicon: https://cdn.jsdelivr.net/gh/Yafine/cdn@3.3.4/source/favicon.png
logo: https://cdn.jsdelivr.net/gh/Yafine/cdn@3.3.4/source/logo.png
# 网站副标题，打字效果
# 如果有符号 ‘ ，请在 ’ 前面加上 \
subtitle:
enable: true
loop: true # 是否循环
showCursor: true # 是否显示光标
startDelay: 300 # 开始延迟
typeSpeed: 100 # 打字速度
backSpeed: 50 # 删除速度
sub1: 志之所向，金石为开，谁能御之？
sub2: 花开不是为了花落，而是为了开的更加灿烂。
sub3: 没有伞的孩子必须努力奔跑！
sub4: 欲望以提升热忱，毅力以磨平高山。
sub5: 如果放弃太早，你永远都不知道自己会错过什么。
sub6: 没有礁石，就没有美丽的浪花；没有挫折，就没有壮丽的人生。注意：
网站打字效果副标题默认有两个，即 sub1 和 sub2，如果想写多个，则需要修改两处地方，首先修改配置文件，如上面所示，在 sub1 和 sub2 后面继续添加即可，然后在去主题目录下的 layout 文件夹下的_partial 文件夹，修改 bg-cover-content.ejs 文件，大约在 12 行左右，如下面所示：
<div class="description center-align">
<% if (theme.subtitle.enable) { %>
<span id="subtitle"></span>
<script src="https://cdn.jsdelivr.net/npm/typed.js@2.0.11"></script>
<script>
var typed = new Typed("#subtitle", {
strings: ['<%= theme.subtitle.sub1 %>',
'<%= theme.subtitle.sub2 %>',
'<%= theme.subtitle.sub3 %>',
'<%= theme.subtitle.sub4 %>',
'<%= theme.subtitle.sub5 %>',
'<%= theme.subtitle.sub6 %>'],
startDelay: <%= theme.subtitle.startDelay %>,
typeSpeed: <%= theme.subtitle.typeSpeed %>,
loop: <%= theme.subtitle.loop %>,
backSpeed: <%= theme.subtitle.backSpeed %>,
showCursor: <%= theme.subtitle.showCursor %>
});
</script>
<% } else { %>
<%= config.description %>
<% } %>
</div>打开 theme/matery/layout/about.ejs 文件，大约在 13 行。有一个 `` 标签，找出其对应结尾的标签，大约在 61 行左右，然后在新增如下代码：
<div class="card">
<div class="card-content">
<div class="card-content article-card-content">
<div class="title center-align" data-aos="zoom-in-up">
<i class="fa fa-address-book"></i> <%- __('个人简历') %>
</div>
<div id="articleContent" data-aos="fade-up">
<%- page.content %>
</div>
</div>
</div>
</div>注意粘贴的位置和空格要正确，这里的位置随你自己设置，你也可以把简历作为第一个 card，然后 /source/about/index.md 下面写上你的简历了（就像写博客一样）。
.md文件方法1：定位到我们的hexo根目录，Git Bash Here 中执行命令：
hexo new 'my-first-blog' 其中引号内为文章名称
hexo会帮我们在D:\JAVA项目\HexoData\source\_posts 下生成相关.md文件，用这个命令的好处是帮我们自动生成了时间，方法1默认生成如下内容：
title: my-first-blot
date: 2021-11-29 18:21:30
tags:方法2：当然你也可以直接自己打开D:\JAVA项目\HexoData\source\_posts 目录新建.md文件
第二步：编写并保存
我们只需要用typora打开这个文件就可以开始写博客了，写完后Ctrl+S 保存关闭即可
第三步：清理然后再生成一下，生成后推送到远程仓库即可，hexo根目录下右键Git Bash Here 中依次输入如下命令：
hexo clean
hexo g
hexo d 补充：hexo new page 'postName'命令和hexo new 'postName'的区别？
hexo new page 'My-second-blog'最终部署时生成：hexo\public\my-second-blog\index.html，但是它不会作为文章出现在博文目录。
参考：