【Hexo】-3.在Hexo博客上发布文章


1. 使用 hexo new创建文章

1.1 文章创建

hexo 中提供了很多命令,hexo new 可以用来创建 页面、文章、草稿。

它的语法如下:

$ hexo new [layout] <title>

创建文章时,可以使用如下命令:

$ hexo new "文章标题"

创建后的文章保存在 Hexo/source/_posts 目录下,比如执行 hexo new "第一篇Hexo博文"

创建后的文件是 markdown 格式,它默认包含部分 Front-matter

---
title: 第一篇Hexo博文
date: 2020-10-31 21:28:38
tags:
---

后续可以使用 markdown 编辑器来书写具体内容,比如 Typora

1.2 文章预览

文章写好之后,要查看在Hexo博客中的展示效果,可以使用如下命令:

$ hexo g
$ hexo s

之后可以访问 http://localhost:4000 预览文章效果,后面可将其发布到服务器

1.3 文章发布

文章写好之后,可以使用如下命令将其推送到服务器上

$ hexo g
$ hexo d

或者将两个命令合二为一

$ hexo g -d
$ hexo d -g

2. 直接创建md文件

除了使用 hexo new 命令创建md文件,也可以直接在 Hexo/source/_posts 目录下创建 md 文件;

然后手动添加 Front-matter;

后面通过 hexo clean && hexo g 命令,可以直接生成静态的页面;

Hexo 在执行 hexo g 命令时,会将其归档到 db.json 中。

3. Front-matter

3.1 参数介绍

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

---
title: Hello World
date: 2013/7/13 20:46:25
---

它可以包含如下参数:

Front-matter 选项中的所有内容均为非必填的。建议至少填写 titledate 的值

配置选项 默认值 描述
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. 如果 img 属性不填写的话,文章特色图会根据文章标题的 hashcode 的值取余,然后选取主题中对应的特色图片,从而达到让所有文章都的特色图各有特色
  2. date 的值尽量保证每篇文章是唯一的。
  3. 如果要对文章设置阅读验证密码的功能,不仅要在 Front-matter 中设置采用了 SHA256 加密的 password 的值,还需要在主题的 _config.yml 中激活了配置。
  4. 您可以在文章md文件的 front-matter 中指定 reprintPolicy 来给单个文章配置转载规则

以下为文章的 Front-matter 示例。

3.2 最简示例

---
title: typora-vue-theme主题介绍
date: 2018-09-07 09:25:00
---

3.3 最全示例

---
title: typora-vue-theme主题介绍
date: 2018-09-07 09:25:00
author: 赵奇
img: /source/images/xxx.jpg
top: true
cover: true
coverImg: /images/1.jpg
password: 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92
toc: false
mathjax: false
summary: 这是你自定义的文章摘要内容,如果这个属性有值,文章卡片摘要就显示这段文字,否则程序会自动截取文章的部分内容作为摘要
categories: Markdown
tags:
  - Typora
  - Markdown
---

4. 参考

  1. Hexo文档
  2. hexo-theme-matery文档

文章作者: Soulballad
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 Soulballad !
评论
 上一篇
【Hexo】-4.Hexo使用Matery主题及配置 【Hexo】-4.Hexo使用Matery主题及配置
1. Hexo配置在 Hexo/_config.yml 中保存了很多Hexo相关的配置,可以根据实际需要进行修改。 1.1 Site 参数 描述 title 网站标题 subtitle 网站副标题 description
2020-10-30
下一篇 
【Hexo】-2.Hexo常用命令 【Hexo】-2.Hexo常用命令
1. Hexo 命令在 Hexo 目录下打开命令行,输入 hexo 回车,可以显示 hexo 内置的所有命令 clean$ hexo clean 清除缓存文件 (db.json) 和已生成的静态文件 (public)。 config$ h
2020-10-29
  目录