原创

Hexo静态网站生成器 这里介绍如何使用 和 问题汇总！

索引

• 索引
• 前言
• 目录
• 安装Hexo运行环境
• 安装Hexo
• 使用Hexo
  • 创建一个博客
  • 常用命令
  • 设置新主题
  • 配置Hexo
  • 插件/功能
    • 文章加密
• 问题
  • hexo d 出现 ERROR Deployer not found: git

前言

• Hexo是一个静态网页生成器，快速 简洁 高效的博客框架！
• 可用于制作个人博客，文档说明 等等静态网站的生成。
• 生成的静态网页可以直接部署到Github Pages仓库
• 文章支持Markdown格式编写 非常方便
• Hexo基于Node.js开发
• Hexo的好处在于 让你的精力放在专注于文章上 而页面的生成完全交给Hexo来完成！
• Hexo还可以加载各种主题 插件来实现很多功能。
  例如 评论系统 分享按钮 文章加密 等等。

目录

• 本文将分为以下几个章节，介绍Hexo的安装和使用
• 安装Hexo运行环境
• 安装Hexo
• 使用Hexo创建一个简单的个人博客
• 使用中遇到问题 和 解决

安装Hexo运行环境

• 在使用Hexo前，需要安装必要的环境
• 安装Node.js环境 Hexo官方推荐使用12.0及以上版本
  安装Node.js可以参考 菜鸟教程 我的博文
• 安装Git工具 可以参考 菜鸟教程
• 安装好以上环境 工具 就可以开始安装Hexo了

安装Hexo

• 官方文档

1. 打开命令行工具 -g 表示全局安装

    $ npm install -g hexo-cli
   

2. 安装完成后 就可以使用Hexo创建博客了

• 如果需要使用hexo deploy部署命令 需要先执行以下命令

    $ npm install --save hexo-deployer-git
  

使用Hexo

创建一个博客

• 在需要创建博客的目录打开命令行工具

1. 新建博客

    $ hexo init myblog
   

2. 进入博客文件夹

    $ cd myblog
   

3. 安装依赖项

    $ npm install
   

4. 执行本地服务器 执行成功后 就可以通过 http://localhost:4000 在本地访问你的博客了

    $ hexo server
    INFO  Validating config
    INFO  Start processing
    INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.
   

常用命令

这里列出常用的命令 官方文档

命令	说明
hexo init	新建一个网站
hexo new “layout” “title”	新建一篇文章。layout 布局名
hexo new “article_Name”	新建一篇名为article_Name的文章 使用默认布局
hexo new page –path about/me “About me”	创建一个 source/about/me.md 文件。title 为 “About me“ 一般用于创建一个页面
hexo clean	清除缓存命令
hexo generate	生成静态网页 简写命令 hexo g
hexo server	启动本地服务器 简写命令 hexo s
hexo deploy	部署静态网站 简写 hexo d 使用此命令需要在_config.yml中配置deploy项
–debug	在命令后面加上--debug参数 启用调试模式
hexo version	显示Hexo版本

设置新主题

官方提供了很多第三方制作的主题

• 找到你喜欢的主题 点击主题的名字 进入到GitHub仓库

• 进入博客文件夹 执行克隆命令 例如克隆next主题到themes文件夹

    $ git clone git@github.com:next-theme/hexo-theme-next.git themes/next
  

• 修改博客目录下的_config.yml文件里的theme项为next

  _config.yml

  theme: next

• 最后执行

    $ hexo clean && hexo g && hexo s
  

现在主题已经设置好了

配置Hexo

插件/功能

文章加密

• 有一些文章需要加密，来保证私密性。可以使用hexo-blog-encrypt插件,而且还提供了详细的中文文档。

---

问题

hexo d 出现 ERROR Deployer not found: git

• 执行命令 hexo d 时出现 ERROR Deployer not found: git 错误

• 解决 在命令行执行以下命令

    $ npm install --save hexo-deployer-git