零基础玩转 Hexo ：本地化部署

有一些东西，用过不久就遗忘了，等在使用的时候，再各种去翻资料，再加上国内的搜索环境，所以要留下有点脚印。

认识 Hexo

Hexo 使用 node.js 编写，生成静态网页的速度也很迅速。

支持 Markdown 渲染，部署方便，可以一条指令部署到 Github pages 等平台。

插件丰富+中文文档，也降低入门的门槛。

必备技能

• node.js 基础知识
• Git 基础知识
• Markdown 基本知识
• 网页前端、css、JavaScript 等知识
• npm install 和 uninstall
• ……

看到这里，你不要被吓到关闭页面。除了 Markdown，其他都可以不用熟练掌握，有空也可以学习一下（Markdown 是必备技能，文章的排版插图都需要，但是还是要好好复习一下）。

安装 Hexo

在安装之前，你需要安装以下两个软件：

• Git
• nodejs

如果已经安装好以上工具，可以直接跳过，往下看。

安装 Git

• Windows：下载并安装 git。
• Mac：使用 Homebrew, MacPorts 或者下载 安装程序。
• Linux (Ubuntu, Debian)：sudo apt-get install git-core
• Linux (Fedora, Red Hat, CentOS)：sudo yum install git-core
• Linux (Arch 系列)： sudo pacman -S git

Mac 用户如果在编译时可能会遇到问题，请先到 App Store 安装 Xcode，Xcode 完成后，启动并进入 Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。

Windows 用户对于中国大陆地区用户，可以前往 淘宝 Git for Windows 镜像 下载 git 安装包。

安装 Node.js

Node.js 为大多数平台提供了官方的 安装程序。对于中国大陆地区用户，可以前往 淘宝 Node.js 镜像 下载。

其它的安装方法：

• Windows：通过 nvs（推荐）或者 nvm 安装。
• Mac：使用 Homebrew 或 MacPorts 安装。
• Linux（DEB/RPM-based）：从 NodeSource 安装。
• 其它：使用相应的软件包管理器进行安装，可以参考由 Node.js 提供的 指导。

切换 npm 为淘宝 npm 镜像

国内的网络环境不是很好，访问外网的速度不是理想的时候，可以进行切换，提高下载速度。

在 Git bash命令行进行切换，如果遇到权限问题，请使用管理员身份运行。

# 全局替换命令
npm config set registry http://registry.npm.taobao.org/

# 查看版本
npm get registry

# 切换官方命令
npm config set registry http://www.npmjs.org

安装 Hexo 程序

在 Git bash Here 命令行

输入官方安装命令

npm install hexo-cli -g

看看安装版本

hexo v

创建 hexo 目录

这个目录是存放主题、运行文件、写的博文、生成的静态网站文件等等都在这里完成。

在指定的文件夹，选择 Git Bash Here 输入指令

# 建立你的网站根目录，名字自己修改一下
mkdir <blog_name>

然后往这个文件夹里面，初始化 hexo。

hexo init <blog_name>

安装主题

默认的主题应该没有什么人使用吧？换一个赏心悦目一下！

这里使用安知鱼的 hexo 主题，就是本站的主题一样，其他主题切换的方法也是差不多的。

在 Git Bash 里面输入获取主题的 GitHub 地址，并安装到 themes目录

git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu

安装主题后，要进行主题的运用，修改安装目录下 _config.yml配置文件，修改成刚刚下载主题的名称。

# 修改为主题的名称
theme: anzhiyu

安装 pug 和 stylus 渲染插件

这里是安知鱼主题的需要的应用拓展的，安装一下。

npm install hexo-renderer-pug hexo-renderer-stylus --save

配置网站信息

网站相关信息

在安装文件夹 _config.yml 这个文件里配置！更多配置可以看一下官方文档。

title:
subtitle:
description:
keywords:
author:
language:
timezone:

参数	描述
title	网站标题
subtitle	网站副标题
description	网站描述
keywords	网站关键词
author	作者名字
language	网站使用的语言
timezone	网站时区：详见时区列表

更多的文档资料请查看Hexo 官方文档

Hexo 相关命令

hexo init [name]

这个是 hexo 的初始化命令，[name]代表你要初始化的目录路径，hexo init是初始化当前文件夹

hexo new [layout]