使用Github Pages + Hexo搭建博客(二)—— 写作

使用Github Pages + Hexo搭建博客(一)—— 配置git、Hexo中,我介绍了如何搭建一个基于Hexo的个人博客,以及将它部署到您的github pages上的方法。相信现在您已经搭建好了您的博客,下一步就是在自己的博客上发布文章了。因此,在这篇文章中,我将向您介绍在Hexo中写作以及发布文章的过程。

Hexo新建文章

您可以使用以下命令来新建一篇文章:

1
Hexo new [layout] <title>

Hexo 有三种默认布局:postpagedraft,它们分别对应不同的路径,而您自定义的其他布局和 post 相同,都将储存到 source/_posts 文件夹中。

新建文章的布局若未指定,则默认为post。布局文件存放在根目录scaffolds文件夹下,可以自行修改。在新建完成后,您可以在您的source/_post文件夹中看到您新建的.md后缀文件,这就是您即将发布的文章。Hexo使用markdown语法书写文章,您可以先了解markdown语法,目前我使用的markdown编辑器是typroa,您也可以使用macdown

注意事项:

  1. 文章标题有空格时需要用引号将标题括起来
  2. 小标题中#与内容之间要有空格,否则Hexo的渲染引擎无法识别小标题

Front-matter

打开新建的文件,您就能看到定义在文件最上方的Front-matter部分,以---分割的区域中是用于指定当前文件的变量。 您的文件应当包含以下内容:

1
2
3
4
5
6
---
title: #文章标题
date: #创建时间
tags: #文章标签
---
#这之后是正文

以下是预先定义的参数:

参数 描述 默认值
layout 布局
title 标题 文件名
date 建立日期 文件创建日期
updated 更新日期 文件更新日期
comments 是否开启文章的评论功能 true
tags 标签
categories 分类
permalink 覆盖文章网址

设置文章的分类和标签

Hexo中可以通过Front-matter中的tags和categories字段设置标签和分类。通常分类和标签定义很接近,但在Hexo中,分类具有顺序性和层次性。标签没有顺序和层次,可以通过[1,2,3,……]形式来给文章设置多个标签。

在之后的文章中,我将详细介绍在Next主题下设置文章分类和标签页面的方法。

标签插件与资源文件夹

Hexo提供了一系列的标签插件来用于在文章中快速插入特定格式内容,官方文档中有详细的介绍。

资源文件夹可以方便我们对于各个文章资源的管理,可以将站点配置文件_config.yml中的post_asset_folder设置为true打开文章资源文件夹。

1
post_asset_folder: true

资源文件管理功能打开后,每次在您新建新的文章时,Hexo都会自动创建一个与文章同名的资源管理文件夹,将与这篇文章有关的所有资源(图片、CSS、JS文件)放在此文件夹中,您就可以通过相对路径或者标签插件来引用它们。

注意:

当您想要在文章中引用资源文件夹中的图片时,如果您使用相对路径的常规markdown语法![](),它将不会出现在首页,正确的引用方式应当是使用下列标签插件引用图片:

1
{% asset_img example.jpg This is an example image %}

通过标签插件引用的方式,图片将会同时出现在文章、主页以及归档页中。

发布与删除文章

在写完您的第一篇文章后,您可以先通过Hexo s命令在本地查看文章内容。完成修改后,就可以用以下命令生成新的静态文件并将文章push到您的github上。

1
2
3
Hexo clean
Hexo g
Hexo d

如果您想删除某一篇文章,那么在source/_post目录下找到对应的文章将其删除后,同样执行上述命令就行了。

结语

看到此处,您应该已经成功在您的博客上发布了第一篇文章了,此时您一定想知道怎样才能让您的博客变得好看,在下一篇文章中,我将给您介绍如何在您的博客中使用、配置Next主题。