梦开始的地方,Hexo基础搭建
在本地搭建 Hexo:
-
1
2
3
4
5
6node -v
npm -v
pnpm -v
git -v
npm install -g hexo-cli # 安装 Hexo 在一个空文件夹里运行
1
2
3
4hexo init my-blog # 初始化一个 Hexo 项目 (my-blog为项目名,自行修改)
cd my-blog
pnpm install # 安装依赖
hexo server # 启动服务在浏览器访问
http://localhost:4000看到默认页面。
创建 GitHub 仓库:
- 在 GitHub 上创建一个新的公开仓库(Public),名为
用户名.github.io,勾选Public
部署 Hexo 到 GitHub Pages:
在 Hexo 项目根目录下打开
_config.yml,找到 deploy 部分,改成:1
2
3
4
5
6
7
8
9
10
11
12
13deploy:
type: git
repo: https://github.com/用户名/仓库名.git
branch: main
# 或者多仓库改为
deploy:
type: git
message: "Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}" # 提交信息
repo:
github: https://github.com/用户名/仓库名.git,main # GitHub仓库地址
gitee: https://gitee.com/用户名/仓库名.git,main # Gitee仓库地址安装部署插件(只需要执行一次):
1
pnpm install hexo-deployer-git --save
每次写完文章后,运行:
1
2
3
4
5
6
7
8
9
10
11
12# 推送 public
hexo clean
hexo generate
hexo deploy
# 或缩写版:
hexo clean
hexo g
hexo d
# 或者一行
hexo clean && hexo g && hexo dHexo 会自动把生成的静态网页推送到你的 GitHub Pages 仓库。
打开浏览器访问
https://仓库名(Github仓库名需要为用户名.Github.io) 会看到页面
Front-matter
| 设置 | 描述 | 默认值 |
|---|---|---|
layout |
布局 | config.default_layout |
title |
标题 | 文章的文件名 |
date |
建立日期 | 文件建立日期 |
updated |
更新日期 | 文件更新日期 |
comments |
开启文章的评论功能 | true |
tags |
标签(不适用于分页) | |
categories |
分类(不适用于分页) | |
permalink |
覆盖文章的永久链接。永久链接应该以 / 或 .html 结尾 |
null |
excerpt |
纯文本的页面摘要。使用 该插件 来格式化文本 | |
disableNunjucks |
启用时禁用 Nunjucks 标签 {{ }} / {% %} 和 标签插件 的渲染功能 |
false |
lang |
设置语言以覆盖 自动检测 | 继承自 _config.yml |
published |
文章是否发布 | 对于 _posts 下的文章为 true,对于 _draft 下的文章为 false |
