YAML 语法简介
本文最后更新于:3 个月前
使用 Hexo 并不需要掌握过多的 YAML 语法知识,只需要简单的了解一下就可以。
#Markdown 文件内使用 YAML
在 Hexo 中写文档,通常需要在头部写一些关于文章的信息,这些都是需要使用 YAML 语言来写的,例如
---
title: 录制视频时显示按键
date: 2018-10-28 22:54:43
tags: [软件, 随便水水]
keywords: KeyCastOW 录屏技巧 按键显示
comments: true
---
提醒
此部分一般叫做 Front-matter
。
文章内部的 YAML 配置都是以 ---
开始和结束的,而且,结束之后通常还要再有一行的空行,用以区分 Markdown 语法。
#_config.yml 中使用 YAML
这个就太常见了,Hexo 的配置文件和主题的配置文件都需要使用 YAML 语言来写。
#基本语法
YAML 使用键值对的形式记录信息,标准格式是
key: value
键: 值
#基本规则
- 大小写敏感
- 使用缩进表示层级关系
- 禁止使用 tab 缩进,只能使用空格键
- 缩进长度没有限制,只要元素对齐就表示这些元素属于一个层级
- 使用
#
表示注释 - 字符串可以不用引号标注(但是建议你最好还是加上引号)
例如:
hexo-tag-dplayer:
cdn:
- https://cdn.jsdelivr.net/npm/dplayer/dist/DPlayer.min.js
- https://cdn.jsdelivr.net/npm/dplayer/dist/DPlayer.min.css
default:
api: https://api.prprpr.me/dplayer3/
loop: yes
screenshot: yes
其中 hexo-tag-dplayer
是最高一级的,在模板里一般表示为 config.hexo-tag-dplayer
;
观察缩进情况,可以发现 cdn
和 default
是同一级的,模板里一般表示为 config.hexo-tag-dplayer.cdn
和 config.hexo-tag-dplayer.default
;
同理, default
下的三个选项又是一级,以此类推,只要记住缩进表示层级关系就可以了。
hexo-tag-dplayer:
cdn:
- https://cdn.jsdelivr.net/npm/dplayer/dist/DPlayer.min.js
- https://cdn.jsdelivr.net/npm/dplayer/dist/DPlayer.min.css
default:
api: https://api.prprpr.me/dplayer3/
loop: yes
screenshot: yes
原文:
本站所有文章除特别声明外,均采用 CC BY-SA-NC 4.0 协议 。转载请注明原作者及出处!