使用Github Pages + Hexo搭建博客(二)—— 写作
在使用Github Pages + Hexo搭建博客(一)—— 配置git、Hexo中,我介绍了如何搭建一个基于Hexo的个人博客,以及将它部署到您的github pages上的方法。相信现在您已经搭建好了您的博客,下一步就是在自己的博客上发布文章了。因此,在这篇文章中,我将向您介绍在Hexo中写作以及发布文章的过程。
Hexo新建文章
您可以使用以下命令来新建一篇文章:
1 | Hexo new [layout] <title> |
Hexo 有三种默认布局:post
、page
和 draft
,它们分别对应不同的路径,而您自定义的其他布局和 post
相同,都将储存到 source/_posts
文件夹中。
新建文章的布局若未指定,则默认为post。布局文件存放在根目录scaffolds文件夹下,可以自行修改。在新建完成后,您可以在您的source/_post文件夹中看到您新建的.md后缀文件,这就是您即将发布的文章。Hexo使用markdown语法书写文章,您可以先了解markdown语法,目前我使用的markdown编辑器是typroa,您也可以使用macdown。
注意事项:
- 文章标题有空格时需要用引号将标题括起来
- 小标题中#与内容之间要有空格,否则Hexo的渲染引擎无法识别小标题
Front-matter
打开新建的文件,您就能看到定义在文件最上方的Front-matter部分,以---
分割的区域中是用于指定当前文件的变量。 您的文件应当包含以下内容:
1 | --- |
以下是预先定义的参数:
参数 | 描述 | 默认值 |
---|---|---|
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 | Hexo clean |
如果您想删除某一篇文章,那么在source/_post目录下找到对应的文章将其删除后,同样执行上述命令就行了。
结语
看到此处,您应该已经成功在您的博客上发布了第一篇文章了,此时您一定想知道怎样才能让您的博客变得好看,在下一篇文章中,我将给您介绍如何在您的博客中使用、配置Next主题。