安装配置并一键部署Hexo-一个静态blog框架

• 安装 NodeJS
• 安装 Hexo
• 初始化博客项目
• 编写博文
• 预览和部署
• 配置主题 theme
• 一键部署

Hexo 是一个基于 NodeJS 的静态 blog 框架，本文用于记录在 windows 环境安装配置 Hexo 的过程。
基本构想是在个人电脑上安装 Hexo，撰写并且调试日志，然后生成静态页面，最后部署到 blog 服务器上。

安装 NodeJS

• 下载并且安装git
• 下载并且安装Node

安装 Hexo

npm install -g hexo-cli

这将会全局安装Hexo的命令行工具，使你可以在任何地方都能够使用Hexo命令。

初始化博客项目

接下来，选择一个合适的文件夹作为你的博客项目目录，并在命令行中执行以下步骤：

1. 创建一个新文件夹，例如“my-hexo-blog”。
2. 进入新创建的文件夹：cd my-hexo-blog
3. 初始化Hexo项目：hexo init

编写博文

在Hexo项目中，你可以在“source/_posts”文件夹下编写Markdown格式的博文。Hexo将会根据这些Markdown文件生成静态网页。

例如，创建一个名为“hello-world.md”的文件，并在其中编写以下内容：

---
title: Hello, World!
date: 2023-08-14
---

欢迎来到我的Hexo博客。这是我的第一篇博文！

预览和部署

你可以使用以下命令在本地预览博客：

hexo server

然后在浏览器中访问http://localhost:4000即可查看博客。

如果你想将博客部署到互联网上，可以考虑使用GitHub Pages、Netlify或Vercel等服务。这些服务提供了简单的部署流程，让你的博客可以在互联网上访问。

配置主题 theme

个人比较喜欢简洁朴素的风格，所以选择了这款主题。

git clone https://github.com/tufu9441/maupassant-hexo.git themes/maupassant
npm install hexo-renderer-sass --save
npm install hexo-renderer-jade --save

修改根目录下的_config.yml文件，将 theme 设置成“maupassant”

theme: maupassant

重启Hexo本地服务器，启用该新主题。

hexo server

一键部署

日志写完本地检查测试通过，就要上传至 blog 服务器端。这里我通过插件 hexo-deployer-rsync 将生成的静态页面同步到 blog 服务器上的对应路径。

💡 博客服务器端需开启ssh服务。

1. 安装插件hexo-deployer-rsync

npm install hexo-deployer-rsync --save

2. 再次修改_config.yml文件，增加deploy配置项。

deploy:
  type: rsync
  host: <blog server hostname or ip>
  user: <user>
  root: <root>
  port: 22
  delete: true
  args:
  verbose: true
  ignore_errors: false

注意：尽管有些属性有默认值，但是还是得全部写上，否则会出现莫名的问题。
最后通过下面命令生成静态页面并且同步至 blog 服务器。

hexo generate --deploy

之后，每次完成一篇日志只需要执行下面命令即可完成部署。

hexo generate --deploy