使用Hexo写博客

尽管 Hexo 支持 MarkDown,但是我们却不能像写单独的 MarkDown 文档时那样肆无忌惮。由于我们所写的文档是需要被解析为静态网页文件的,所以我们必须严格遵从 Hexo 的规范,这样才能解析出条理清晰的静态网页文件。

新建文档

假设我们的文章名为 “hello hexo markdwon”,在命令行键入以下命令即可:

$ hexo new "hello hexo markdown"

上述命令的结果是在 ./hexo/source/_posts 路径下新建了一个 hello-hexo-markdown.md 文件。

然后,我们就可以打开编辑器尽情地写作了。

文档格式

我们使用文本编辑器打开刚刚新建的 hello-hexo-markdown.md 文件,会发现其中已经存在内容:

---
title: hello hexo markdown
date: 2016-11-16 18:11:25
tags:
---

这些内容是干嘛的呢?事实上,他们就是用于设置 MarkDown 文档在被解析为静态网页文件时的相关配置,这些配置参数一般位于文件中最上方以 --- 分隔的区域。

其中,title 的值是当前文档名,也是将来在网页中显示的文章标题。

date 值是我们新建文档时的当地时区时间。

tags 值是文档的标签,我们可以随意赋值为文档贴标签。其用法如下:

---
title: hello hexo markdown
date: 2016-11-16 18:11:25
tags:
- hello
- hexo
- markdown
---

上面的配置参数为这篇文档贴上了 hellohexomardown 标签,如果站点使用的主题支持标签功能,MarkDown 文档被解析为静态网页文件后就可以看到效果。

除了以上这些,还有很多预先定义的参数 Front-mtter,我们这里选取一个常用且较为典型的配置参数 categories 讲解一下。

文章分类

categories 是用来给文章分类的,它跟 tags 不同的是其具有顺序性和层次性。

例如,我们写一篇关于 CSS3 动画的文章,我们可能会为其打标签 ”CSS3“、”动画“等,但是我们却会将其分在 CSS/CSS3 类别下,这个是有一定的相关性、顺序性和层次性。简单来说,categories 有点儿像新建文件夹对文档进行分门别类的归置。

categories 的用法同 tags 一样,只不过斗个 categories 值是分先后顺序的。

引用资源

写个博客,有时候我们会想添加个图片啦 O.O,或者其他形式的资源,等等。

这时,有两种解决办法:

  1. 使用绝对路径引用资源,在 Web 世界中就是资源的 URL

  2. 使用相对路径引用资源

文章资源文件夹

如果是使用相对路径引用资源,那么我们可以使用 Hexo 提供的资源文件夹功能。

使用文本编辑器打开站点根目录下的 _ config.yml 文件,将 post_asset_folder 值设置为 true

post_asset_folder: true

上面的操作会开启 Hexo 的文章资源文件管理功能。Hexo 将会在我们每一次通过 hexo new <title> 命令创建新文章时自动创建一个同名文件夹,于是我们便可以将文章所引用的相关资源放到这个同名文件夹下,然后通过相对路径引用。

相对路径引用的标签插件

通过常规的 markdown 语法和相对路径来引用图片和其它资源可能会导致它们在存档页或者主页上显示不正确。我们可以通过使用 Hexo 提供的标签插件来解决这个问题:

{% asset_path slug %}
{% asset_img slug [title] %}
{% asset_link slug [title] %}

比如说:当你打开文章资源文件夹功能后,你把一个 example.jpg 图片放在了你的资源文件夹中,如果通过使用相对路径的常规 markdown 语法 ![](/example.jpg) ,它将 不会 出现在首页上。(但是它会在文章中按你期待的方式工作)

!!!注意: 如果已经开启了文章的资源文件夹功能,当使用 MarkDown 语法引用相对路径下的资源时,只需 ./资源名称,不用在引用路径中添加同名文件夹目录层级。

正确的引用图片方式是使用下列的标签插件而不是 markdown :

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

通过这种方式,图片将会同时出现在文章和主页以及归档页中。

文章摘要

有的时候,主题模板配置的不够好的话,Hexo 最终生成的静态站点是不会自动生成文章摘要的。

所以,为了保险起见,我们也自己手动设置文章摘要,这样也方便避免自动生成的摘要不优雅的情况。

设置文章摘要,我们只需在想显示为摘要的内容之后添 <!-- more --> 即可。像下面这样:

---
title: hello hexo markdown
date: 2016-11-16 18:11:25
tags:
- hello
- hexo
- markdown
---
​
我是短小精悍的文章摘要(๑•̀ㅂ•́)و✧
​
<!-- more -->
​
紧接着文章摘要的正文内容

这样,<!-- more --> 之前、文档配置参数之后中的内容便会被渲染为站点中的文章摘要。

注意!文章摘要在文章详情页是正文中最前面的内容。

生成文件

清除缓存文件

为了避免不必要的错误,在生成静态文件前,强烈建议先运行以下命令:

$ hexo clean

上述命令会清除本地站点文件夹下的缓存文件(db.json)和已有的静态文件(public)。

生成静态文件

写好 MarkDown 文档之后,我们就可使用以下命令生成静态文件:

$ hexo generate

然后我们就可以启动 Hexo 服务器,使用浏览器打开 http://localhost:4000 查看效果了。

示范

下图是一篇经过配置的简单文档,生成静态文件后在网站首页显示的结果。我们可以看到手动设置的摘要,以及打的标签生效了。

img

文章来源: lfkid.github.io, 作者:lfkid,版权归原作者所有,如需转载,请联系作者。

源文链接: https://lfkid.github.io/2016/11/16/Hexo%E6%95%99%E7%A8%8B%EF%BC%9A%EF%BC%88%E4%B8%89%EF%BC%89%E4%BD%BF%E7%94%A8Hexo%E5%86%99%E5%8D%9A%E5%AE%A2/

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/562530.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

mysql过滤效率和java过滤效率_如何合理选择初中高效过滤器的效率?

利菲尔特环保科技点击蓝字 关注我们 各种型号的空气过滤器有不同的标准和使用效率&#xff0c;今天利菲尔特为您介绍各种类型的空气过滤器在不同地方的应用。一般情况下&#xff0c;最末一级过滤器决定空气净化的程度&#xff0c;上游的各级过滤器只起保护作用&…

宝塔面板搭建autoPicCdn:一款基于jsdelivr-Github的免费CDN图床

autoPicCdn是白嫖Github的存储空间&#xff0c;通过jsdelivr全球加速(含有国内节点)。实现图床加速的目的。加速效果非常不错&#xff0c;用站长工具检测&#xff0c;也是一片绿油油&#xff0c;所以用来存储一些静态文件是最合适不过了。 相关文章&#xff1a;GithubjsDelivrP…

物流设计大赛优秀作品_中国外运杯第七届全国大学生物流设计大赛案例专家评审会在京召开...

2020年9月10日&#xff0c;“中国外运杯”第七届全国大学生物流设计大赛案例专家评审会在京召开。中国物流与采购联合会副会长任豪祥、中国物流与采购联合会原副会长、中国物流与采购联合会专家委员会主任戴定一、中国外运股份有限公司首席数字官高翔等有关领导及来自行业企业、…

WordPress博客网站搬家和换域名方法

WordPress博客网站搬家和换域名方法方案一 开设个人博客的朋友使用WordPress不在少数&#xff0c;那么也难免不了更换空间和域名的情况&#xff0c;由于笔者亲历了一次更换空间和域名的情况&#xff0c;将博客从AAA.com 更改为 BBB.com&#xff0c;所以本文就分享一下更换域名…

Hexo部署出现错误err-Error-Spawn-failed解决方式

Hexo部署出现错误err: Error: Spawn failed解决方式部署过程中可能会出现错误 fatal: unable to access https://github.com/a956551943/a956551943.github.io/: Encountered end of file FATAL {err: Error: Spawn failedat ChildProcess.<anonymous> (/usr/local/src/h…

python输出国际象棋棋盘_python输出国际象棋棋盘的实例分享

国际象棋是当今国际上最流行的智力体育运动项目。青年人下棋可以锻炼思维、增强记忆力和培养坚强的意志&#xff1b;中年人下棋可以享受美学&#xff1b;老年下棋可以很好的休息娱乐。国际象棋游戏有自己的规则&#xff0c;需要两个人将棋子落在棋盘上。棋子落在棋盘上事件&…

细思极恐---十年生死两茫茫,通信人,意欲亡。

每一位通信人&#xff0c;都可能面对过来自亲友的“灵魂三问”。 “通信究竟是什么&#xff1f;” “通信从哪里来&#xff1f;” “通信要往哪里去&#xff1f;” 讲真的&#xff0c;我不知道。。。。本篇博文是模仿codesheep羊哥写的&#xff0c;因为我们都学的通信&#x…

python矩阵运算dot_numpy中的dot矩阵乘法

本来以为这辈子都和数学没啥关系了&#xff0c;结果遇到了np.dot()。numpy中的“*”和“dot”运算是完全不同的&#xff0c;前者是直接计算&#xff0c;后者是矩阵相乘。(venv) [rootlocalhost tf]# pythonPython 3.4.5 (default, May 29 2017, 15:17:55)[GCC 4.8.5 20150623 (…

归并排序--Java

归并排序&#xff1a; 排序原理&#xff1a; 1、尽可能的一组数据拆分成两个元素相等的子组&#xff0c;并对每一个子组继续拆分&#xff0c;知道拆分后的每个子组的元素个数是1为止。 2、将相邻的两个子组进行合并成一个有序的大组 3、不断重复步骤2&#xff0c;直到最终只…

9008刷机模式写入超时刷机帮_刷机时没有成功,然后变成黑砖,usb接口直接变成未知设备~希望大神救助!...

线刷宝用户协议本协议是用户 (自然人、法人或社会团体)与杭州登先网络科技有限公司(以下简称"登先网络")之间关于"线刷宝"软件产品(以下简称"本软件产品")的法律协议。一旦安装、复制或以其他方式使用本软件产品&#xff0c;即表示同意接受协议各…

希尔排序--Java

希尔排序 排序原理&#xff1a; 1、选定一个增量h&#xff0c;按照增长量h作为数据分组的依据&#xff0c;对数据进行分组 2、对分好组的每一组数据完成插入排序 3、减小增长量&#xff0c;最小减为1&#xff0c;重复第二步操作 其中&#xff0c;希尔排序确定增长量h的规则…

插入排序--Java

插入排序&#xff1a; 原理&#xff1a; 1、把所有的元素分为两组&#xff0c;已经排序的和未排序的 2、找到未排序的组中的第一个元素&#xff0c;向已经排序的组中进行插入 3、倒叙遍历已经排序的元素&#xff0c;依次和待插叙的元素进行比较&#xff0c;直到找到一个元素…

redis 缓存预热_Redis:缓存雪崩、缓存穿透、缓存预热、缓存更新、缓存降级

一、缓存雪崩缓存雪崩我们可以简单的理解为&#xff1a;由于原有缓存失效&#xff0c;新缓存未到期间(例如&#xff1a;我们设置缓存时采用了相同的过期时间&#xff0c;在同一时刻出现大面积的缓存过期)&#xff0c;所有原本应该访问缓存的请求都去查询数据库了&#xff0c;而…

用接口写冒泡排序

用接口写冒泡排序&#xff1a; package demo02.maopaoapi.Bubble; public class Bubble {/***对数组a中的元素进行排序*/public static void sort(Comparable[] a){for (int i a.length-1; i >0; i--) {for (int j 0; j < i; j) {//比较索引j和索引j1处的值if (greate…

vue 根据swagger 生成接口_采用vue编写的功能强大的swagger-ui页面

think-swagger-ui-vueleswagger-ui有非常多的版本&#xff0c;觉得不太好用&#xff0c;用postman&#xff0c;每个接口都要自己进行录入。所以在基于think-vuele进行了swagger格式json的解析&#xff0c;自己实现了一套swaggerui界面。swagger分为后端数据提供方方和前端页面展…

选择排序--Java

选择排序&#xff1a;合适的元素放在合适的位置 1、每一次遍历的过程中&#xff0c;都假定第一个索引处的元素是最小值&#xff0c;和其他索引处的值依次进行比较&#xff0c;如果当前索引处的值大于其他某个索引处的值&#xff0c;则假定其他某个索引处的只为最小值&#xff…

python re正则查找_python正则表达式 - re

1&#xff0c;匹配符号基本元字符. : 任意字符&#xff0c;除了\n&#xff0c;flags设置为DOTALL(S)可以让.匹配\n|&#xff1a;逻辑或\&#xff1a;转义()&#xff1a;捕获组空白字符[\b] : 回退\f : 换页\n : 换行\r : 回车\t : 制表tab\v : 垂直制表特定字符\d : 数字&#…

Comparable接口的使用:(知识回顾)

Comparable接口的使用&#xff1a;&#xff08;知识回顾&#xff09; 1、定义一个学生类&#xff0c;具有年龄age和姓名username两个属性&#xff0c;并通过Comparable接口提供比较规则。 package demo02.sort; public class Student implements Comparable<Student>{p…

maven没有resource文件夹_maven项目中没有resource文件夹的问题

之前使用eclipse创建maven项目,文件夹都是建好的,这几次创建,都没有resource文件夹,需要手动创建resource.现象描述在eclipse中,创建maven项目有两种方式:一种是勾选Create a simple project(skip archetype selection)然后直接输入Group Id ,Artifact Id 如下图.就能创建一个m…

binary search(二分法)

binary search&#xff08;二分法&#xff09;&#xff1a; 代码&#xff1a; import java.util.Arrays;/*** 二分法查找元素*/ public class BinarySearch {public static void main(String[] args) {int[] arr {30,20,50,10,80,9,7,12,100,40,8};int searchWord 20;//要查…