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