YAML 语法简介

最后更新于:2020 九月 21日 , 星期一 , 00:02 凌晨

使用 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
键: 

#基本规则

  1. 大小写敏感
  2. 使用缩进表示层级关系
  3. 禁止使用 tab 缩进,只能使用空格键
  4. 缩进长度没有限制,只要元素对齐就表示这些元素属于一个层级
  5. 使用 # 表示注释
  6. 字符串可以不用引号标注(但是建议你最好还是加上引号)

例如:

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 ;
观察缩进情况,可以发现 cdndefault 是同一级的,模板里一般表示为 config.hexo-tag-dplayer.cdnconfig.hexo-tag-dplayer.default
同理, default 下的三个选项又是一级,以此类推,只要记住缩进表示层级关系就可以了。

原文:


本站所有文章除特别声明外,均采用 CC BY-SA-NC 4.0 协议 。转载请注明原作者及出处!

 目录

既见君子 云胡不喜