必备工具#

1. Node.js：

   官方网站:https://nodejs.org/en/

   下载地址:https://nodejs.org/en/download/

   淘宝分流:https://npm.taobao.org/mirrors/node

2. Git:

   官方网站:http://git-scm.com/

   下载地址:https://git-scm.com/download

   淘宝分流（Windows）:https://npm.taobao.org/mirrors/git-for-windows/

安装hexo#

0*：配置淘宝cnpm管理器（右键打开Git Bash here）（不能使用 Ctrl + C ，右键选择Paste复制）：

1
npm install -g cnpm --registry=http://registry.npm.taobao.org

（注意：只复制npm及以后的内容，不需要复制“$”）

1.确定安装hexo的位置（存放博客文件的位置，不需要新建文件夹）

2.在确定安装的位置中右键，点击Git Bash here

3.复制以下代码至弹出的命令行窗口中

1
npm install -g hexo-cli

或者：

1
cnpm install -g hexo-cli

4.创建blog文件夹：

1
hexo init <folder>
2
cd <folder>
3
npm install

“”为将新建的用于存放hexo文件的文件夹的名字，请更改

自此，hexo已安装完成，以下为配置教程：

常用命令：#

1
hexo s #实时预览blog，在浏览器打开localhost:4000
2
hexo g #生成blog网页文件
3
hexo d #部署blog至远程服务器
4
hexo clean #清理blog网页文件

（不需要复制$及以后的内容）

_config.yml#

位于blog文件夹根目录下的blog配置文件。

官方帮助文档链接：https://hexo.io/zh-cn/docs/configuration

我们通常使用sublime text编辑yml和其他配置文件，下载地址：下载 - 崇高文本 (sublimetext.com)

文章创建：#

hexo默认使用.md（Markdown）文件进行blog文章创建，通常存放在…\source\ _posts下

我们通常使用Typora来进行对Markdown文件的编辑，下载链接：https://typora.io/#download

文章信息编辑（front-matter）：#

官方帮助文档：https://hexo.io/zh-cn/docs/front-matter

创建SSH:#

打开终端，输入（填写你的邮箱）：

1
ssh-keygen -t rsa -C 'yourmail@example.com'

然后不断enter即可

在你的用户文件夹下找到.ssh文件夹，找到id_rsa.pub并用记事本打开，里面的内容就是你的SSH密钥

绑定：#

登录你的Github，并跳转到SSH and GPG keys (github.com)

点击New SSH key，titlle任取，key中粘贴你的SSH密钥

点击Add SSH key即可

验证：#

在终端中输入

1
ssh -T git@github.com

若输出：

1
Are you sure you want to continue connecting (yes/no)?

输入yes，输出：

1
Hi xxx! You've successfully authenticated, but Github does not provide shell access.

即成功

部署：#

在终端中输入(npm可改成cnpm)：

1
npm install hexo-deployer-git --save

并修改_config.yml(hexo根目录)：

1
deploy:
2
  type: git
3
  repo: <repository url> #https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
4
  branch: master
5
  message:

参考示例，在repo这一行输入你的仓库地址，保存

在终端中输入：

1
hexo d

开始上传你的blog文件，中途可能需要你输入账号密码，稍等片刻，你的blog就可以部署在远程服务器中

下载：#

在hexo根目录打开git bash，输入以下命令以下载butterfly主题：

1
git clone -b master https://gitee.com/iamjerryw/hexo-theme-butterfly.git themes/butterfly

使用：#

编辑_config.yml（请找到theme而非直接复制粘贴）：

1
theme: butterfly

然后hexo clean和hexo g

配置：#

敬请参阅官方配置文档：Butterfly 安裝文檔(一) 快速開始 | Butterfly

添加页面：#

添加tags页（标签页）和categories页（分类页）和about页（关于）和link页（友情链接）都可使用此方法

以创建tags页为例：

在hexo根目录下打开source文件夹

创建文件夹并命名为tags

在新创建的文件夹中创建index.md文件

在index.md文件中添加以下内容（front-matter）：

1
---
2
title: 标签
3
date: 2021-01-24 05:26:43
4
type: "tags"
5
---

然后执行hexo clean和hexo g即可完成创建

hexo: command not found 或 cnpm: command not found#

在终端输入以下命令:

1
npm install hexo-cil -g

或：

1
npm install -g cnpm --registry=http://registry.npm.taobao.org

然后你会看到类似于以下的输出（以安装cnpm为例）：

1
$ npm install -g cnpm --registry=http://registry.npm.taobao.org
2
npm WARN deprecated request@2.88.2: request has been deprecated, see https://github.com/request/request/issues/3142
3
npm WARN deprecated har-validator@5.1.5: this
4
C:\Users\沐沐\AppData\Roaming\npm\cnpm -> C:\Users\沐沐\AppData\Roaming\npm\node_modules\cnpm\bin\cnpm
5
+ cnpm@6.2.0
6
updated 1 package in 80.744s

此时复制”->“后的内容（但不要复制bin后面的内容），

也就是：C:\Users\沐沐\AppData\Roaming\npm\node_modules\cnpm\bin

依次打开设置->系统->关于->高级系统设置->环境变量

在”…的用户变量”下方找到Path变量，双击Path变量进入编辑界面，点击新建，粘贴你刚才复制的内容，回车并点击确定即可

如何在右键快捷菜单的新建选项中添加Markdown选项#

敬请参阅：Win10系统下鼠标右键新建Markdown文档 - 知音12138 - 博客园 (cnblogs.com)

Git提交时提示‘The file will have its original line endings in your working directory’#

在终端中输入：

1
git config --global core.autocrlf  false

即可解决