博客已经搭建好了,我们可以开始写博客了!
在博客当中添加文章,思路是在本地写好内容,再用 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 |
|
顾名思义,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 | excerpt: |