Hexo博客新建文章并发布

Hexo博客新建文章并发布

创建新文章

根目录命令行输入hexo new <模板> <文章名>新建文章

其中<模板>scaffolds中,默认情况下有三个模板postdraftpage

参数 功能 路径
post 新建文章 /source/_posts/
draft 新建草稿 /source/_drafts/
page 新建页面(标签页,分类页等) /source/

通常情况下使用hexo new post <title>即可,注意这里的title不是文章名,具体文章中显示的文章标题可以在文章文件中修改,例如:我这里新建一篇文章,title为article

命令行输入hexo new post article

此时在source/_posts/文件夹中多了一个article.md文件。打开可以看到如下内容:

[图片上传失败…(image-3f21de-1544088714291)]

文章内容中两条---之间的内容为文章的配置内容,可以在其中设置标签、分类等。其中的title为文章发布后文章页面显示的标题,例如我们修改一下tittle为:Hexo博客文章发布

.md文件的名字,也就是我们新建文章时输入的名字,是作为文章页面链接中显示的名字,例如,本篇文章的文件名为:article.md,文章内设置的文章标题为Hexo博客新建文章并发布,那么本篇文章的链接就是https://www.lixint.me/article.html

文章模板

在新建文章中使用的post参数,就是模板的名称,在使用hexo new post <文件名>命令进行新建文章时,系统会自动在scaffolds文件夹中搜寻名为post的文件,根据其中的内容生成新的.md文章文件。后续随着配置项的增多,可以自行设置不同类型的模板。例如本篇文章的模板如下:

[图片上传失败…(image-55e677-1544088714292)]

其中的titledata会在生成文件时自动填写。利用此模板生成的文章文件,只需要进行对应项目的填写即可。例如本篇文章的配置信息如下:

[图片上传失败…(image-5cf46e-1544088714292)]

给文章添加分类和模板

通过对文件头部配置信息中tagscategories项的修改可以设置文章的标签及分类。

其中标签可以按格式贴现设置多个:

1
2
3
4
5
6
title: Hexo博客新建文章并发布
date: 2018-12-06 12:16:12
tags:
- Hexo
- Markdown
categories: 搭建博客

在博文中添加图片

目前有三种方法像博文中添加图片:

方法一

命令行输入npm install hexo-asset-image --save安装插件

根目录/source目录下新建一个img文件夹,将需要插入的图片放到里面

在文章中引用图片时图片使用格式[图片上传失败...(image-3a4109-1544088714292)]进行引用图片。

方法二

博客配置文件中搜索post_asset_folder项,设置为true

[图片上传失败…(image-1a1aa7-1544088714292)]

这样在创建文章时会自动在文章.md所在目录/source/_posts文件夹内生成一个与文章同名的文件夹。例如新建文章hexo new post example则会生成一个example.md文件与一个名为example的文件夹。

把example这个博文需要展示的图片放在example文件夹目录下;

文章内使用[% asset_img slug [title] %](将方括号][替换为花括号}{)的格式进行插入图片,例如我要插入一个名为1.jpg的图片,写文章时就应该填写

1
`[% asset_img 1.jpg 图片1 %]`
方法三

前两种方法尽管在上传时很方便,但是在插入图片时并不是很方便,现在很多Markdown编辑器在插入图片是非常方便,截图直接粘贴、现有的图片文件直接拖入都可以实现插入图片,而不是使用代码进行插入。

但是这样插入的图片在上传时并不会被上传,这样就导致了博客中文章图片的连接还是本地路径的格式。

于是博主自己写了一个Python脚本,在文章完成后上传前,通过脚本自动将文章中的图片上传至腾讯云对象存储(腾讯云每个月都有一定的免费额度)或者SMMS图床,文章中图片链接替换。这样既不会占用Github Pages空间,又能方便地插入图片。
对于脚本的使用,可以到==>Hexo博文图片自动上传腾讯云、SMMS图床并替换博文内图片链接<==查看

Hexo博客发表文章、草稿、添加分类和标签

写在前面

本文主要写了hexo的配置,关于博客标题这些配置HEXO已经有了很详细的介绍了,这里不再赘述,本文主要记录一些我个人认为小白比较容易有疑问的地方,也就是博客的主要功能,发表文章、添加文章分类和标签。文章可能还有很多不足,请大家谅解,欢迎大佬提意见。
hexo官方中文文档 https://hexo.io/zh-cn/docs/
发文一方面是记录,另一方面是探讨,对于hexo本人并没有深入的去研究。

本文使用到的东西
Hexo
win10电脑

1.新建文章

1.新建文章很简单,一条命令即可。命令如下,执行命令成功会返回一个路径,就是文章的所在路径,删除文章也只要删除对应的文章文件即可。

hexo new 文章文件名

Hexo博客发表文章、草稿、添加分类和标签_分类和标签

2.新建草稿命令如下,草稿不会在博客上显示。在执行时加上 –draft 参数,或是把草稿中render_drafts参数设为true来预览草稿。

hexo new draft 草稿文件名

3.新建导航选项页界面,这里以描述如何写文章为主,想了解怎么添加顶部导航选项页界面的请看我另一篇文章,《hexo博客添加标签、分类、归档、关于等页面》

hexo new page 导航选项页文件名

4.新建文章只需要以上一条命令即可,你可以直接跳到2.发布草稿。如果想稍微深入一点点了解文章布局,就接着往下看1.1,其实我了解的并不多,只是给想了解布局原理的小白一个方向。

1.1阅读官方文档

1.首先我们先阅读一下官方文档,hexo官方文档有简体中文模式,简直是我这种英语白痴的福音,废话不多说,开始正文。关于新建文章的官方文档如下图

img

官方文档中提供的新建文章的命令如下

$ hexo new [layout] <title>

其中[layout]为文章布局,而布局这种东西官方文档并没有告诉我们三种布局的不同之处,只说默认是“post”,三种布局存在于不同的路径下。还有刚刚我们说了draft布局表示发布草稿,我们对文章布局的了解到此为止。

1.2初步了解布局

第一点,布局是以主题为单位的,一套主题就有一套布局,这个不难理解,不同的主题布局肯定是不一样的。
在hexo默认主题中,存在post(文章详情页)、page(导航标签页)、archive(归档页)、index(首页)、category(类别页)以及tag(标签页)这几种布局和一个总的layout布局。
每个主题的布局文件在主题的layout文件夹下,不同主题后缀可能不同,有的是pug。

Hexo博客发表文章、草稿、添加分类和标签_Hexo_03

至于主题的代码我这里就不再深入赘述了,就是描述如何构建html模块的文件。

2.发布草稿

草稿是不会显示到博客上面的,有两张方法发布草稿为正式文章,
1、通过命令

hexo publish 文章文件名

可以将草稿发布为正式文章。
2.通过移动
手动将“_drafts”目录下的草稿移动到“_posts”目录下即可发布草稿为正式文章。

3.添加分类和标签

文章分类和标签在文章中添加,文章的参数列表如下:

参数 描述 默认值
layout 布局
title 标题 文章的文件名
date 建立日期 文件建立日期
updated 更新日期 文件更新日期
comments 开启文章的评论功能 true
tags 标签(不适用于分页)
categories 分类(不适用于分页)
permalink 覆盖文章网址
keywords 仅用于 meta 标签和 Open Graph 的关键词(不推荐使用)

在开头的“—”之间的内容为文章的参数,后面的才是文章正文。分类和标签在文章的参数,所以标签和分类是在文章中产生的,无法建立一个不属于任何文章的分类和标签。

Hexo博客发表文章、草稿、添加分类和标签_个人博客_04

3.1添加分类

参数“categories”表示分类,一篇文章只能属于一个分类,如果添加了多个分类,则下一个分类为子分类。
添加分类的格式如下:

categories:

  • 分类

  • 子分类

  • 子子分类

    Hexo博客发表文章、草稿、添加分类和标签_Hexo_05

3.2添加标签

参数“tags”表示标签,一篇文章可以有多个标签。
添加标签的格式如下:

tags:

  • 标签1

  • 标签2

    Hexo博客发表文章、草稿、添加分类和标签_个人博客_06

4.通过hexo-admin管理文章

这是一个可视化写作文章的插件,同时也可以进行图片上传,但是使用上可能会出现一些问题,所以在这里不详细介绍,具体内容可以见我另外两篇文章:

hexo博客使用hexo-admin插件管理文章

hexo-admin插件windows系统插入图片失败问题解决,hexo-admin汉化,通过修改源码完美解决,以及插件的一点点优化

5.总结

关于hexo发表文章就描述到这里,hexo的文章是markdown格式的,徒手写作文章比较困难,建议找一个markdown编辑器,在编辑器写完再复制到文章的md文件里。有不清楚的地方欢迎评论留言,看到的我都会回复的。本文到此结束,有什么不足的地方请大家不吝指正。

©著作权归作者所有:来自51CTO博客作者玖涯博客的原创作品,请联系作者获取转载授权,否则将追究法律责任
Hexo博客发表文章、草稿、添加分类和标签
https://blog.51cto.com/u_15477117/4919709


Hexo博客新建文章并发布
http://aiyoja.github.io/Hexo/
作者
弶森
发布于
2022年6月23日
许可协议