使用方法

入门

1、安装hexo -cli

使用npm或yarn安装hexo的脚手架工具hexo-cli

npm install -g hexo-cli

2、初始化项目

安装完成后，使用hexo命令初始化项目，后面为文件名

hexo init myBlog

3、安装依赖

进入项目目录，安装依赖

cd myBlog
npm install

4、启动项目

hexo server

简写

hexo s

5、访问项目

在浏览器中输入http://localhost:4000/即可访问项目

项目结构

1、_config.yml

项目的配置文件，可以在这里配置项目的信息，例如标题、描述、作者、语言、主题等等

网站配置

• title：网站标题
• subtitle：副标题
• description：描述
• keywords：关键字
• author：作者
• language：语言
• timezone：时区

  title: Hexo
  subtitle: ''
  description: ''
  keywords:
  author: John Doe
  language: en
  timezone: ''

  可以修改成自己的

  title: Hexo
  subtitle: '主页'
  description: ''
  keywords:
  author: XieHongchen
  language: zh-CN
  timezone: 'Asia/Shanghai'

网址配置

url是博客上线后的网址，会在分享等地方用到，一定要修改

url:http://example.com

可以修改成自己的，GitHub的地址

url: https://xiehongchen.github.io

2、scaffolds

• draft.md
• FASTPANEL
• post.md
  模板文件夹，里面存放了3个模板文件，依次为草稿模板，页面模板和文字模板
  当我们使用hex名称生成草稿、页面或文字的时候，就是赋值这些模板

我们以文章模板为例进行说明。默认post.md内容为空，头部信息如下：

---
title: {{ title }}
date: {{ date }}
tags:
---

如果我们想所有新生成的文章都带上分类字段。我们可以修改post.md的头部。我们给头部添加了categories字段。

---
title: {{ title }}
date: {{ date }}
tags:
categories: 
---

这样我们使用 hexo new a 生成a.md文章的时候，a.md文章顶部都会带上categories字段。

---
title: a
date: 2022-04-01 16:57:55
tags:
categories:
---

3、source

资源文件夹是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。
我们使用 hexo new …… 命令生成的页面或者文章，都会被放倒source文件夹下。

4、themes

themes文件夹存放的就是hexo的主题。

5、Front-matter

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

---
title: 旋转中的时差效果
date: 2023-04-28 21:09:11
tags: [js,前端,css]
---

• layout：布局
• title：标题
• date：建立时间
• updated：更新时间
• comment：开启文章的评论功能
• tags：标签（不适用于分页）
• categories：分类（不适用于分页）
• permalink：覆盖文章网址
• sticky：置顶，普通为1

其中，分类和标签需要区别一下，分类具有顺序性和层次性，也就是说 Foo, Bar 不等于 Bar, Foo；而标签没有顺序和层次。

categories:
- Diary
tags:
- PS3
- Games

具体使用

hexo new [layout] <title>

文章

hexo new text

页面

hexo new page text

草稿

hexo new draft text

预览草稿

hexo server --draft

将草稿发表到post中

hexo publish draft text

常见命令

• 新建

  hexo new a

  简写

  hexo n a

• Hexo 会监视文件变动并自动更新，除修改站点配置文件外,无须重启服务器,直接刷新网页即可生效。

  hexo serve

• 以静态模式启动

  hexo serve -s

• 更改访问端口 (默认端口为4000，’ctrl + c’关闭server)

  hexo serve -p 5000

• 自定义 IP

  hexo server -i ip地址

• 清除缓存 ,网页正常情况下可以忽略此条命令,执行该指令后,会删掉站点根目录下的public文件夹

  hexo clean

• 生成静态网页 (执行 $ hexo g后会在站点根目录下生成public文件夹, hexo会将”/blog/source/“ 下面的.md后缀的文件编译为.html后缀的文件,存放在”/blog/public/ “ 路径下)

  hexo generate

  简写

  hexo g

• 初始化XX文件夹名称

  hexo init XX

• 升级

  npm update hexo -g

• 安装

  npm install hexo -g

• 查看hexo版本号

  hexo -v

• 上传

  hexo deploy

  简写

  hexo d