Hexo 简介

Hexo是一个快速,简单且功能强大的博客框架。如果你用 Markdown 写博客,Hexo 可以在几秒内生成带有精美主题的静态文件

前置要求

  • Node.js(版本 10.13 以上,建议使用 12.0 以上版本)
  • Git

安装 Git

  • Windows:下载并安装 git
  • Mac:使用 Homebrew 安装
  • Linux(Ubuntu,Debian):sudo apt-get install git-core
  • Linux(Fedora,Red Hat,CentOS):sudo yum install git-core

安装 Node.js

Node.js 为大多数平台提供了 官方安装程序

替代安装方法:

  • Windows:使用 nvs 安装它
  • Mac:使用 Homebrew 安装
  • Linux(基于 DEB / RPM):与 NodeSource 一起安装
  • 其他:通过相应的软件包管理器进行安装。请参阅 Node.js 提供的指南

Hexo安装

使用npm install -g hexo-cli安装Hexo,并通过hexo version进行版本查看

Hexo卸载

使用npm uninstall -g hexo-cli卸载Hexo

Hexo运行

安装后,你可以通过 hexo <command> 运行 Hexo,比如通过 hexo help 指令来获取使用帮助

Hexo Blog搭建

初始化

使用 hexo init <folder> 指令就可以在指定文件夹下建立Blog信息,生成的文件夹如下所示:

  • _config.landscape.yml:自定义的主题配置文件,此处的 landscape 是默认主题。配置其他主题可以参考这种方式
  • _config.yml:站点全局的配置文件
  • node_modules:node 模块文件夹。包含可执行文件和依赖的资源
  • package-lock.json:node_modules 文件中所有模块的版本信息,模块来源
  • package.json:Hexo 框架的基本参数信息以及它所依赖的插件
  • scaffolds:scaffolds 原意是脚手架,这里可以理解为模板文件夹。当你创建新的文章时,Hexo 会根据该文件夹下的对应文件进行初始化构建
  • source:资源文件夹。这里是你放自己资源比如博文和图片的地方。_posts 文件夹下的 Markdown 和 HTML 文件会被解析并放到 public 文件夹下。其他文件或文件夹,如果开头命名不是 _ (下划线),也都会被拷贝过去。
  • themes:主题文件夹,Hexo 会根据主题来生成静态页面

本地启动

通过hexo server即可进行本地服务启动,默认启动端口为4000,可直接通过http://localhost:4000进行预览

推送配置

  • 通过npm install hexo-deployer-git --save安装hexo-deployer-git
  • 修改或添加_config.yml配置文件,如下所示
1
2
3
deploy:
type: git
repo: git@gitee.com:xx/xx.git

常用指令

创建文章

使用以下指令hexo new "test"或者简写hexo n "test",或直接将Markdown笔记放入到/source/_posts路径下

运行服务器

输入hexo server或者hexo s命令以启动服务器,你的网站会在 http://localhost:4000 下启动,在服务器启动期间,Hexo 会监视文件变动并自动更新,无须重启服务器

生成静态文件

1
hexo generate

或者简写

1
hexo g

监视文件变动立即重新生成。该操作会阻塞命令

1
hexo g --watch

生成完毕后自动部署网站

1
hexo generate --deploy

推送部署

Hexo 提供了快速方便的一键部署功能,只需执行hexo deployhexo d命令就能将网站部署到服务器上

主题配置

/themes主题文件夹下,将待安装的主题clone后,修改配置文件 _config.yml 下的主题值为主题文件夹名称即可