个人博客攻略(二) - 开始写博客

博客已经搭建好了,我们可以开始写博客了!

在博客当中添加文章,思路是在本地写好内容,再用 Git 同步至 Github 仓库上

在本地博客中添加文章

博客根目录中有很多文件和文件夹,现在我们只关注一个文件夹 source 里面存放的就是我们的个人文件,所有的个人文件都在里面。

source 文件夹下面还有一个 _posts 文件夹,这个文件夹里存放的就是我们的博客文件。我们刚建立博客之后,会有一个 Hello World 页面,他就是由这个文件夹里的 hello-world.md 文件生成的。

Markdown

.md 文件就是 Markdown 文件,我们的博客内容就写在 Markdown 文件里,再由 Hexo 生成网页文件。

Markdown 文件的编写非常的简单,知乎、简书等很多平台都支持直接使用 Markdown 编辑,在搜索引擎中搜索 Markdown 教程,对着敲两下就能学会;在Bilibili上搜 Markdown ,视频教程也不过几分钟而已。

这里的 Markdown 换行会直接解析为换行,而不是像其他的 Markdown 解析器一样需要多空一行才能换行。

添加博客

要添加我们自己的博客文件,只需要在 _posts 文件夹里写好 Markdown 文件。

可以在Git命令行中输入 hexo n "博客名" ,这个命令会在 _posts 生成 博客名.md 文件,文件的开头自带了一些不是 Markdown 的东西,这些东西叫做 Front-matter 可以指定网页的标题之类的。

当然也可以直接在 _posts 文件夹手动新建一个 .md 文件,同样可以作为博客文件

插入图片

_config.yml 开启资源文件夹:

post_asset_folder: true

这样,在 _posts 目录下会生成一个与文章同名的文件夹。把需要插入到文章中的图片放到该文件夹中,并在写文章时通过如下标签引用即可。

{% asset_img <图片名> [图片标题] %}

Front-matter

Front-matter 是在博客 Markdown 文件的开头,以 --- 来划分的部分,用 YAML 来编写,YAML 是用来写配置文件的语言,不用专门去学,照着样子自己写就可以了,就像下面这样:

1
2
3
4
5
6
7
8
9
10
---
title: 这是标题
date: 2022-07-14 21:18:17
tags:
- markdown
- blog
categories:
- tutorial
- markdown
---

顾名思义,title是标题,date是日期,tag是标签,categories是分类

不需要的部分就不写

分类具有层级结构,像文件夹一样可以有包含关系;而标签没有,是扁平化的结构

将写好的 Markdown 文件生成博客并发表到 Github

写完博客内容的 Markdown 文件后,更新到 Github

进入 Git 命令行,然后输入命令:

hexo cl 用于清除缓存文件(db.json)和已生成的静态文件(public)

hexo g 生成网页文件

hexo d 同步至Github (也可以使用hexo s 先在本地运行查看效果)

_config.yml 配置文件

博客根目录的 _config.yml 配置文件 可以配置一些博客的信息

title: 的博客 整个博客的名字

author: RC 作者名字

language: zh-CN 语言设置

首页仅显示文章摘录而不是全文

现在我们博客的首页文章是全文展开的,这非常不利于我们阅读,我们希望的是像大多数论坛一样的,只显示一部分内容,点击文章再查看全文的。

网上可以查询到在 NexT 主题中可以使用 auto_excerpt 来实现,但是在NexT新版本中以及取消了,有些网站还是没更新这一说明

我们可以使用插件:hexo-excerpt

安装 hexo-excerpt ,Git命令行中输入命令安装即可:

$ npm install hexo-excerpt --save

在博客根目录配置文件中可以设置显示内容的多少:

1
2
excerpt:
depth: 10