Hexo 写作清单

发表于 更新于 分类于 Waline： 本文字数： 2.3k 阅读时长 ≈ 2 分钟
Hexo 写作流程的概述，包含了命令，设置等

0x01 Hexo文章管理

1.创建一个md文件

md文件也就是Markdown文件，通过以下命令来创建：

1
2
hexo new <title>
hexo new "我的第一篇文章"

2.布局（layout）

  • 创建md文件时，我们可以指定布局
1
hexo new [layout] <title>$ hexo new page "我的页面"
  • 布局有三种：post（文章）、draft（草稿）、page（页面）

在新建文件时，Hexo 会根据 scaffolds 文件夹内相对应的文件（可以理解为模板）来建立md文件：

3.草稿（draft）

draft这种布局在建立时会被保存到 source/_drafts 文件夹中，但不会显示在页面上，如果我们不想某一篇文章显示在页面上，那么就可以把它移动到_drafts文件夹中。

  • 我们可在启动服务器时加上 --draft 参数来查看草稿。
1
hexo server --draft
  • 还可以在站点配置文件中把 render_drafts 参数设为 true 来预览草稿。
  • 我们可以通过 publish 命令将草稿发布文章或者页面，它将会被移动到指定的文件夹。
1
hexo publish [layout] <title>

0x02 概述文章

方法一：写概述

在对应文章对 front-matter（文章文件最上方以 ---分割对区域，是用来指定个别文件的配置变量区域）中添加description变量，其中description变量设置的内容就会被显示在首页上门，其余的文案一律不显示。配置如下：

1
2
3
4
5
6
7
---
title: Hexo 写作清单
categories:  Hexo   //分类
tags:               //标签
- Hexo
description: 写作博客的流程   //概述
---

这一种方法是需要自己写概述，所以比较费事，于是就有了第二种方法。

方法二：文章截断显示

这种方法只需要在对应的文章里，想要展示的文章后添加以下标签就可以了

1
<!--more-->

然后首页就会显示在这个标签以上的所有内容，隐藏文章下面的所有内容。

0x03 Front-matter 预定设置

配置选项 默认值 描述
title Markdown 的文件标题 文章标题，强烈建议填写此选项
date 文件创建时的日期时间 发布时间，强烈建议填写此选项，且最好保证全局唯一
author 根 _config.yml 中的 author 文章作者
img featureImages 中的某个值 文章特征图，推荐使用图床(腾讯云、七牛云、又拍云等)来做图片的路径.如: http://xxx.com/xxx.jpg
top true 推荐文章（文章是否置顶），如果 top 值为 true，则会作为首页推荐文章
cover false v1.0.2版本新增，表示该文章是否需要加入到首页轮播封面中
coverImg 无 v1.0.2版本新增，表示该文章在首页轮播封面需要显示的图片路径，如果没有，则默认使用文章的特色图片
password 无 文章阅读密码，如果要对文章设置阅读验证密码的话，就可以设置 password 的值，该值必须是用 SHA256 加密后的密码，防止被他人识破。前提是在主题的 config.yml 中激活了 verifyPassword 选项
toc true 是否开启 TOC，可以针对某篇文章单独关闭 TOC 的功能。前提是在主题的 config.yml 中激活了 toc 选项
mathjax false 是否开启数学公式支持 ，本文章是否开启 mathjax，且需要在主题的 _config.yml 文件中也需要开启才行
summary 无 文章摘要，自定义的文章摘要内容，如果这个属性有值，文章卡片摘要就显示这段文字，否则程序会自动截取文章的部分内容作为摘要
categories 无 文章分类，本主题的分类表示宏观上大的分类，只建议一篇文章一个分类
tags 无 文章标签，一篇文章可以多个标签
keywords 文章标题 文章关键字，SEO 时需要
reprintPolicy cc_by 文章转载规则， 可以是 cc_by, cc_by_nd, cc_by_sa, cc_by_nc, cc_by_nc_nd, cc_by_nc_sa, cc0, noreprint 或 pay 中的一个

1.为文章添加分类与标签

只有文章（post布局）支持分类和标签，需要在Front-matter中设置。分类有层级关系，标签没有。

举个例子：
1）下面文章它的标签是：Hexo、博客
2）分类是： 个人博客 > Hexo博客
3）“Hexo博客” 是 “个人博客” 的子分类

1
2
3
4
5
6
categories:
- 个人博客（第一层级）
- Hexo博客（第二层级）
tags:
- Hexo
- 博客

2.为文章添加多个分类

1）下面文章属于三个分类：日常 > 生活，日常 > 随想，日记
2）其中生活、随想为日常的子分类，日常和日记为同级分类

1
2
3
4
categories:
- [日常, 生活]
- [日常, 随想]
- [日记]

0x03 部署命令

基本操作

  • 清除缓存：hexo clean
  • 生成静态文件：hexo generate可简写为 hexo g
  • 启动服务器：hexo server或者 hexo s 常用参数：-p（--port）重设端口
  • 部署：hexo deploy可简写为hexo d，用于将网站部署到服务器上。（暂时用不到，目前都是在本地，后面我们将博客托管到GitHub Pages或Gitee Pages时才会用到此命令）
    常用参数：-g（--generate），hexo d -g部署前预先生成静态文件，等同于 hexo g -d

发布文章或者修改博客后执行流程：

清除缓存>生成静态文件>启动服务器，测试没问题后再部署。

1
2
3
// 我们可以写成一条命令
hexo clean && hexo g && hexo s
hexo d