Hexo简单搭建和使用记录

第一部分：搭建

Hexo官方文档

1.安装Git

• 下载：Git

2.安装NodeJs

• 下载：NodeJs

• 修改 npm 的安装源为淘宝NPM镜像

npm config set registry https://registry.npm.taobao.org

3.安装Hexo

npm install -g hexo-cli

# 初始化文件夹（自动新建一个文件夹）
hexo init <folder>
# 进入新建的目录
cd <folder>
npm install

4.GitHub创建个人仓库

• 新建一个repository
• 命名：<你的 GitHub 用户名>.github.io

5.连接GitHub

• 打开Git Bash

git config --global user.name "GitHub账号名字"
git config --global user.email "GitHub账号邮箱"

• 创建SSH，一路回车

ssh-keygen -t rsa -C "GitHub账号邮箱"

• 查看SSH Key

cat ~/.ssh/id_rsa.pub
# 将输出的内容全部复制

• 打开GitHub，点击自己的头像，再点击Settings

• 点击SSH and GPG keys

• 点击New SSH key

输入SSH key的名字，随便取；

再输入刚才复制的SSH key；

• 点击Add SSH key完成添加

• 验证是否成功，在Git Bash下输入：

ssh -T git@github.com

6.配置Hexo一键部署到GitHub

• 必须先在 _config.yml 中修改参数，例如：

deploy:
  type: git
  repo: <仓库url> # https://github.com/用户名/用户名.github.io.git
  branch: master

• 安装 hexo-deployer-git。

npm install hexo-deployer-git --save

• 第一次提交：

hexo clean
hexo g
hexo d

• 第一次deploy时可能需要输入username和password。

第二部分：使用

1.配置

• 您可以在 _config.yml 中修改大部分的配置。

• 参考文档：配置

2.主题

• 下载自己喜欢的主题。本站使用fluid。

• 修改_config.yml里的theme为主题文件夹名称。

3.常用命令

# 新建文章
hexo new post <title>

#清除缓存文件 (db.json) 和已生成的静态文件 (public)
hexo clean
# 生成静态文件
hexo g
# 部署网站
hexo d

4.写作

• 新建文章

hexo new post "第一篇文章"

• 进入/source/_posts目录，使用编辑器打开第一篇文章.md，开始书写文章。

• Front-matter 是文件最上方以 --- 分隔的区域，用于指定个别文件的变量。举例来说：

---
title: 第一篇文章
date: 2022-02-28 13:23:07
categories:
- 日记
tags:
- 标签1
- 标签2
# fluid主题提供了文章页顶部大图和文章在首页的封面图，参数如下：
# banner_img: /img/post_banner.jpg
# index_img: /img/example.jpg
---

• 以下是预先定义的参数，您可在模板中使用这些参数值并加以利用。

参数	描述	默认值
layout	布局	config.default_layout
title	标题	文章的文件名
date	建立日期	文件建立日期
updated	更新日期	文件更新日期
comments	开启文章的评论功能	true
tags	标签（不适用于分页）
categories	分类（不适用于分页）
permalink	覆盖文章网址
excerpt	Page excerpt in plain text. Use this plugin to format the text
disableNunjucks	Disable rendering of Nunjucks tag {{ }}/{% %} and tag plugins when enabled
lang	Set the language to override auto-detection	Inherited from _config.yml