Grav-YAML语法介绍

Grav是一个现代、开源、基于PHP的静态网站生成器，它使用了一种名为“YAML”的语言来定义网站的内容和结构。本文将为程序员介绍Grav-YAML语法的基本结构和常用功能。

YAML语法基础

1. 注释

使用#来进行注释。注释必须出现在行首，后面不能跟其他任何字符。

#这是一个注释

2. 键值对

使用“键:值”这样的格式来表示键值对。键和值之间以冒号分隔，并且键值对必须在同一行中。

key: value

3. 列表

使用“-”作为列表项的前缀符号，每个列表项必须独立为一行。

- list item 1
- list item 2

4. 嵌套结构

YAML支持使用缩进来表示嵌套结构，缩进必须使用空格而不能是制表符。

parent:
  child1: value1
  child2: value2

Grav-YAML常用功能

1. 静态页面元数据

可以通过在页面的开头用三个短横线指示这是一个静态页面，然后在下面定义这个页面的元数据，如标题、作者、语言等。

---
title: My Page
author: John Doe
lang: en
---

2. 插件配置

可以在YAML中定义插件的配置信息，如表单插件的收件人邮箱、文件存储路径等。

form:
  enabled: true
  template: default
  recipient:
    - myemail@example.com
  ...

3. 菜单配置

定义站点的导航菜单，并指定菜单项对应的URL地址、菜单显示名称、子菜单等信息。

menu:
  - text: Home
    url: /
  - text: About us
    url: /about-us
  - text: Services
    url: /services
    submenu:
      - text: Service A
        url: /service-a
      - text: Service B
        url: /service-b

4. 主题配置

可以在YAML中指定当前站点所使用的主题，以及主题的相关配置信息。

theme: mytheme
mytheme:
  option1: true
  option2: false
  ...

以上是Grav-YAML语法的基本结构和常用功能介绍，希望对程序员们有所帮助。