这是hexo博客手工生成的第一份文档！

hexo安装

安装准备

• git (提供命令git) git官网
• tortoiseGit（图形化操作git）TortoiseGit – Windows Shell Interface to Git
• notepad++(方便编辑)notepad++官网
• nodejs(hexo依赖)nodejs官网
• 7z(压缩包)7z官网

hexo的安装： 依赖git、npm等组件，需先做国内源加速，再依次进行。

# 设置淘宝源,用于国内网络环境加速
npm config set registry https://registry.npm.taobao.org 

# 使用官方镜像，如果需要回退的话 npm config set registry https://registry.npmjs.org/
npm config get registry # 检查源是否设置成功

npm info hexo	# 测试查看hexo的安装信息，是否是taobao.org的源

npm install -g hexo 		# 通过npm安装hexo
# -g 指定全局安装，可以使用hexo命令

博客初始化

创建博客

npm install hexo # 这一步不同于上面加-g， 主要在博客项目中生成node-modules文件夹，并初始化hexo模块，上一步是完成cli客户端的全局配置

mkdir testFolder
cd testFolder
hexo init

# 时间需要持续3~5分钟，请耐心等待，如果卡住了，一般是网络问题，请检查加速源是否OK，必要时科学处理

生成第一份博文

hexo new "My New Post" #可以用中文，会自动按pinyin转换

注：后续用任意编辑器处理即可，如当前用的是typora

静态文件输出

hexo clean && hexo generate #支持短命令，如果没有重复的话，如 hexo clean && hexo g

启动服务

 hexo server # 关闭使用 ctrl+c

部署到github

hexo deploy #需提前配置，详见下文
node refresh #刷新pages，需提前安装配置

博客配置

安装皮肤

# 1、npm方式安装主题
npm install --save hexo-theme-fluid # hexo -v 5.0以上支持皮肤安装到博客源码中的node_modules中

# 2、创建主题配置文件，拷贝node_modules下主题目录中的_config.yml到博客源码根目录，并重命名为_config.fluid.yml

# 3、激活新主题，修改根目录下的站点配置_config.yml
theme: fluid  # 指定主题
language: zh-CN  # 指定语言，会影响主题显示的语言，按需修改

更新皮肤

npm update --save hexo-theme-fluid

创建【关于页】

仅首次运行时，创建一次即可：

hexo new page about

关于标签和分类

# 存放于头部，格式如下
tags: 
- 标签1
- 标签2
categories: 
- [分类1, 分类1下的分类11]
- 分类2

注意categories和tags下的-符号后要加空格；且分类一般只加一个，标签可以多个。分类多了之后就变成二级分类了

部署

部署到git

# 安装git依赖
npm install hexo-deployer-git --save

# 修改站点配置_config.yml 添加github、gitee地址
deploy:
  type: 'git'
  repo: 'https://gitee.com/lin8878/lin8878.git'
  branch: master
  
# 多个仓库地址可以并列多个repo，如gitee+github同步

部署到ftp

# 安装git依赖
npm install hexo-deployer-ftpsync --save

#### ftp deploy
deploy:
 type: ftpsync
 host: ftpserver # ftp服务器地址
 user: ftpusername # ftp用户名
 pass: xxxx # 你的ftp用户密码
 remote: xxx # 你要上传到的地址，例如/wwwroot
 port: 21 # ftp端口，不同的ftp可能会不一样
 delete: true # 上传本地文件是否删除ftp中的所有文件
 verbose: true # 是否打印调试信息
 ignore_errors: false # 是否忽略错误

补充：puppeteer自动刷新pages的脚本

因gitee pages action归属pro收费服务，业内通用办法是采用github action曲线救国或使用gitee的webhook进行外部激活，这里提供的是本地执行机器人脚本，模拟登陆、刷新，可以实现相同效果，但可能存在账号密码暴露的风险，所以切换提交，应做好本地过滤，具体操作如下！

2022-7-9 补充自动化脚本的安装使用

• 1、跟新source最新代码
• 2、项目根目录执行npm install 或npm i -s puppeteer@1.8.0 安装puppeteer的插件
• 3、复制一份根目录下index.js文件，新文件名为refresh.js，替换refresh文件里面的账号密码，.gitignore中已对该文件做了忽略登记，可避免密码提交到远端公开！
• 4、日常使用，在deploy操作后，再执行node refresh即可自动打开浏览器进行更新操作！

最后

hexo是目前比较流行的文档创作工具，创作工具使用到了winTerminal+typora+picgo+alioss，本文并未详细阐述，具体可参看其他文档！

更多hexo玩法，参看官方文档 配置指南 | Hexo Fluid 用户手册 (fluid-dev.com)