使用Hexo搭建静态博客

这不是一个教程，只是记录个人配置Hexo的历程，方便下次使用，最后的参考资料中会有详细的搭建教程。

Hexo简介

hexo是一款快速、简洁且高效的博客框架，基于node.js构建，速度快，支持Markdown的编写文章，可以一键部署到GitHub，简单方便。参考 : Hexo中文网站

环境搭建

依赖环境: node.js、npm(或yarn)，部署网站需要 git

安装和使用

安装

yarn add global hexo-cli # 安装hexo-cli
hexo -v # 检测hexo是否安装完成

初始化站点

hexo init <folder> # 新建一个Hexo站点，如果没有设置 <folder>，Hexo 默认在目前的文件夹建立网站。
cd <folder> && npm install

hexo server # 启动服务器，默认情况下，访问网址为： http://localhost:4000/
# 可选参数:
# -p, --port	重设端口
# -s, --static	只使用静态文件
# -l, --log		启动日记记录，使用覆盖记录格式

其他命令

hexo new [layout] <title> # 新建一篇文章
# 如果没有设置 [layout] 的话，默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话需要使用引号括起来。

hexo generate # 生成静态文件
# 可选参数:
# -d, --deploy	文件生成后立即部署网站
# -w, --watch监视文件变动

hexo publish [layout] <filename> # 发布草稿

hexo deploy # 部署网站
# 可选参数:
# -g, --generate	部署之前预先生成静态文件

hexo clean # 清除缓存，这将清除缓存文件 (db.json) 和已生成的静态文件 (public)。

命令简写

hexo n # hexo new
hexo g # hexo generate
hexo s # hexo server
hexo d # hexo deploy

网站部署配置

编辑项目根目录下的_config,yml

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repository: https://github.com/quanzaiyu/quanzaiyu.github.io.git
  barnch: master

可能需要配置SSH，网上搜一下就有解决方案。参考

关于如何配置 github pages 参考网上资料即可。

可能出现的问题:

(node:19344) [DEP0061] DeprecationWarning: fs.SyncWriteStream is deprecated

根据提示，deprecated，弃用了，说明前面那个应该是个方法，这个方法在node当中弃用了。明显就是Hexo还在继续使用这个已经被弃用的方法。

解决方案: npm install hexo-fs --save 更新一下hexo-fs插件。参考

Error: Deployer not found : github,

安装插件 npm install hexo-deployer-git --save ，然后再generate 和deploy

参考资料

• 博客园 - cherishzy : 在Github上面搭建Hexo博客（一）：部署到Github
• 博客园 - 流浪猫の窝 : 使用hexo搭建github.io博客(一)
• 简书 - sanchuan : 你不知道的HEXO deploy