如何有一个hexo博客

此文章使用 windows 系统介绍。

你需要：

• Git
• Nodejs(建议使用12.0及以上版本，推荐12.22.12版本)
• 没了

如何安装

Nodejs

打开这个链接，点击 node-v12.22.12-x64.msi 就可以下载 Nodejs 了。

Git

打开这个链接，点击右侧电脑，就可以下载 Git 了。

安装hexo

打开 Git Bash，输入

npm install hexo

就可以安装 hexo。

建站

安装 hexo 后，新建一个文件夹用于建站，进入文件夹，右键并点击 Git Bash Here，输入

hexo init
npm install

hexo 就会在这个文件夹里新建需要的文件。

新建完成后，指定文件夹的目录如下：

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├───drafts
|   └───posts
└── themes

_config.yml

网站的配置信息，在本教程中这个会用到。

package.json

应用程序的信息。EJS，Stylus 和 Markdown 渲染引擎已默认安装，您可以自由移除。

package.json
{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "hexo": {
    "version": ""
  },
  "dependencies": {
    "hexo": "^3.8.0",
    "hexo-generator-archive": "^0.1.5",
    "hexo-generator-category": "^0.1.3",
    "hexo-generator-index": "^0.2.1",
    "hexo-generator-tag": "^0.2.0",
    "hexo-renderer-ejs": "^0.3.1",
    "hexo-renderer-stylus": "^0.3.3",
    "hexo-renderer-marked": "^0.3.2",
    "hexo-server": "^0.3.3"
  }
}

在本教程中这个屁用没有。

scaffolds

模版文件夹。当您新建文章时，Hexo 会根据 scaffold 来创建文件。

Hexo 的模板是指在新建的文章文件中默认填充的内容。例如，如果您修改 scaffold/post.md 中的 Front-matter 内容，那么每次新建一篇文章时都会包含这个修改。

在本教程中这个屁用没有。

source

资源文件夹是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。

themes

主题文件夹。Hexo 会根据主题来生成静态页面。

访问

你可以输入以下命令来访问你的博客。

hexo g
hexo s

然后打开网址为 http://localhost:4000/ 的网站来访问，Git Bash 输入 Ctrl + C 关闭。

配置

打开 _config.yml，有这些主要东西：

参数	描述
titie	网站标题
subtitle	网站副标题
description	网站描述
keywords	网站的关键词。支持多个关键词
author	你的名字
language	网站使用的语言，本教程需要改成 zh-CN
timezone	网站时区。本教程需要改成 Asia/Shanghai

其中，description 主要用于 SEO，告诉搜索引擎一个关于您站点的简单描述，通常建议在其中包含您网站的关键词。author 参数用于主题显示文章的作者。

迁移

创建仓库

打开 Github->Settings->Repositories，更改 main 为 master，点击 Update。

新建一个仓库，名为 你的用户名.github.io。

生成 SSH

打开 git bash，输入

git config --global user.name "你的Github用户名"
git config --global user.email "你的Github注册用的邮箱"

然后输入

ssh-keygen -t rsa -C "你的Github注册用的邮箱"

一直回车（注意有一个地方需要输入 y），找到 .ssh 文件夹，用 txt 打开 id_rsa.pub，复制里面的东西，然后回到 Github->Settings->SSH and GPG keys，新建一个 SSH，名字随便，把复制的内容粘贴进去。

Git Bash 输入

ssh -T git@github.com

查看是否成功。

部署到Github

打开 _config.yml，把最后几行改成这样子：

deploy:
  type: git
  repo: [email protected]:GitHub用户名/Github用户名.github.io.git
  branch: master

之后保存，Git Bash 输入

hexo clean
hexo g
hexo d

（注：以后一旦博客有改动都用这个命令更新）

部署到 Github，等待一会，就可以用 Github用户名.github.io 这个网址访问你的博客了，如 zhuangjihong.github.io.

主题

hexo 默认的主题不好看，所以我们可以换一个，我用的是 fluid。

安装

把 _config.yml 中 theme 后的 landscape 改成 fluid。

下载fluid最新版本，解压到 themes 目录，并将解压出的文件夹重命名为 fluid。进入 fluid 文件夹，打开这个文件夹中的 _config.yml 文件，复制里面的内容，再在你用于部署博客的文件夹（也就是有 source 文件夹的文件夹）里新建一个 _config.fluid.yml 文件，打开，粘贴复制的内容，可以自定义一些比如说标题、背景图等参数，详见fluid配置指南。保存后运行前面提到过用于更新的命令，就可以看到效果了。

写文章

用 Git Bash 输入 hexo new "文章题目" 即可在 source -> _post 文件夹里看到创建的文章，选择一个编辑器如 VScode 来编辑文章。

文章是 .md 类型的，也就是要用 Markdown 来编辑，关于 Markdown 的使用详见 Markdown教程。

在文章的前 5 行可以看到这些东西：

---
title: 文章题目
date: xxxx-xx-xx xx:xx:xx
tags:
---

其中 date 是文章创建的日期，tags 是文章的标签，除此之外，你还可以添加 categories: 即文章的分类，注意冒号后有空格。

写好文章后仍然使用用于更新的命令上传文章。